Для подготовки BYoPSTN необходимо выполнить следующие предварительные условия. Приведенные ниже предварительные условия предполагают, что у партнера есть рабочее развертывание Webex для Cisco BroadWorks, которое включает:

• Функционирующая система BroadWorks – как описано в руководстве по решению Webex для Cisco BroadWorks

• Лицензия BroadWorks AS с услугой VoiceXML в достаточном количестве (1 на номер PSTN)

• Требуются исправления BroadWorks:

  Для R22:

  • AP.xsp.22.0.1123.ap376935

  • AP.as.22.0.1123.ap376935

  Для R23:

  • AP.xsp.23.0.1075.ap376935

  • AP.as.23.0.1075.ap376935

  Для R24

  • AP.as.24.0.944.ap376935

• Развернутая система Cisco CUBE (версия IOS 16.12.2 или более новая версия): https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book.html

  Поддерживается как аппаратный, так и виртуальный CUBE. Аппаратный CUBE рекомендуется для масштабирования и обработки большего количества вызовов.

• Партнерская организация Webex – как описано в руководстве по решению Webex для Cisco BroadWorks

Для добавления номеров телефона системы Webex партнер Cisco использует следующую процедуру:

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Конфигурация присоединения к совещанию (BYoPSTN) выберите Создать номер телефона системы Group.

5. Введите название группы номеров телефона и нажмите Далее.

6. Введите сведения о номере телефона и нажмите Далее.

7. Просмотрите сводную информацию о группе номеров телефона и нажмите Сохранить.

8. Повторите эту процедуру для каждой добавляемой группы номеров телефона.

Приведенные ниже скриншоты иллюстрируют процедуру.

Этот этап необходимо выполнить только в том случае, если необходимо развернуть параметр присоединения к совещанию с помощью обратного вызова. В противном случае вы можете пропустить этот шаг.

Если этот параметр не настроен, пользователи могут присоединяться к совещаниям с помощью параметра звонка на номер системы или присоединяться с помощью аудио компьютера.

При использовании параметра обратного вызова совещания для маршрутизации вызовов из Webex в CUBE необходима группа SRV DNS обратного вызова. Процедура, которую партнер Cisco использует для добавления записей SRV DNS CUBE в Webex, приведена ниже.

1. Войдите в Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Конфигурация присоединения к совещанию (BYoPSTN) выберите Создать группу SRV DNS обратного вызова.

5. Введите имя группы SRV DNS обратного вызова.

6. Выберите Далее.

7. Введите сведения о SRV DNS обратного вызова.

8. Выберите Далее.

9. Просмотрите сводку сведений о SRV DNS обратного вызова.

10. Нажмите Сохранить.

11. Подготовка всех обновлений в DNS для отражения новых записей в группе SRV DNS.

12. Повторите эту процедуру для каждой добавляемой группы SRV DNS обратного вызова.

Приведенные ниже скриншоты иллюстрируют процедуру.

Для первоначальной настройки и проверки решения BYoPSTN требуется начальная организация для каждой уникальной комбинации группы номеров телефона и группы SRV DNS обратного вызова (если требуется обратный вызов). Поэтому партнерам Cisco рекомендуется аналогичным образом создать новый шаблон клиента для каждой уникальной комбинации группы номеров телефона и группы SRV DNS обратного вызова. Каждый шаблон клиента должен использоваться для создания соответствующей организации семян.

После того как конфигурация BYoPSTN будет инициализирована и проверена с помощью начальных организаций, группы номеров телефона и группы SRV DNS обратного вызова могут быть применены к существующим шаблонам клиентов при необходимости.

Обратите внимание, что недавно созданные шаблоны клиентов не используются существующими нетестируемыми клиентами и поэтому могут быть безопасно использованы для ручной проверки конфигурации BYoPSTN.

Если вы не развертываете функцию присоединения к совещанию с помощью функции обратного вызова, нет необходимости связывать группы SRV DNS обратного вызова с шаблоном клиента. Однако необходимо выбрать Отключить обратный вызов.

Чтобы добавить в новый шаблон клиента, выполните указанные ниже действия.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Шаблоны выберите Добавить шаблон.

5. Введите сведения о шаблоне. На этапе Тип пакета:

   • Выберите Тип пакета в качестве стандартного.

   • Выберите конфигурацию присоединения к совещанию в качестве номеров телефона системы, предоставленных партнером (BYoPSTN).

   • Выберите подготовленную группу номеров телефона.

   • Для группы SRV DNS обратного вызова если необходимо включить параметр обратного вызова на совещание, выберите подготовленную группу SRV DNS обратного вызова. В противном случае выберите Отключить обратный вызов.

6. Выберите Далее.

7. Введите оставшиеся сведения о шаблоне.

8. Просмотрите сводку сведений о шаблоне.

9. Щелкните Сохранить.

10. Повторите эту процедуру для каждого шаблона клиента, который необходимо добавить

Приведенный ниже снимок экрана иллюстрирует процедуру.

Чтобы обновить существующий шаблон клиента, выполните указанные ниже действия.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до раздела Вызовы BroadWorks .

4. В разделе Шаблоны выберите Просмотр шаблона.

5. Выберите шаблон, который необходимо обновить.

6. Прокрутите страницу до раздела Конфигурация присоединения к совещанию .

   • Выберите Номера телефона системы, предоставленные партнером (BYoPSTN).

   • Выберите ранее настроенную группу номеров телефона.

   • Для группы SRV DNS обратного вызова, если необходимо включить параметр обратного вызова на совещание, выберите подготовленную группу SRV DNS обратного вызова. В противном случае выберите Отключить обратный вызов.

7. Нажмите Сохранить.

   Приведенный ниже снимок экрана иллюстрирует процедуру.

Решение BYoPSTN имеет несколько различных компонентов, каждый из которых должен быть настроен правильно для успешной работы решения. Одной из двух целей организаций, использующих начальные решения, является создание номеров телефона для сопоставления кодов доступа к совещаниям и универсально уникального идентификатора веб-сайта совещаний (UUID веб-сайта), которые необходимы для непрерывной работы решения. Другой целью является проверка конфигурации.

Для каждой уникальной комбинации группы номеров телефона и группы SRV DNS обратного вызова необходимо создать соответствующий шаблон клиента ранее. Для каждого из этих шаблонов клиента должна быть подготовлена организация семенного решения. При подготовке этих начальных организаций номер телефона будет создан для сопоставления кодов доступа к совещаниям и UUID веб-сайта совещаний, которые необходимы для настройки BroadWorks.

Используя каждый из ранее настроенных шаблонов клиента, подготовьте подписчика для нового тестового поставщика услуг BroadWorks или нового предприятия BroadWorks с пользователем пакета Standard. В результате на веб-сайте совещаний стандартного пакета должен использоваться параметр присоединения к совещанию по номерам телефона системы поставщика услуг партнера. Для обеспечения абонента может быть использован один из следующих способов:

1. Подготовка тестового подписчика с помощью API подписчиков BroadWorks, как описано в developer.webex.com.

2. Включите тестового подписчика для службы обмена мгновенными сообщениями и состоянием доступности в BroadWorks, настроенном на использование шаблона клиента. Убедитесь, что шаблон клиента использует пакет Standard в качестве стандартного по умолчанию, чтобы тестовому подписчику был назначен пакет Standard. Кроме того, тестируемый подписчик должен быть впоследствии обновлен для получения пакета Standard.

Обратите внимание, что организации семенных решений рекомендуется связать с поставщиком услуг BroadWorks или с тестовым BroadWorks Enterprise.

Крайне важно, чтобы этот веб-сайт совещаний оставался подготовленным, поскольку этот UUID веб-сайта отправляется в каждом запросе на присоединение к совещанию на номер системы в качестве маркера аутентификации. Вы не должны удалять начальную организацию, поскольку связанный веб-сайт совещаний также будет удален. Если начальная организация удалена, вам потребуется подготовить новую организацию и перенастроить Broadworks с новым UUID веб-сайта.

Первичные и любые вторичные организации семян могут быть удалены при необходимости до назначения набора номеров телефона и записей SRV DNS обратного вызова клиентам, не прошедшим тестирование. Если набор номеров телефона и записи SRV DNS обратного вызова назначены любым клиентам, не прошедшим тестирование, эти номера телефона и записи обратного вызова связаны с веб-сайтами совещаний для этих клиентов и используются для присоединения к совещанию с помощью звонка на номер системы и обратного вызова. Любые изменения следует рассматривать как оказывающие влияние на услуги.

Чтобы выбрать организацию первичного семенного решения, выполните приведенные ниже действия.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до раздела Вызовы BroadWorks .

4. В разделе Проверка конфигурации (BYoPSTN) выберите Назначить.

5. На экране Назначить организацию найдите и выберите одну из предварительно настроенных начальных организаций.

6. Нажмите Назначить.

   Выбранная организация семян является основной семенной организацией.

Приведенные ниже скриншоты иллюстрируют процедуру.

Сведения об организации основного семенного решения, группах номеров телефона и группе SRV DNS обратного вызова для определенного кластера BroadWorks доступны в одном местоположении, файле конфигурации BroadWorks (BYoPSTN). Эта информация необходима для настройки BroadWorks для BYoPSTN.

Обратите внимание, что файл конфигурации JSON доступен для просмотра и скачивания только после выбора организации основного семенного решения.

Процедура просмотра и скачивания файла конфигурации JSON приведена ниже.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Кластеры выберите Просмотр кластера.

5. Выберите кластер, связанный с шаблонами клиента, настроенными для использования BYoPSTN.

6. Прокрутите страницу до раздела Конфигурация BroadWorks для BYoPSTN .

7. Щелкните Скачать файл конфигурации JSON.

8. Повторите эту процедуру для всех других кластеров BroadWorks.

Приведенные ниже скриншоты иллюстрируют процедуру.

Пример файла конфигурации JSON см. ниже. Файл содержит дополнительную информацию о каждой группе номеров телефона, группе SRV DNS обратного вызова. Следующие ключевые элементы конфигурации, которые необходимо ввести в BroadWorks, выделены жирным шрифтом.

• siteUUID: BroadWorks должна отправить это значение в сообщениях SIP. Это маркер, который используется аудио Webex Edge для подтверждения идентификации BroadWorks партнера Cisco и доступа к веб-сайтам совещаний, управляемым этим партнером Cisco.

• Сопоставление кода доступа по номеру телефона: Номера телефона и связанные с ними коды доступа Webex должны быть настроены в BroadWorks.

  • phoneNumber

  • код доступа

• localeTag: Необходимый язык объявления, связанный с номером телефона, должен быть настроен в BroadWorks.

• dnsSrv: SRV DNS обратного вызова должен быть настроен в DNS и ссылаться на нужные экземпляры CUBE.

{
   "siteUUID": "491db0821791441a96c233fefb6c6dfc",
   "siteURL": " seedtestenterpriseabc.webex.com ",
   "partnerOrgId": "1da175de-3651-4467-b26b-b0d85a2cb3ad",
   "solutionValidationOrgId": "d927ac4d-3d73-4d7f-8506-a1bc0a221934",
   "customerTemplates": [
      {
         "name": "US West Std",
         "id": "27fe1337-ab1d-44b0-8b5e-ff1d32f6e3f8",
         "phoneNumberGroupId": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "US East Std",
         "id": "070d6682-b64f-46ea-bc4b-b2e1218ba4bb",
         "phoneNumberGroupId": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      }
   ],
   "phoneNumberGroups": [
   {
         "name": "US West",
         "id": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "phonenumbers": [
            {
               "id": "617c5faa-1721-45c7-bc70-e6d7c20ccc29",
               "name": "US Palo Alto",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "9863502478",
               "accessCode": "88672693772924908359"
            },
            {
               "id": "48fa7c50-9da0-4c8b-9b2f-307ff435c7c7",
               "name": "US Toll San Francisco",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "4156551000",
               "accessCode": "88652789466280320324"
            }
         ]
      },
      {
         "name": "US East",
         "id": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "phonenumbers": [
            {
               "id": "ca0c622a-8621-4477-91e0-b3e214833568",
               "name": "US Maryland",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "2403332200",
               "accessCode": "88631321777971704941"
            },
            {
               "id": "00875574-9a46-4447-a967-350b6176755a",
               "name": "US Florida",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "SECONDARY",
               "phoneNumber": "9049002303",
               "accessCode": "88632627551145646175"
            },
            {
               "id": "a2c10316-9266-4423-a669-d67949f99d33",
               "name": "US New York",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "8056504578",
               "accessCode": "88649679020033567943"
            }
         ]
      }
   ],
   "callbackDnsSrvGroups": [
      {
         "name": "CB US",
         "callbackDnsSrvs": [
            {
               "name": "Callback US",
               "countryCode": "US",
               "dnsSrv": "cube.us.example.com",
               "id": "c5209d17-7c2f-45b3-95a6-65d7f5f53c7e"
            }
         ],
         "id": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "CB MX",
         "callbackDnsSrvs": [
            {
               "name": "Callback MX",
               "countryCode": "MX",
               "dnsSrv": "cube.mx.example.com",
               "id": "cca0e4c3-5cff-412c-a854-bfb719f603a2"
            }
         ],
         "id": "36403797-b401-50c0-cbe5-dc58260d4f003"
      }
   ]
}

Домен SRV DNS аудио Webex Edge должен быть настроен в BroadWorks. Для определения значения используйте следующую процедуру.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Клиенты.

3. Выберите предприятие проверки BYoPSTN.

4. Выберите Просмотр данных клиента.

5. Перейдите в раздел Службы/Совещания.

6. Выберите веб-сайт совещаний стандартного пакета.

7. Прокрутите вниз боковой панели и выберите Настройка веб-сайта.

8. Выберите Общие настройки / Настройки аудио.

9. В разделе Пользовательские глобальные номера телефона системы аудио Edge выберите Создать сценарий Lua.

10. Во всплывающем окне найдите значение «-- Update To header with CCAX URL».

     
    -- Update To header with CCAX URL
     local oldTo1 = msg:getHeader("To")
     local newTo1 = string.gsub(oldTo1, "<sip:(.+)@(.*)>", "<sip:%1@ecccx.amer.webex.com>")
     msg:modifyHeader("To", newTo1)
    

11. Извлеките значение жирным шрифтом, например: ecccx.amer.webex.com.

Это домен SRV DNS аудио Webex Edge, который должен быть настроен в BroadWorks.

В этом разделе описывается конфигурация BroadWorks, необходимая для реализации сценариев звонка на номер системы и обратного вызова на совещание, показанных на диаграммах ниже. Примеры конфигурации основаны на данных из файла JSON, показанных в предыдущем разделе. Количество, домены, названия предприятий/групп, типы устройств, политики, профили и т.д. должны варьироваться в зависимости от партнера.

Поток вызовов:

1. Пользователь запрашивает обратный вызов, Webex инициирует обратный вызов.
2. Вызов маршрутизируется в BroadWorks OTT.
3. Вызов достигает CUBE, подготовленного в CH. CUBE маршрутизирует вызов в BroadWorks.
4. BroadWorks идентифицирует вызов как создание организатора совещания, создает сеанс для пользователя организатора совещания и обрабатывает вызов.
5. Сеанс пользователя организатора совещания обрабатывает вызов и переводит набранный номер. Кроме того, от имени пользователя организатора совещания создается запись платежа.
6. BroadWorks маршрутизирует вызов пользователю, связанному с устройством (7), или PSTN (8).

Прежде чем начать

Связь SIP между BroadWorks и CUBE может осуществляться по протоколу UDP или TCP в зависимости от требований к сети. Например, если некоторые сетевые устройства или устройства доступа (например, шлюзы или конечные точки) в потоках обратного вызова или обратного вызова BYoPSTN не поддерживают TCP, вместо этого следует использовать UDP.

Конфигурация и примеры, приведенные в этом руководстве, используют TCP в качестве транспортного протокола. Чтобы использовать TCP, убедитесь, что сервер приложений и сетевой сервер BroadWorks настроены для TCP:

_CLI/Interface/SIP> get
networkProxyTransport = unspecified
accessProxyTransport = unspecified
supportDnsSrv = true
supportTcp = true

Сервер приложений

Идентификация/тип профиля устройства

Для представления CUBE необходимо создать новый тип профиля удостоверения или устройства. Убедитесь в том, что ниже указаны следующие свойства, в то время как другие могут быть оставлены по умолчанию:

• Тип сигнального адреса — задайте значение Интеллектуальная адресация прокси-сервера

• Аутентификация: установить значение Enabled (Включено)

• Идентификация поддержки при ОБНОВЛЕНИИ и повторном приглашении: флажок установлен

• Возможность статической регистрации: задайте значение Включено

• Возможность видео: задано значение Отключено

В приведенном ниже примере новый тип профиля удостоверения/устройства «VXML_profile» создается для представления CUBE.

виртуальный подписчик voice XML

Создание экземпляра VoiceXML

Каждый номер PSTN Webex Meetings представлен виртуальным подписчиком в BroadWorks, и можно использовать функции виртуального подписчика VoiceXML. Для всех виртуальных подписчиков VoiceXML рекомендуется использовать выделенное предприятие и группу. Обратите внимание, что на самом деле мы не используем возможности VoiceXML, но этот тип виртуального пользователя подходит для взаимодействия с CUBE.

Чтобы использовать службу VoiceXML, убедитесь, что лицензия имеет достаточное количество VoiceXML и что служба авторизована на корпоративном и групповом уровнях, а служба VoiceXML назначена группе, как показано на рисунке ниже.

Под Группа > Службы, выберите VoiceXML и создайте экземпляр для каждого номера PSTN.

Настройка адресов VoiceXML

Для каждого экземпляра VoiceXML в разделе Адреса VoiceXML укажите следующее:

• Номер телефона. Введите номер телефона системы для веб-сайта Webex Meetings (например, 2403332200).

• Расширение

• Identity/Device Profile. Создайте один экземпляр (например, VXML_deviceProf) на основе типа устройства, созданного в предыдущем разделе (VXML_profile в примере), и введите следующую конфигурацию.

• Линия/порт: введите в формате <access number="">@<domain> , где

  • <access number=""> является номером кода доступа для веб-сайта Webex Meetings (доступным из файла JSON) (например, 88631321777971704941)

  • <domain> является доменом аудио Webex Edge для этого веб-сайта совещаний (например, ecccspx.amer.pub.webex.com)

• Contact sip: для вызовов на номер доступа при звонке на номер системы совещания будет отправлено INVITE с URI запроса, заданным в этом поле. Введите контакт SIP в этом формате <sip contact="">;<Locale>;<Meetings Site="" UUID="">;<SIP transport="">, где:

  • <sip contact=""> является полем <number> from the line/port, но с доменом как SRV, который разрешает адрес CUBE (например, 88631321777971704941@cube.internal.local)

  • <Locale> представляет собой настройку языка в соответствии с локальностью пользователя (например, locale=en_US)

  • <Meetings Site="" UUID=""> является UUID веб-сайта из файла JSON (например, x-cisco-site-uuid=abbd70f6c519fb1ee053ad fc0a038b)

  • <SIP transport=""> должен быть transport=tcp, чтобы AS использовал TCP для отправки сообщений в CUBE.

Ниже приведен пример настроек адресов VoiceXML.

Для каждого дополнительного номера доступа к совещанию необходимо создать дополнительный виртуальный подписчик VoiceXML, аналогичный указанному выше. Можно использовать тот же профиль устройства, но поля «Порт линии» и «Контакт» должны быть построены из информации о номере доступа, как показано выше.

Убедитесь, что ограничения политики обработки вызовов, настроенные для виртуального подписчика BroadWorks, достаточны для обработки дополнительных вызовов BYoPSTN в группе номеров телефона.

Назначение аутентификации SIP экземпляру VoiceXML

Назначьте службу аутентификации виртуальному подписчику VoiceXML. Это будет использоваться для аутентификации сообщений SIP INVITE из CUBE в сценарии обратного вызова. Кроме того, виртуальный подписчик VoiceXML не может принимать вызовы от сторон, отличных от CUBE

Перейдите на страницу аутентификации виртуального подписчика в разделе Утилиты и введите имя пользователя и пароль SIP, как показано ниже:

CUBE должен быть настроен с одинаковым именем пользователя и паролем для надлежащей аутентификации сообщений INVITE, отправляемых в AS. Пример команды для настройки аутентификации SIP в CUBE приведен ниже. sip-ua authentication username VSUB password 0 <unencrypted password> (See the CUBE onfiguration/datafill for more details).

Файл Namedefs

Поле контакта SIP виртуального подписчика VoiceXML содержит URL, по которому доменная часть обращается к адресу CUBE. Это внутренний SRV, и файл namedefs в AS может использоваться для разрешения внутреннего SRV на CUBE IP.

В нашем примере SRV SIP contact является cube.internal.local и разрешается обратиться к порту 5060 10.165.196.30 для достижения CUBE. На AS /usr/local/broadworks/bw_base/conf/namedefs файл обновлен следующим образом:

_sip.tcp.cube.internal.local SRV 1 99 5060 10.165.196.30

Тип вызова Webex Meetings

Параметры конфигурации обработки вызовов Webex Meetings доступны для управления обработкой вызовов на номер системы. По умолчанию вызовы на номер телефона системы обрабатываются как внешние вызовы, поскольку номера телефона системы размещаются в выделенном предприятии или поставщике услуг. Внешние вызовы обычно включаются в число сеансов контроля допуска к сеансу и помечаются для зарядки в поле CDR chargeIndicator.

В следующем примере добавлена рекомендованная конфигурация для обработки звонков на совещания в качестве внутренних вызовов, исключая их из числа зарядки и исключая из числа контрольных записей допуска к сеансу.

Установив значение Enforce NS Charge Field значение true, население поля CDR chargeIndicator основывается на настроенном атрибуте Charge для типа вызова сетевого сервера.

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> add "Webex Meetings" WXM true true

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> get
      Name    NS Call Type    Enforce NS Charge Field  Process As Internal For SAC-Subscriber
  ==========================================================================================
  Webex Meetings       WXM               true                                true

Виртуальный подписчик обратного вызова совещания VoiceXML

Создание подписчика обратного вызова совещания VoiceXML

Для обработки обратных вызовов Webex Meetings на сервере приложений BroadWorks (AS) необходимо настроить выделенный виртуальный подписчик VoiceXML со специальным параметром обратного вызова Webex Meetings. Только один экземпляр этого подписчика можно настроить в AS.

Чтобы включить эту функцию, установите для параметра Activatable Feature 102074 значение true с помощью CLI.

AS_CLI/System/ActivatableFeature> activate 102074
***** Warning *****:
This activity should only be done during a maintenance window because
this may cause large amounts of data to be added/modified/deleted and
it may take some time to execute. Features that have web page impacts
require that users and administrators log out and log back in.
Are you sure you want to continue?

Please confirm (Yes, Y, No, N): y
...Done

AS_CLI/System/ActivatableFeature> get

      Id                                               Description  Activated  Last Modified Timestamp
=============================================================================================
  102746                            BroadWorks Support for CI UUID       true
  102074          BYO PSTN Billing support for CallBack and CallIn       true      
  104256                          Weak Password Validation Service      false
  104073  Add FAC Support for Call Center Agent Join-Unjoin in CDR      false
  103542   Configurable Endpoint For Auto-Answer And Forced Answer      false
  104255    Control password usage and behavior to ensure security      false

Поскольку функция "BYO PSTN Billing support for CallBack and CallIn" зависит от функции "BroadWorks Support for CI UUID", перед активацией функции (102074) также необходимо активировать функцию (102746). Дополнительные сведения см. в разделе "Синхронизация UUID пользователя CI (поддержка Broadworks для CI UUID)".

Подписчик обратного вызова совещания VoiceXML аналогичен существующему виртуальному подписчику VXML BYOPSTN, но пометил его новым флажком "Обратный вызов совещания Webex". Для этого подписчика обратного вызова совещания VoiceXML настроен тот же профиль устройства, что и для существующего виртуального подписчика VXML BYOPSTN, а также для службы аутентификации с теми же учетными данными.

Пример приведен ниже.

Подписчик обратного вызова совещания VoiceXML должен существовать в системе AS, которая размещает пользователя организатора совещания. Когда служба AS получает запрос INVITE обратного вызова совещания, она пытается найти пользователя обратного вызова совещания VoiceXML и пользователя организатора совещания в AS во время настройки вызова. Если ни один из этих пользователей не найден, вызов будет отклонен.

Сеанс организатора совещания

В сценарии обратного вызова с заголовком X-Cisco-Meet-Info сервер приложений Cisco BroadWorks получает запрос INVITE SIP и идентифицирует пользователя организатора совещания с помощью параметра UUID CI пользователя хоста заголовка SIP X-Cisco-Meet-Info. Сеанс вызова создается от имени пользователя организатора совещания для обработки вызова и выполнения профиля службы пользователя. Кроме того, от имени пользователя организатора совещания создается запись платежа. Идентификатор совещания и информация UUID веб-сайта из заголовка SIP X-Cisco-Meet-Info записываются в платежную запись.

Пример заголовка SIP X-Cisco-Meet-Info показан ниже.

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab
-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

Платформа доставки приложений

Синхронизация UUID пользователя CI (поддержка Broadworks для CI UUID)

CI UUID пользователя – это уникальный идентификатор для идентификации пользователей в среде Webex.

Это приложение синхронизации подготовки Webex на платформе доставки приложений Cisco BroadWorks (ADP) используется для синхронизации, сопоставления и хранения идентификатора CI UUID пользователя в инфраструктуре BroadWorks, чтобы его можно было использовать в различных взаимодействиях с Webex и службой Webex для BroadWorks.

См. «Включение обратного вызова совещания Webex" о том, как CI Пользователь Ассоциация UUID используется сетевым сервером Cisco BroadWorks и сервером приложений Cisco BroadWorks.

Приведенные ниже действия настраивают приложение Webex Provisioning Sync для периодического опроса и обновления пользователей BroadWork с помощью CI UUID.

Для приложения синхронизации подготовки Webex требуются учетные данные OAuth в области spark-admin:broadworks_subscribers_read для поставщика удостоверений Cisco. Их можно получить, отправив запрос на обслуживание у оператора по переносу.

Дополнительные сведения см. в разделе "Получение учетных данных OAuth для Webex для Cisco BroadWorks", чтобы отправить запрос на обслуживание по адресу: https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/Solution_Guide/wbxbw_b_solution-guide/wbxbw_b_SolutionGuide-PDF_chapter_01.html?bookSearch=true#Cisco_Generic_Topic.dita_0e1beabc-80ae-4e8d-b177-17108ec5daed

Добавьте маркер с соответствующим именем партнера, как указано ниже.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> add custBYO refreshToken
      New Password:
      Re-type New Password:
      ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> get
       Partner Name  Refresh Token
==================================
  FederationPartner       ********
           custPart       ********
            custBYO       ********

Добавьте имя партнера, связанное с маркером OAuth, в список партнеров, которые будут отслеживаться приложением Webex Provisioning Sync с флажком "включено", установив значение "true".

Благодаря этому приложение Webex Provisioning Sync начнет выполнять синхронизацию UUID пользователя CI по заданному интервалу опроса.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> add custBYO true

После включения партнера приложение синхронизации подготовки Webex теперь может выполнять связывание CI UUID с пользователями BroadWorks.

Измените время ожидания подключения с помощью следующих команд:

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> set requestTimeout 30000
...Done

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> get
requestTimeout = 30000

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> cd http

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller/Http> set connectionTimeout 300
*** Warning: BroadWorks needs to be restarted for the changes to take effect ***

ADP_CLI/Application/WebexProvisioningSync/GeneralSetting/Controller/HTTP > get
connectionPoolSize = 5
connectionTimeout = 300
connectionIdleTimeOut = 300
maxConcurrentRequests = 10
maxCookieAgeInHours = 24

Это сопряжение можно выполнить автоматически или вручную. Команда CLI manualSync может мгновенно инициировать объединение.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> manualSync custBYO

Партнеры, у которых для параметра "Включено" установлено значение "true", выполняют связанное в интервал опроса. Во время первоначального объединения приложение Webex Provisioning Sync запрашивает API подписчика Webex для получения данных, содержащих CI UUID для всех пользователей, размещенных партнером. Внешний идентификатор пользователя BroadWorks обновляется с помощью связанного идентификатора CI UUID. Последующие ассоциации влияют на пользователей, добавленных в партнера. Можно использовать команду status, чтобы узнать, завершена ли синхронизация.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> status
  Partner Name         Status                 Last Sync Time
============================================================
       custBYO  synchronizing
      custPart     monitoring  2023-01-29T15:36:43.873-05:00
2 entries found.

По завершении синхронизации состояние возвращается к отслеживанию. Последующая синхронизация выполняется для пользователей, добавленных в партнера после "Время последней синхронизации".

На следующем рисунке показан набор идентификатора CI UUID во внешнем идентификаторе:

Сервер Сети

Тип вызова

В целях выставления счетов и отчетности может быть целесообразно пометить CDR для звонков на номер системы Meetings. Это можно выполнить с помощью политики PreCallTyping сервера сети.

Во-первых, в CLI NS в разделе /System/CallP/CallType добавьте новый тип вызова. В следующем примере добавлен новый тип вызова WXM:

NS_CLI/System/CallP/CallTypes> add WXM LOCAL true false "Webex Meetings"
NS_CLI/System/CallP/CallTypes> get calltype WXM    
  CallType     Description  Category         Scope  SupportE164  Charge      
=======================================================================    
  WXM          Webex Meetings  LOCAL  User Defined         true   false

Затем тип вызова можно использовать в экземпляре PreCallTyping, который является частью профиля маршрутизации пользователя BroadWorks. В этом примере в контексте /Policy/PreCallTyping CLI добавлен новый экземпляр PreCallTyping “wxm”, но он может быть уже используемым экземпляром PreCallTyping:

NS_CLI/Policy/PreCallTyping> add wxm true CallTypes ALL

NS_CLI/Policy/PreCallTyping> get wxm                        
Policy: PreCallTyping  Instance: wxm                        
  CallTypes:                                
    Selection = {ALL}                                
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}        
  supportLCABasedNormalization = false                        
  Enable = true 

Следующим шагом является добавление записей в экземпляр PreCallTyping для всех номеров телефона системы в контексте /Policy/PreCallTyping/DialPlan CLI. Пример.

NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings
NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt_e164 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings

NS_CLI/Policy/PreCallTyping/DialPlan> get wxm 1                
Policy: PreCallTyping  Instance: wxm  Table: DialPlan                
CC Dial Plan   From     To          Match Min Max Call Type Prefix Action  Call Ind  Description                  
================================================================================================
1 dflt      12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Weetings
1 dflt_e164 12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Meetings

Экземпляр PreCallTyping добавляется (если он еще не существует) к соответствующему профилю маршрутизации исходного пользователя, как показано в примере ниже.

NS_CLI/Policy/Profile> add Profall PreCallTyping wxm
NS_CLI/Policy/Profile> get profile Profall
Profile:  Profall
                 Policy              Instance
   ==========================================
             CallTyping           DefaultInst
          CallScreening           DefaultInst
            SubLocation           DefaultInst
              FarEndRtg           DefaultInst
             NearEndRtg           DefaultInst
             UrlDialing           DefaultInst
            MediaSrvSel           DefaultInst
                 SIMPLE           DefaultInst
              DstSvcRtg           DefaultInst
      NumberPortability           DefaultInst
             RCBasedRtg           DefaultInst
      NetVoicePortalRtg           DefaultInst
          PreCallTyping                   wxm    

Вызовы CDR BroadWorks генерируются только вызовами, исходящими от абонентов BW. Вызовы, инициированные PSTN со стороны «сети» AS, не будут генерировать инициированные CDR. В любом случае для виртуального подписчика VoiceXML будет завершен CDR.

RoutingNE

В контексте CLI /System/Device/RoutingNE требуется RoutingNE для представления CUBE. Таким образом, когда NS получает INVITE от CUBE, он будет соответствовать заголовку via записи RoutingNE, подготовленной в NS. См. руководство по администрированию интерфейса командной строки сетевого сервера Cisco BroadWorks для получения подробной информации о добавлении RoutingNE.

Ниже приведен пример команд для добавления RoutingNE "WebexMeetings", где IP-адрес CUBE = 10.165.196.30. В примере также показаны команды для создания новых экземпляров OrigRedirect и Profile для связывания с RoutingNE, но существующие экземпляры также могут быть использованы.

NS_CLI/Policy/OrigRedirect> add wxm_Inst true CallTypes ALL supportTrunkGroupLookups disable applyAccessSideRules enableRestrictive

NS_CLI/Policy/OrigRedirect> get  wxm_Inst
Policy: OrigRedirect  Instance: wxm_Inst
  Enable = true
  CallTypes:
    Selection = {ALL}
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}
  supportTrunkGroupLookups:
    Selection = {disable}
    From = {disable, enablePermissive, enableRestrictive}
  applyAccessSideRules:
    Selection = {enableRestrictive}
    From = {disable, enablePermissive, enableRestrictive}

NS_CLI/Policy/Profile> add wxm_routing

NS_CLI/Policy/Profile> add wmx_routing OrigRedirect wxm_Inst

NS_CLI/Policy/Profile> add wmx_routing SubLocation  DefaultInst

NS_CLI/Policy/Profile> get profile wxm_routing 
Profile:  wxm_routing
                 Policy              Instance
   ==========================================
           OrigRedirect           wxm_Inst
            SubLocation           DefaultInst

NS_CLI/System/Device/RoutingNE> add  WebexMeetings 1240364 1 99 wxm_routing false OnLine AccessRoutingNE

NS_CLI/System/Device/RoutingNE/Address> add WebexMeetings 10.165.196.30 1 99 tcp

NS_CLI/System/Device/RoutingNE> get
Network Element  WebexMeetings
   Location      =  1240364
   Static Cost   =  1
   Static Weight =  99
   Poll          =  false
   OpState       =  enabled
   State         =  OnLine
   Profile       =  wxm_routing
   Signaling Attributes=  AccessRoutingNE
 
NS_CLI/System/Device/RoutingNE/Address> get
Routing NE   Address     Cost    Weight     Port    Transport Route  
WebexMeetings   10.165.196.30     1      99     -          tcp

В примере конфигурации CUBE отправляет в NS INVITE, аналогичное приведенному ниже (важные поля выделены жирным шрифтом):

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks
"<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID:
e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGSTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

Где:

• URI запроса INVITE содержит номер обратного вызова

• Заголовок через: содержит IP-адрес CUBE, который будет использоваться для выбора профиля RoutingNE.

• Заголовок X-Cisco-Info-Meet: используется для идентификации hostCIUserUuid, meetingid и siteUUID.

Получив приглашение, NS использует заголовок Via для сопоставления с WebexMeetings RoutingNE. В свою очередь будет выбран профиль маршрутизации «wxm_routing», который содержит экземпляр «wxm_Inst» OrigRedirect.

Политика NS OrigRedirect будет соответствовать заголовку X-CISCO-MEET-INFO:

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

с портом линии, настроенным на виртуальном подписчике VoiceXML, и отправьте перенаправление 302 на пару AS, размещающую этого подписчика. Сообщение 302 аналогично приведенному ниже.

SIP/2.0 302 Moved temporarily
Via:SIP/2.0/TCP 10.165.196.30:5060;branch=z9hG4bK5452684
From:" Webex "<sip:+12403332200@10.165.196.30>;tag=8EEAA586-1675
To:<sip:+14519615001@10.155.6.172>;tag=394411970-1602687588994
Call-ID:ABC5CCA2-D6411EB-8AD6D92D-EE20F768@10.165.196.30
CSeq:101 INVITE
Contact:<sip:+14519615001@hs2-bwks-v-as01-alpha.bwlab.org:5060;user=phone> ;q=0.5, <sip:+14519615001@hs2-bwks-v-as02-alpha.bwlab.org:5060;user=phone>;q=0.25
Content-Length:0

Псевдоним

Домен в URI INVITE (в примере, bw.myenterprise.com), отправленный CUBE в NS, должен быть распознан NS. Это можно сделать, добавив домен в контекст NS_CLI/System/Alias, например:

NS_CLI/System/Alias> add bw.myenterprise.com

Команду для настройки домена URI INVITE в CUBE можно найти в следующем разделе под адресуемой точкой вызова/сеанса, например:

dial-peer voice 23401 voip
session target dns:bw.myenterprise.com

HostingNE

Для поддержки параметров конфигурации обработки вызовов Webex Meetings для выставления счетов и контроля допуска к сеансу необходимо включить атрибуты сигналов хостинга NE сервера приложений CallTypeInfoRequired и RequiresChargeIndication в контексте NS_CLI/System/Device/HostingNE._ Пример.

NS_CLI/System/Device/HostingNE> set broadworksASHostNe signaling E164Compliant,
 CallTypeInfoRequired, SourceId, RequiresNetworkIndication RequiresChargeIndication;

Включение обратного вызова на совещание Webex

В сценарии обратного вызова с заголовком SIP X-Cisco-Meet-Info CUBE отправляет вызов на сетевой сервер для перенаправления отправителя на пару AS. Пара AS определяется на основе системного параметра enableWebexMeetingHoostLookup .

NS_CLI/System/CallP/Options> get
  accessSideRoutingNeDeterminedViaSignaling = false
  disableNdcValidationForCalledNumbers = true
  forceRoutingNEProfile = false
  skipPrivatePoliciesOnEmergency = true
  maxReturnedContacts = 10
  enableWebexMeetingHostLookup = true

Если для параметра системы enableWebexMeetingHoostLookup установлено значение true, CI UUID пользователя организатора совещания в заголовке X-Cisco-Meet-Info используется для идентификации пары AS, размещающей пользователя организатора совещания.

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks "<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID: e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGISTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

В этом разделе приведена проверенная конфигурация развертывания Cisco Unified Border Element (CUBE) в качестве пограничного контроллера сеансов (SBC) для решения Bring Your Own PSTN.

Этот раздел посвящен конфигурациям CUBE, которые необходимы для взаимодействия с примером конфигурации Webex для Cisco BroadWorks, приведенным в предыдущем разделе. Для более общего обсуждения начального развертывания и конфигурации CUBE см. следующие руководства: https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book/voi-cube-overview.html

https://help.webex.com/en-us/b6vrdc/Cisco-Webex-Edge-Audio-for-CUBE-Customer-Configuration-Guide

Развертывание собственного параметра SBC

Если вы не хотите развертывать CUBE, у вас есть возможность развертывания собственного SBC. Однако обратите внимание, что этот документ не предоставляет проверенную конфигурацию для SBC, отличных от CUBE.

При развертывании собственного сеанса сеанса можно руководствоваться требованиями конфигурации CUBE высокого уровня (например, назначениями, такими как домен, общедоступный и частный интерфейсы и шлюзы). Однако подробную справку по командной строке см. в документации по SBC, поскольку фактические команды для вашего SBC, скорее всего, будут отличаться от CUBE.

Если не указано иное, остальные требования к конфигурации, указанные в шаге 10, применяются независимо от развертываемого сеанса сеанса. Однако примеры командной строки приведены только для CUBE, если не указано, что этот пример применяется для других пограничных контроллеров сеансов. Другие контроллеры сеанса сеанса см. в документации по сеансу сеанса.

По завершении настройки и подготовки решения BYoPSTN партнеру необходимо запустить ряд приемочных тестов, чтобы получить сертификат для решения. Это обязательное действие для утверждения и включения решения BYoPSTN партнера.

Примеры приемочных испытаний описаны в документе Bring Your Own PSTN Acceptance Procedure Webex For Cisco BroadWorks по адресу: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/BYoPSTN/BYoPSTN_Acceptance.pdf .

Партнер должен предоставить результаты успешно проведенных приемочных испытаний командам по внедрению и сертификации.

О вопросах, проблемах и результатах приемочных испытаний следует сообщать и предоставлять совместный доступ в пространстве Webex, назначенном для подключения партнера.

Для подготовки BYoPSTN необходимо выполнить следующие предварительные условия. Приведенные ниже предварительные условия предполагают, что у партнера есть рабочее развертывание Webex для Cisco BroadWorks, которое включает:

• Функционирующая система BroadWorks – как описано в руководстве по решению Webex для Cisco BroadWorks

• Лицензия BroadWorks AS с услугой VoiceXML в достаточном количестве (1 на номер PSTN)

• Требуются исправления BroadWorks:

  Для R22:

  • AP.xsp.22.0.1123.ap376935

  • AP.as.22.0.1123.ap376935

  Для R23:

  • AP.xsp.23.0.1075.ap376935

  • AP.as.23.0.1075.ap376935

  Для R24

  • AP.as.24.0.944.ap376935

• Развернутая система Cisco CUBE (версия IOS 16.12.2 или более новая версия): https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book.html

  Поддерживается как аппаратный, так и виртуальный CUBE. Аппаратный CUBE рекомендуется для масштабирования и обработки большего количества вызовов.

• Партнерская организация Webex – как описано в руководстве по решению Webex для Cisco BroadWorks

Для добавления номеров телефона системы Webex партнер Cisco использует следующую процедуру:

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Конфигурация присоединения к совещанию (BYoPSTN) выберите Создать номер телефона системы Group.

5. Введите название группы номеров телефона и нажмите Далее.

6. Введите сведения о номере телефона и нажмите Далее.

7. Просмотрите сводную информацию о группе номеров телефона и нажмите Сохранить.

8. Повторите эту процедуру для каждой добавляемой группы номеров телефона.

Приведенные ниже скриншоты иллюстрируют процедуру.

Этот этап необходимо выполнить только в том случае, если необходимо развернуть параметр присоединения к совещанию с помощью обратного вызова. В противном случае вы можете пропустить этот шаг.

Если этот параметр не настроен, пользователи могут присоединяться к совещаниям с помощью параметра звонка на номер системы или присоединяться с помощью аудио компьютера.

При использовании параметра обратного вызова совещания для маршрутизации вызовов из Webex в CUBE необходима группа SRV DNS обратного вызова. Процедура, которую партнер Cisco использует для добавления записей SRV DNS CUBE в Webex, приведена ниже.

1. Войдите в Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Конфигурация присоединения к совещанию (BYoPSTN) выберите Создать группу SRV DNS обратного вызова.

5. Введите имя группы SRV DNS обратного вызова.

6. Выберите Далее.

7. Введите сведения о SRV DNS обратного вызова.

8. Выберите Далее.

9. Просмотрите сводку сведений о SRV DNS обратного вызова.

10. Нажмите Сохранить.

11. Подготовка всех обновлений в DNS для отражения новых записей в группе SRV DNS.

12. Повторите эту процедуру для каждой добавляемой группы SRV DNS обратного вызова.

Приведенные ниже скриншоты иллюстрируют процедуру.

Для первоначальной настройки и проверки решения BYoPSTN требуется начальная организация для каждой уникальной комбинации группы номеров телефона и группы SRV DNS обратного вызова (если требуется обратный вызов). Поэтому партнерам Cisco рекомендуется аналогичным образом создать новый шаблон клиента для каждой уникальной комбинации группы номеров телефона и группы SRV DNS обратного вызова. Каждый шаблон клиента должен использоваться для создания соответствующей организации семян.

После того как конфигурация BYoPSTN будет инициализирована и проверена с помощью начальных организаций, группы номеров телефона и группы SRV DNS обратного вызова могут быть применены к существующим шаблонам клиентов при необходимости.

Обратите внимание, что недавно созданные шаблоны клиентов не используются существующими нетестируемыми клиентами и поэтому могут быть безопасно использованы для ручной проверки конфигурации BYoPSTN.

Если вы не развертываете функцию присоединения к совещанию с помощью функции обратного вызова, нет необходимости связывать группы SRV DNS обратного вызова с шаблоном клиента. Однако необходимо выбрать Отключить обратный вызов.

Чтобы добавить в новый шаблон клиента, выполните указанные ниже действия.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Шаблоны выберите Добавить шаблон.

5. Введите сведения о шаблоне. На этапе Тип пакета:

   • Выберите Тип пакета в качестве стандартного.

   • Выберите конфигурацию присоединения к совещанию в качестве номеров телефона системы, предоставленных партнером (BYoPSTN).

   • Выберите подготовленную группу номеров телефона.

   • Для группы SRV DNS обратного вызова если необходимо включить параметр обратного вызова на совещание, выберите подготовленную группу SRV DNS обратного вызова. В противном случае выберите Отключить обратный вызов.

6. Выберите Далее.

7. Введите оставшиеся сведения о шаблоне.

8. Просмотрите сводку сведений о шаблоне.

9. Щелкните Сохранить.

10. Повторите эту процедуру для каждого шаблона клиента, который необходимо добавить

Приведенный ниже снимок экрана иллюстрирует процедуру.

Чтобы обновить существующий шаблон клиента, выполните указанные ниже действия.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до раздела Вызовы BroadWorks .

4. В разделе Шаблоны выберите Просмотр шаблона.

5. Выберите шаблон, который необходимо обновить.

6. Прокрутите страницу до раздела Конфигурация присоединения к совещанию .

   • Выберите Номера телефона системы, предоставленные партнером (BYoPSTN).

   • Выберите ранее настроенную группу номеров телефона.

   • Для группы SRV DNS обратного вызова, если необходимо включить параметр обратного вызова на совещание, выберите подготовленную группу SRV DNS обратного вызова. В противном случае выберите Отключить обратный вызов.

7. Нажмите Сохранить.

   Приведенный ниже снимок экрана иллюстрирует процедуру.

Решение BYoPSTN имеет несколько различных компонентов, каждый из которых должен быть настроен правильно для успешной работы решения. Одной из двух целей организаций, использующих начальные решения, является создание номеров телефона для сопоставления кодов доступа к совещаниям и универсально уникального идентификатора веб-сайта совещаний (UUID веб-сайта), которые необходимы для непрерывной работы решения. Другой целью является проверка конфигурации.

Для каждой уникальной комбинации группы номеров телефона и группы SRV DNS обратного вызова необходимо создать соответствующий шаблон клиента ранее. Для каждого из этих шаблонов клиента должна быть подготовлена организация семенного решения. При подготовке этих начальных организаций номер телефона будет создан для сопоставления кодов доступа к совещаниям и UUID веб-сайта совещаний, которые необходимы для настройки BroadWorks.

Используя каждый из ранее настроенных шаблонов клиента, подготовьте подписчика для нового тестового поставщика услуг BroadWorks или нового предприятия BroadWorks с пользователем пакета Standard. В результате на веб-сайте совещаний стандартного пакета должен использоваться параметр присоединения к совещанию по номерам телефона системы поставщика услуг партнера. Для обеспечения абонента может быть использован один из следующих способов:

1. Подготовка тестового подписчика с помощью API подписчиков BroadWorks, как описано в developer.webex.com.

2. Включите тестового подписчика для службы обмена мгновенными сообщениями и состоянием доступности в BroadWorks, настроенном на использование шаблона клиента. Убедитесь, что шаблон клиента использует пакет Standard в качестве стандартного по умолчанию, чтобы тестовому подписчику был назначен пакет Standard. Кроме того, тестируемый подписчик должен быть впоследствии обновлен для получения пакета Standard.

Обратите внимание, что организации семенных решений рекомендуется связать с поставщиком услуг BroadWorks или с тестовым BroadWorks Enterprise.

Крайне важно, чтобы этот веб-сайт совещаний оставался подготовленным, поскольку этот UUID веб-сайта отправляется в каждом запросе на присоединение к совещанию на номер системы в качестве маркера аутентификации. Вы не должны удалять начальную организацию, поскольку связанный веб-сайт совещаний также будет удален. Если начальная организация удалена, вам потребуется подготовить новую организацию и перенастроить Broadworks с новым UUID веб-сайта.

Первичные и любые вторичные организации семян могут быть удалены при необходимости до назначения набора номеров телефона и записей SRV DNS обратного вызова клиентам, не прошедшим тестирование. Если набор номеров телефона и записи SRV DNS обратного вызова назначены любым клиентам, не прошедшим тестирование, эти номера телефона и записи обратного вызова связаны с веб-сайтами совещаний для этих клиентов и используются для присоединения к совещанию с помощью звонка на номер системы и обратного вызова. Любые изменения следует рассматривать как оказывающие влияние на услуги.

Чтобы выбрать организацию первичного семенного решения, выполните приведенные ниже действия.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до раздела Вызовы BroadWorks .

4. В разделе Проверка конфигурации (BYoPSTN) выберите Назначить.

5. На экране Назначить организацию найдите и выберите одну из предварительно настроенных начальных организаций.

6. Нажмите Назначить.

   Выбранная организация семян является основной семенной организацией.

Приведенные ниже скриншоты иллюстрируют процедуру.

Сведения об организации основного семенного решения, группах номеров телефона и группе SRV DNS обратного вызова для определенного кластера BroadWorks доступны в одном местоположении, файле конфигурации BroadWorks (BYoPSTN). Эта информация необходима для настройки BroadWorks для BYoPSTN.

Обратите внимание, что файл конфигурации JSON доступен для просмотра и скачивания только после выбора организации основного семенного решения.

Процедура просмотра и скачивания файла конфигурации JSON приведена ниже.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Настройки.

3. Прокрутите страницу до BroadWorks Calling.

4. В разделе Кластеры выберите Просмотр кластера.

5. Выберите кластер, связанный с шаблонами клиента, настроенными для использования BYoPSTN.

6. Прокрутите страницу до раздела Конфигурация BroadWorks для BYoPSTN .

7. Щелкните Скачать файл конфигурации JSON.

8. Повторите эту процедуру для всех других кластеров BroadWorks.

Приведенные ниже скриншоты иллюстрируют процедуру.

Пример файла конфигурации JSON см. ниже. Файл содержит дополнительную информацию о каждой группе номеров телефона, группе SRV DNS обратного вызова. Следующие ключевые элементы конфигурации, которые необходимо ввести в BroadWorks, выделены жирным шрифтом.

• siteUUID: BroadWorks должна отправить это значение в сообщениях SIP. Это маркер, который используется аудио Webex Edge для подтверждения идентификации BroadWorks партнера Cisco и доступа к веб-сайтам совещаний, управляемым этим партнером Cisco.

• Сопоставление кода доступа по номеру телефона: Номера телефона и связанные с ними коды доступа Webex должны быть настроены в BroadWorks.

  • phoneNumber

  • код доступа

• localeTag: Необходимый язык объявления, связанный с номером телефона, должен быть настроен в BroadWorks.

• dnsSrv: SRV DNS обратного вызова должен быть настроен в DNS и ссылаться на нужные экземпляры CUBE.

{
   "siteUUID": "491db0821791441a96c233fefb6c6dfc",
   "siteURL": " seedtestenterpriseabc.webex.com ",
   "partnerOrgId": "1da175de-3651-4467-b26b-b0d85a2cb3ad",
   "solutionValidationOrgId": "d927ac4d-3d73-4d7f-8506-a1bc0a221934",
   "customerTemplates": [
      {
         "name": "US West Std",
         "id": "27fe1337-ab1d-44b0-8b5e-ff1d32f6e3f8",
         "phoneNumberGroupId": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "US East Std",
         "id": "070d6682-b64f-46ea-bc4b-b2e1218ba4bb",
         "phoneNumberGroupId": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "callbackDnsSrvGroupId": "25392686-a390-49b9-bad5-cb47159c3e992"
      }
   ],
   "phoneNumberGroups": [
   {
         "name": "US West",
         "id": "1bcb05bd-b919-45fd-b30e-71d2abb59e26",
         "phonenumbers": [
            {
               "id": "617c5faa-1721-45c7-bc70-e6d7c20ccc29",
               "name": "US Palo Alto",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "9863502478",
               "accessCode": "88672693772924908359"
            },
            {
               "id": "48fa7c50-9da0-4c8b-9b2f-307ff435c7c7",
               "name": "US Toll San Francisco",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "4156551000",
               "accessCode": "88652789466280320324"
            }
         ]
      },
      {
         "name": "US East",
         "id": "12bc0b8f-ea1d-457f-8fe2-069ccf78907e",
         "phonenumbers": [
            {
               "id": "ca0c622a-8621-4477-91e0-b3e214833568",
               "name": "US Maryland",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "PRIMARY",
               "phoneNumber": "2403332200",
               "accessCode": "88631321777971704941"
            },
            {
               "id": "00875574-9a46-4447-a967-350b6176755a",
               "name": "US Florida",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "Toll",
               "defaultPhoneNumberType": "SECONDARY",
               "phoneNumber": "9049002303",
               "accessCode": "88632627551145646175"
            },
            {
               "id": "a2c10316-9266-4423-a669-d67949f99d33",
               "name": "US New York",
               "countryCode": "US",
               "localeTag": "en_US",
               "tollType": "TollFree",
               "defaultPhoneNumberType": "NONE",
               "phoneNumber": "8056504578",
               "accessCode": "88649679020033567943"
            }
         ]
      }
   ],
   "callbackDnsSrvGroups": [
      {
         "name": "CB US",
         "callbackDnsSrvs": [
            {
               "name": "Callback US",
               "countryCode": "US",
               "dnsSrv": "cube.us.example.com",
               "id": "c5209d17-7c2f-45b3-95a6-65d7f5f53c7e"
            }
         ],
         "id": "25392686-a390-49b9-bad5-cb47159c3e992"
      },
      {
         "name": "CB MX",
         "callbackDnsSrvs": [
            {
               "name": "Callback MX",
               "countryCode": "MX",
               "dnsSrv": "cube.mx.example.com",
               "id": "cca0e4c3-5cff-412c-a854-bfb719f603a2"
            }
         ],
         "id": "36403797-b401-50c0-cbe5-dc58260d4f003"
      }
   ]
}

Домен SRV DNS аудио Webex Edge должен быть настроен в BroadWorks. Для определения значения используйте следующую процедуру.

1. Войдите в Cisco Partner Hub.

2. Перейдите в раздел Клиенты.

3. Выберите предприятие проверки BYoPSTN.

4. Выберите Просмотр данных клиента.

5. Перейдите в раздел Службы/Совещания.

6. Выберите веб-сайт совещаний стандартного пакета.

7. Прокрутите вниз боковой панели и выберите Настройка веб-сайта.

8. Выберите Общие настройки / Настройки аудио.

9. В разделе Пользовательские глобальные номера телефона системы аудио Edge выберите Создать сценарий Lua.

10. Во всплывающем окне найдите значение «-- Update To header with CCAX URL».

     
    -- Update To header with CCAX URL
     local oldTo1 = msg:getHeader("To")
     local newTo1 = string.gsub(oldTo1, "<sip:(.+)@(.*)>", "<sip:%1@ecccx.amer.webex.com>")
     msg:modifyHeader("To", newTo1)
    

11. Извлеките значение жирным шрифтом, например: ecccx.amer.webex.com.

Это домен SRV DNS аудио Webex Edge, который должен быть настроен в BroadWorks.

В этом разделе описывается конфигурация BroadWorks, необходимая для реализации сценариев звонка на номер системы и обратного вызова на совещание, показанных на диаграммах ниже. Примеры конфигурации основаны на данных из файла JSON, показанных в предыдущем разделе. Количество, домены, названия предприятий/групп, типы устройств, политики, профили и т.д. должны варьироваться в зависимости от партнера.

Поток вызовов:

1. Пользователь запрашивает обратный вызов, Webex инициирует обратный вызов.
2. Вызов маршрутизируется в BroadWorks OTT.
3. Вызов достигает CUBE, подготовленного в CH. CUBE маршрутизирует вызов в BroadWorks.
4. BroadWorks идентифицирует вызов как создание организатора совещания, создает сеанс для пользователя организатора совещания и обрабатывает вызов.
5. Сеанс пользователя организатора совещания обрабатывает вызов и переводит набранный номер. Кроме того, от имени пользователя организатора совещания создается запись платежа.
6. BroadWorks маршрутизирует вызов пользователю, связанному с устройством (7), или PSTN (8).

Прежде чем начать

Связь SIP между BroadWorks и CUBE может осуществляться по протоколу UDP или TCP в зависимости от требований к сети. Например, если некоторые сетевые устройства или устройства доступа (например, шлюзы или конечные точки) в потоках обратного вызова или обратного вызова BYoPSTN не поддерживают TCP, вместо этого следует использовать UDP.

Конфигурация и примеры, приведенные в этом руководстве, используют TCP в качестве транспортного протокола. Чтобы использовать TCP, убедитесь, что сервер приложений и сетевой сервер BroadWorks настроены для TCP:

_CLI/Interface/SIP> get
networkProxyTransport = unspecified
accessProxyTransport = unspecified
supportDnsSrv = true
supportTcp = true

Сервер приложений

Идентификация/тип профиля устройства

Для представления CUBE необходимо создать новый тип профиля удостоверения или устройства. Убедитесь в том, что ниже указаны следующие свойства, в то время как другие могут быть оставлены по умолчанию:

• Тип сигнального адреса — задайте значение Интеллектуальная адресация прокси-сервера

• Аутентификация: установить значение Enabled (Включено)

• Идентификация поддержки при ОБНОВЛЕНИИ и повторном приглашении: флажок установлен

• Возможность статической регистрации: задайте значение Включено

• Возможность видео: задано значение Отключено

В приведенном ниже примере новый тип профиля удостоверения/устройства «VXML_profile» создается для представления CUBE.

виртуальный подписчик voice XML

Создание экземпляра VoiceXML

Каждый номер PSTN Webex Meetings представлен виртуальным подписчиком в BroadWorks, и можно использовать функции виртуального подписчика VoiceXML. Для всех виртуальных подписчиков VoiceXML рекомендуется использовать выделенное предприятие и группу. Обратите внимание, что на самом деле мы не используем возможности VoiceXML, но этот тип виртуального пользователя подходит для взаимодействия с CUBE.

Чтобы использовать службу VoiceXML, убедитесь, что лицензия имеет достаточное количество VoiceXML и что служба авторизована на корпоративном и групповом уровнях, а служба VoiceXML назначена группе, как показано на рисунке ниже.

Под Группа > Службы, выберите VoiceXML и создайте экземпляр для каждого номера PSTN.

Настройка адресов VoiceXML

Для каждого экземпляра VoiceXML в разделе Адреса VoiceXML укажите следующее:

• Номер телефона. Введите номер телефона системы для веб-сайта Webex Meetings (например, 2403332200).

• Расширение

• Identity/Device Profile. Создайте один экземпляр (например, VXML_deviceProf) на основе типа устройства, созданного в предыдущем разделе (VXML_profile в примере), и введите следующую конфигурацию.

• Линия/порт: введите в формате <access number="">@<domain> , где

  • <access number=""> является номером кода доступа для веб-сайта Webex Meetings (доступным из файла JSON) (например, 88631321777971704941)

  • <domain> является доменом аудио Webex Edge для этого веб-сайта совещаний (например, ecccspx.amer.pub.webex.com)

• Contact sip: для вызовов на номер доступа при звонке на номер системы совещания будет отправлено INVITE с URI запроса, заданным в этом поле. Введите контакт SIP в этом формате <sip contact="">;<Locale>;<Meetings Site="" UUID="">;<SIP transport="">, где:

  • <sip contact=""> является полем <number> from the line/port, но с доменом как SRV, который разрешает адрес CUBE (например, 88631321777971704941@cube.internal.local)

  • <Locale> представляет собой настройку языка в соответствии с локальностью пользователя (например, locale=en_US)

  • <Meetings Site="" UUID=""> является UUID веб-сайта из файла JSON (например, x-cisco-site-uuid=abbd70f6c519fb1ee053ad fc0a038b)

  • <SIP transport=""> должен быть transport=tcp, чтобы AS использовал TCP для отправки сообщений в CUBE.

Ниже приведен пример настроек адресов VoiceXML.

Для каждого дополнительного номера доступа к совещанию необходимо создать дополнительный виртуальный подписчик VoiceXML, аналогичный указанному выше. Можно использовать тот же профиль устройства, но поля «Порт линии» и «Контакт» должны быть построены из информации о номере доступа, как показано выше.

Убедитесь, что ограничения политики обработки вызовов, настроенные для виртуального подписчика BroadWorks, достаточны для обработки дополнительных вызовов BYoPSTN в группе номеров телефона.

Назначение аутентификации SIP экземпляру VoiceXML

Назначьте службу аутентификации виртуальному подписчику VoiceXML. Это будет использоваться для аутентификации сообщений SIP INVITE из CUBE в сценарии обратного вызова. Кроме того, виртуальный подписчик VoiceXML не может принимать вызовы от сторон, отличных от CUBE

Перейдите на страницу аутентификации виртуального подписчика в разделе Утилиты и введите имя пользователя и пароль SIP, как показано ниже:

CUBE должен быть настроен с одинаковым именем пользователя и паролем для надлежащей аутентификации сообщений INVITE, отправляемых в AS. Пример команды для настройки аутентификации SIP в CUBE приведен ниже. sip-ua authentication username VSUB password 0 <unencrypted password> (See the CUBE onfiguration/datafill for more details).

Файл Namedefs

Поле контакта SIP виртуального подписчика VoiceXML содержит URL, по которому доменная часть обращается к адресу CUBE. Это внутренний SRV, и файл namedefs в AS может использоваться для разрешения внутреннего SRV на CUBE IP.

В нашем примере SRV SIP contact является cube.internal.local и разрешается обратиться к порту 5060 10.165.196.30 для достижения CUBE. На AS /usr/local/broadworks/bw_base/conf/namedefs файл обновлен следующим образом:

_sip.tcp.cube.internal.local SRV 1 99 5060 10.165.196.30

Тип вызова Webex Meetings

Параметры конфигурации обработки вызовов Webex Meetings доступны для управления обработкой вызовов на номер системы. По умолчанию вызовы на номер телефона системы обрабатываются как внешние вызовы, поскольку номера телефона системы размещаются в выделенном предприятии или поставщике услуг. Внешние вызовы обычно включаются в число сеансов контроля допуска к сеансу и помечаются для зарядки в поле CDR chargeIndicator.

В следующем примере добавлена рекомендованная конфигурация для обработки звонков на совещания в качестве внутренних вызовов, исключая их из числа зарядки и исключая из числа контрольных записей допуска к сеансу.

Установив значение Enforce NS Charge Field значение true, население поля CDR chargeIndicator основывается на настроенном атрибуте Charge для типа вызова сетевого сервера.

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> add "Webex Meetings" WXM true true

AS_CLI/System/CallP/WebexMeetings/WebexCallTypes> get
      Name    NS Call Type    Enforce NS Charge Field  Process As Internal For SAC-Subscriber
  ==========================================================================================
  Webex Meetings       WXM               true                                true

Виртуальный подписчик обратного вызова совещания VoiceXML

Создание подписчика обратного вызова совещания VoiceXML

Для обработки обратных вызовов Webex Meetings на сервере приложений BroadWorks (AS) необходимо настроить выделенный виртуальный подписчик VoiceXML со специальным параметром обратного вызова Webex Meetings. Только один экземпляр этого подписчика можно настроить в AS.

Чтобы включить эту функцию, установите для параметра Activatable Feature 102074 значение true с помощью CLI.

AS_CLI/System/ActivatableFeature> activate 102074
***** Warning *****:
This activity should only be done during a maintenance window because
this may cause large amounts of data to be added/modified/deleted and
it may take some time to execute. Features that have web page impacts
require that users and administrators log out and log back in.
Are you sure you want to continue?

Please confirm (Yes, Y, No, N): y
...Done

AS_CLI/System/ActivatableFeature> get

      Id                                               Description  Activated  Last Modified Timestamp
=============================================================================================
  102746                            BroadWorks Support for CI UUID       true
  102074          BYO PSTN Billing support for CallBack and CallIn       true      
  104256                          Weak Password Validation Service      false
  104073  Add FAC Support for Call Center Agent Join-Unjoin in CDR      false
  103542   Configurable Endpoint For Auto-Answer And Forced Answer      false
  104255    Control password usage and behavior to ensure security      false

Поскольку функция "BYO PSTN Billing support for CallBack and CallIn" зависит от функции "BroadWorks Support for CI UUID", перед активацией функции (102074) также необходимо активировать функцию (102746). Дополнительные сведения см. в разделе "Синхронизация UUID пользователя CI (поддержка Broadworks для CI UUID)".

Подписчик обратного вызова совещания VoiceXML аналогичен существующему виртуальному подписчику VXML BYOPSTN, но пометил его новым флажком "Обратный вызов совещания Webex". Для этого подписчика обратного вызова совещания VoiceXML настроен тот же профиль устройства, что и для существующего виртуального подписчика VXML BYOPSTN, а также для службы аутентификации с теми же учетными данными.

Пример приведен ниже.

Подписчик обратного вызова совещания VoiceXML должен существовать в системе AS, которая размещает пользователя организатора совещания. Когда служба AS получает запрос INVITE обратного вызова совещания, она пытается найти пользователя обратного вызова совещания VoiceXML и пользователя организатора совещания в AS во время настройки вызова. Если ни один из этих пользователей не найден, вызов будет отклонен.

Сеанс организатора совещания

В сценарии обратного вызова с заголовком X-Cisco-Meet-Info сервер приложений Cisco BroadWorks получает запрос INVITE SIP и идентифицирует пользователя организатора совещания с помощью параметра UUID CI пользователя хоста заголовка SIP X-Cisco-Meet-Info. Сеанс вызова создается от имени пользователя организатора совещания для обработки вызова и выполнения профиля службы пользователя. Кроме того, от имени пользователя организатора совещания создается запись платежа. Идентификатор совещания и информация UUID веб-сайта из заголовка SIP X-Cisco-Meet-Info записываются в платежную запись.

Пример заголовка SIP X-Cisco-Meet-Info показан ниже.

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab
-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

Платформа доставки приложений

Синхронизация UUID пользователя CI (поддержка Broadworks для CI UUID)

CI UUID пользователя – это уникальный идентификатор для идентификации пользователей в среде Webex.

Это приложение синхронизации подготовки Webex на платформе доставки приложений Cisco BroadWorks (ADP) используется для синхронизации, сопоставления и хранения идентификатора CI UUID пользователя в инфраструктуре BroadWorks, чтобы его можно было использовать в различных взаимодействиях с Webex и службой Webex для BroadWorks.

См. «Включение обратного вызова совещания Webex" о том, как CI Пользователь Ассоциация UUID используется сетевым сервером Cisco BroadWorks и сервером приложений Cisco BroadWorks.

Приведенные ниже действия настраивают приложение Webex Provisioning Sync для периодического опроса и обновления пользователей BroadWork с помощью CI UUID.

Для приложения синхронизации подготовки Webex требуются учетные данные OAuth в области spark-admin:broadworks_subscribers_read для поставщика удостоверений Cisco. Их можно получить, отправив запрос на обслуживание у оператора по переносу.

Дополнительные сведения см. в разделе "Получение учетных данных OAuth для Webex для Cisco BroadWorks", чтобы отправить запрос на обслуживание по адресу: https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/Solution_Guide/wbxbw_b_solution-guide/wbxbw_b_SolutionGuide-PDF_chapter_01.html?bookSearch=true#Cisco_Generic_Topic.dita_0e1beabc-80ae-4e8d-b177-17108ec5daed

Добавьте маркер с соответствующим именем партнера, как указано ниже.

ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> add custBYO refreshToken
      New Password:
      Re-type New Password:
      ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CiscoIdentityProvider/Partners> get
       Partner Name  Refresh Token
==================================
  FederationPartner       ********
           custPart       ********
            custBYO       ********

Добавьте имя партнера, связанное с маркером OAuth, в список партнеров, которые будут отслеживаться приложением Webex Provisioning Sync с флажком "включено", установив значение "true".

Благодаря этому приложение Webex Provisioning Sync начнет выполнять синхронизацию UUID пользователя CI по заданному интервалу опроса.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> add custBYO true

После включения партнера приложение синхронизации подготовки Webex теперь может выполнять связывание CI UUID с пользователями BroadWorks.

Измените время ожидания подключения с помощью следующих команд:

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> set requestTimeout 30000
...Done

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> get
requestTimeout = 30000

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller> cd http

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/Controller/Http> set connectionTimeout 300
*** Warning: BroadWorks needs to be restarted for the changes to take effect ***

ADP_CLI/Application/WebexProvisioningSync/GeneralSetting/Controller/HTTP > get
connectionPoolSize = 5
connectionTimeout = 300
connectionIdleTimeOut = 300
maxConcurrentRequests = 10
maxCookieAgeInHours = 24

Это сопряжение можно выполнить автоматически или вручную. Команда CLI manualSync может мгновенно инициировать объединение.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> manualSync custBYO

Партнеры, у которых для параметра "Включено" установлено значение "true", выполняют связанное в интервал опроса. Во время первоначального объединения приложение Webex Provisioning Sync запрашивает API подписчика Webex для получения данных, содержащих CI UUID для всех пользователей, размещенных партнером. Внешний идентификатор пользователя BroadWorks обновляется с помощью связанного идентификатора CI UUID. Последующие ассоциации влияют на пользователей, добавленных в партнера. Можно использовать команду status, чтобы узнать, завершена ли синхронизация.

ADP_CLI/Applications/WebexProvisioningSync/GeneralSettings/MonitoredPartners> status
  Partner Name         Status                 Last Sync Time
============================================================
       custBYO  synchronizing
      custPart     monitoring  2023-01-29T15:36:43.873-05:00
2 entries found.

По завершении синхронизации состояние возвращается к отслеживанию. Последующая синхронизация выполняется для пользователей, добавленных в партнера после "Время последней синхронизации".

На следующем рисунке показан набор идентификатора CI UUID во внешнем идентификаторе:

Сервер Сети

Тип вызова

В целях выставления счетов и отчетности может быть целесообразно пометить CDR для звонков на номер системы Meetings. Это можно выполнить с помощью политики PreCallTyping сервера сети.

Во-первых, в CLI NS в разделе /System/CallP/CallType добавьте новый тип вызова. В следующем примере добавлен новый тип вызова WXM:

NS_CLI/System/CallP/CallTypes> add WXM LOCAL true false "Webex Meetings"
NS_CLI/System/CallP/CallTypes> get calltype WXM    
  CallType     Description  Category         Scope  SupportE164  Charge      
=======================================================================    
  WXM          Webex Meetings  LOCAL  User Defined         true   false

Затем тип вызова можно использовать в экземпляре PreCallTyping, который является частью профиля маршрутизации пользователя BroadWorks. В этом примере в контексте /Policy/PreCallTyping CLI добавлен новый экземпляр PreCallTyping “wxm”, но он может быть уже используемым экземпляром PreCallTyping:

NS_CLI/Policy/PreCallTyping> add wxm true CallTypes ALL

NS_CLI/Policy/PreCallTyping> get wxm                        
Policy: PreCallTyping  Instance: wxm                        
  CallTypes:                                
    Selection = {ALL}                                
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}        
  supportLCABasedNormalization = false                        
  Enable = true 

Следующим шагом является добавление записей в экземпляр PreCallTyping для всех номеров телефона системы в контексте /Policy/PreCallTyping/DialPlan CLI. Пример.

NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings
NS_CLI/Policy/PreCallTyping/DialPlan> add wxm 1 dflt_e164 12403332200 12403332200 exact 11 11 WXM 0 0 Webex Meetings

NS_CLI/Policy/PreCallTyping/DialPlan> get wxm 1                
Policy: PreCallTyping  Instance: wxm  Table: DialPlan                
CC Dial Plan   From     To          Match Min Max Call Type Prefix Action  Call Ind  Description                  
================================================================================================
1 dflt      12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Weetings
1 dflt_e164 12403332200 12403332200 {exact} 11 11 {WXM}     0                      Webex Meetings

Экземпляр PreCallTyping добавляется (если он еще не существует) к соответствующему профилю маршрутизации исходного пользователя, как показано в примере ниже.

NS_CLI/Policy/Profile> add Profall PreCallTyping wxm
NS_CLI/Policy/Profile> get profile Profall
Profile:  Profall
                 Policy              Instance
   ==========================================
             CallTyping           DefaultInst
          CallScreening           DefaultInst
            SubLocation           DefaultInst
              FarEndRtg           DefaultInst
             NearEndRtg           DefaultInst
             UrlDialing           DefaultInst
            MediaSrvSel           DefaultInst
                 SIMPLE           DefaultInst
              DstSvcRtg           DefaultInst
      NumberPortability           DefaultInst
             RCBasedRtg           DefaultInst
      NetVoicePortalRtg           DefaultInst
          PreCallTyping                   wxm    

Вызовы CDR BroadWorks генерируются только вызовами, исходящими от абонентов BW. Вызовы, инициированные PSTN со стороны «сети» AS, не будут генерировать инициированные CDR. В любом случае для виртуального подписчика VoiceXML будет завершен CDR.

RoutingNE

В контексте CLI /System/Device/RoutingNE требуется RoutingNE для представления CUBE. Таким образом, когда NS получает INVITE от CUBE, он будет соответствовать заголовку via записи RoutingNE, подготовленной в NS. См. руководство по администрированию интерфейса командной строки сетевого сервера Cisco BroadWorks для получения подробной информации о добавлении RoutingNE.

Ниже приведен пример команд для добавления RoutingNE "WebexMeetings", где IP-адрес CUBE = 10.165.196.30. В примере также показаны команды для создания новых экземпляров OrigRedirect и Profile для связывания с RoutingNE, но существующие экземпляры также могут быть использованы.

NS_CLI/Policy/OrigRedirect> add wxm_Inst true CallTypes ALL supportTrunkGroupLookups disable applyAccessSideRules enableRestrictive

NS_CLI/Policy/OrigRedirect> get  wxm_Inst
Policy: OrigRedirect  Instance: wxm_Inst
  Enable = true
  CallTypes:
    Selection = {ALL}
    From = {PCS, ALL, TRMT, LO, GNT, DP, WXM, LPS, OA, TPS, EA, FGB, POA, SV, SVCD, IN, MS, CSV, EM, SVCO, SMC, ZD, NIL, CT, TF, GAN, TO, DA, OAP}
  supportTrunkGroupLookups:
    Selection = {disable}
    From = {disable, enablePermissive, enableRestrictive}
  applyAccessSideRules:
    Selection = {enableRestrictive}
    From = {disable, enablePermissive, enableRestrictive}

NS_CLI/Policy/Profile> add wxm_routing

NS_CLI/Policy/Profile> add wmx_routing OrigRedirect wxm_Inst

NS_CLI/Policy/Profile> add wmx_routing SubLocation  DefaultInst

NS_CLI/Policy/Profile> get profile wxm_routing 
Profile:  wxm_routing
                 Policy              Instance
   ==========================================
           OrigRedirect           wxm_Inst
            SubLocation           DefaultInst

NS_CLI/System/Device/RoutingNE> add  WebexMeetings 1240364 1 99 wxm_routing false OnLine AccessRoutingNE

NS_CLI/System/Device/RoutingNE/Address> add WebexMeetings 10.165.196.30 1 99 tcp

NS_CLI/System/Device/RoutingNE> get
Network Element  WebexMeetings
   Location      =  1240364
   Static Cost   =  1
   Static Weight =  99
   Poll          =  false
   OpState       =  enabled
   State         =  OnLine
   Profile       =  wxm_routing
   Signaling Attributes=  AccessRoutingNE
 
NS_CLI/System/Device/RoutingNE/Address> get
Routing NE   Address     Cost    Weight     Port    Transport Route  
WebexMeetings   10.165.196.30     1      99     -          tcp

В примере конфигурации CUBE отправляет в NS INVITE, аналогичное приведенному ниже (важные поля выделены жирным шрифтом):

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks
"<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID:
e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGSTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

Где:

• URI запроса INVITE содержит номер обратного вызова

• Заголовок через: содержит IP-адрес CUBE, который будет использоваться для выбора профиля RoutingNE.

• Заголовок X-Cisco-Info-Meet: используется для идентификации hostCIUserUuid, meetingid и siteUUID.

Получив приглашение, NS использует заголовок Via для сопоставления с WebexMeetings RoutingNE. В свою очередь будет выбран профиль маршрутизации «wxm_routing», который содержит экземпляр «wxm_Inst» OrigRedirect.

Политика NS OrigRedirect будет соответствовать заголовку X-CISCO-MEET-INFO:

X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec

с портом линии, настроенным на виртуальном подписчике VoiceXML, и отправьте перенаправление 302 на пару AS, размещающую этого подписчика. Сообщение 302 аналогично приведенному ниже.

SIP/2.0 302 Moved temporarily
Via:SIP/2.0/TCP 10.165.196.30:5060;branch=z9hG4bK5452684
From:" Webex "<sip:+12403332200@10.165.196.30>;tag=8EEAA586-1675
To:<sip:+14519615001@10.155.6.172>;tag=394411970-1602687588994
Call-ID:ABC5CCA2-D6411EB-8AD6D92D-EE20F768@10.165.196.30
CSeq:101 INVITE
Contact:<sip:+14519615001@hs2-bwks-v-as01-alpha.bwlab.org:5060;user=phone> ;q=0.5, <sip:+14519615001@hs2-bwks-v-as02-alpha.bwlab.org:5060;user=phone>;q=0.25
Content-Length:0

Псевдоним

Домен в URI INVITE (в примере, bw.myenterprise.com), отправленный CUBE в NS, должен быть распознан NS. Это можно сделать, добавив домен в контекст NS_CLI/System/Alias, например:

NS_CLI/System/Alias> add bw.myenterprise.com

Команду для настройки домена URI INVITE в CUBE можно найти в следующем разделе под адресуемой точкой вызова/сеанса, например:

dial-peer voice 23401 voip
session target dns:bw.myenterprise.com

HostingNE

Для поддержки параметров конфигурации обработки вызовов Webex Meetings для выставления счетов и контроля допуска к сеансу необходимо включить атрибуты сигналов хостинга NE сервера приложений CallTypeInfoRequired и RequiresChargeIndication в контексте NS_CLI/System/Device/HostingNE._ Пример.

NS_CLI/System/Device/HostingNE> set broadworksASHostNe signaling E164Compliant,
 CallTypeInfoRequired, SourceId, RequiresNetworkIndication RequiresChargeIndication;

Включение обратного вызова на совещание Webex

В сценарии обратного вызова с заголовком SIP X-Cisco-Meet-Info CUBE отправляет вызов на сетевой сервер для перенаправления отправителя на пару AS. Пара AS определяется на основе системного параметра enableWebexMeetingHoostLookup .

NS_CLI/System/CallP/Options> get
  accessSideRoutingNeDeterminedViaSignaling = false
  disableNdcValidationForCalledNumbers = true
  forceRoutingNEProfile = false
  skipPrivatePoliciesOnEmergency = true
  maxReturnedContacts = 10
  enableWebexMeetingHostLookup = true

Если для параметра системы enableWebexMeetingHoostLookup установлено значение true, CI UUID пользователя организатора совещания в заголовке X-Cisco-Meet-Info используется для идентификации пары AS, размещающей пользователя организатора совещания.

INVITE sip:+19991111111@domain.com:5060 SIP/2.0
Via:SIP/2.0/TCP 10.10.10.10:5060;branch=z9hG4bK7C7B9EB
Remote-Party-ID:" BroadWorks "<sip:886222222222@domain.com>;screen=no;party=calling;privacy=off
From:" BroadWorks "<sip:+12403333333@10.20.20.20>;tag=958BDDF4-1AB
To:<sip:+19991111111@domain.com>
Date:Thu, 03 Nov 2022 12:39:58 GMT
Call-ID:75D3B642-5AAB11ED-AC82BA3C-276254A1@10.20.20.30
Supported:100rel,timer,resource-priority,replaces,sdp-anat
Min-SE:14400
Cisco-Guid: 1976459008-1521160685-2893855292-0660755617
X-Cisco-Meet-Info:hostCIUserUuid="52f4c6cb-c6a3-4283-a1ab-04cc8828b7c1";meetingid="26551128462";siteUUID="ec6659987f473332e0531b04fc0acaec"
X-Cisco-Org-Id:82e2eb35-1610-44e7-9b20-ab607e026270
User-Agent: Cisco-SIPGateway/IOS-16.12.2s
Timestamp: 1667479198
Session-ID: e13cc71f24ae400669d5247d8306ac23;remote=00000000000000000000000000000000
Allow:INVITE,OPTIONS,BYE,CANCEL,ACK,PRACK,UPDATE,REFER,SUBSCRIBE,NOTIFY,INFO,REGISTER
CSeq:101 INVITE
Contact:<sip:+12403333333@10.20.20.20:5060;transport=tcp>
Expires:180
Allow-Events:telephone-event
Max-Forwards:68

В этом разделе приведена проверенная конфигурация развертывания Cisco Unified Border Element (CUBE) в качестве пограничного контроллера сеансов (SBC) для решения Bring Your Own PSTN.

Этот раздел посвящен конфигурациям CUBE, которые необходимы для взаимодействия с примером конфигурации Webex для Cisco BroadWorks, приведенным в предыдущем разделе. Для более общего обсуждения начального развертывания и конфигурации CUBE см. следующие руководства: https://www.cisco.com/c/en/us/td/docs/ios-xml/ios/voice/cube/configuration/cube-book/voi-cube-overview.html

https://help.webex.com/en-us/b6vrdc/Cisco-Webex-Edge-Audio-for-CUBE-Customer-Configuration-Guide

Развертывание собственного параметра SBC

Если вы не хотите развертывать CUBE, у вас есть возможность развертывания собственного SBC. Однако обратите внимание, что этот документ не предоставляет проверенную конфигурацию для SBC, отличных от CUBE.

При развертывании собственного сеанса сеанса можно руководствоваться требованиями конфигурации CUBE высокого уровня (например, назначениями, такими как домен, общедоступный и частный интерфейсы и шлюзы). Однако подробную справку по командной строке см. в документации по SBC, поскольку фактические команды для вашего SBC, скорее всего, будут отличаться от CUBE.

Если не указано иное, остальные требования к конфигурации, указанные в шаге 10, применяются независимо от развертываемого сеанса сеанса. Однако примеры командной строки приведены только для CUBE, если не указано, что этот пример применяется для других пограничных контроллеров сеансов. Другие контроллеры сеанса сеанса см. в документации по сеансу сеанса.

По завершении настройки и подготовки решения BYoPSTN партнеру необходимо запустить ряд приемочных тестов, чтобы получить сертификат для решения. Это обязательное действие для утверждения и включения решения BYoPSTN партнера.

Примеры приемочных испытаний описаны в документе Bring Your Own PSTN Acceptance Procedure Webex For Cisco BroadWorks по адресу: https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cloudCollaboration/wx4bwks/BYoPSTN/BYoPSTN_Acceptance.pdf .

Партнер должен предоставить результаты успешно проведенных приемочных испытаний командам по внедрению и сертификации.

О вопросах, проблемах и результатах приемочных испытаний следует сообщать и предоставлять совместный доступ в пространстве Webex, назначенном для подключения партнера.