05 июня 2025 г. | 32 – просмотры | 0 – пользователи, которые сочли этот материал полезным

Настройка push-уведомлений о вызовах для Webex BroadWorks

list-menuОтправить обратную связь?
Узнайте, как настроить push-уведомления о вызовах для Webex для BroadWorks с помощью NPS для Android и iOS.

В этом документе мы используем термин Сервер push-уведомлений о вызовах (CNPS) для описания приложения, размещенного на XSP или ADP, которое запускается в вашей среде. CnPS работает с системой BroadWorks для уведомления о входящих вызовах ваших пользователей и передает уведомления о них в службы уведомлений Google Firebase Cloud Messaging (FCM) или службы push-уведомлений Apple (APN).

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

Подробную информацию о NPS см. в описании функций сервера push-уведомлений.

Схожий механизм в Webex работает со службами обмена сообщениями и присутствия Webex для отправки push-уведомлений в службы уведомлений Google (FCM) или Apple (APN). Эти службы, в свою очередь, уведомляют мобильных пользователей Webex о входящих сообщениях или изменениях присутствия.

В этом разделе описывается, как настроить NPS для прокси-сервера аутентификации, если NPS еще не поддерживает другие приложения. Если вам необходимо перенести общий NPS на использование прокси-сервера NPS, см. Обновление Cisco BroadWorks NPS для использования прокси-сервера NPS.

Обзор прокси-сервера NPS

Для совместимости с Webex для Cisco BroadWorks CNPS должен иметь установленное исправление для поддержки функции прокси NPS, Сервер push-уведомлений для передачи голоса по IP в UCaaS.

Эта функция реализует новый дизайн сервера push-уведомлений для устранения уязвимости при совместном доступе к закрытым ключам сертификата для push-уведомлений в отношении поставщиков услуг для мобильных клиентов. Вместо предоставления совместного доступа к сертификатам и ключам push-уведомлений для поставщиков услуг NPS использует новый API для получения краткосрочного токена push-уведомления от сервера Webex для Cisco BroadWorks и использует этот токен для аутентификации в службах Apple APN и Google FCM.

Эта функция также расширяет возможности сервера push-уведомлений для отправки уведомлений на устройства Android посредством нового API Google Firebase Cloud Messaging (FCM) HTTPv1.

Рекомендации относительно APNS

С 31 марта 2021 г. компания Apple прекращает поддержку двоичного протокола HTTP/1 для службы push-уведомлений Apple. Мы рекомендуем вам настроить XSP|ADP для использования HTTP/2-based интерфейс для APN. Для этого обновления требуется, чтобы ваш XSP|ADP, на котором размещен NPS, работал под управлением R22 или более поздней версии.

Подготовка NPS для Webex для Cisco BroadWorks

1

Установите и настройте выделенный XSP (минимальная версия R22) или платформу доставки приложений (ADP).

2

Установите исправления прокси-сервера аутентификации NPS.

Исправления XSP R22:

Исправления XSP R23:

3

Активируйте приложение сервера push-уведомлений.

4

(Для уведомлений Android) Активируйте FCM v1 API на NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Для уведомлений Apple iOS) Активируйте HTTP/2 на NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

Это эксклюзивно для версии 22 и более ранних версий; это недоступно в версии 23 и более поздних, которые поддерживают только HTTP/2.

6

Подключите техподдержку от NPS XSP/ADP.

7

На каждом сервере AS файл namedefs в /usr/local/broadworks/bw_base/conf должен быть настроен с записями SRV и A для Notification Push Server. (XSP/ADP) поиск, если несколько XSP/ADP затем добавьте запись для каждого по мере необходимости.

Пример. _pushnotification-клиент._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com В A 10.193.78.149

После настройки для вступления изменений в силу требуется выполнить одно из следующих действий:

  1. Перезапуск должен быть выполнен в период технического обслуживания.

  2. Через интерфейс командной строки Cisco BroadWorks:

    R24 и старше

    AS_CLI/ASDiagnostic/DNS> перезагрузите

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> перезагрузите

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> перезагрузите

Дальнейшие действия

Для новых установок NPS перейдите к Настройка NPS для использования прокси-сервера аутентификации

Чтобы перенести существующее развертывание Android на FCMv1, перейдите на страницу Миграция NPS на FCMv1

Настройте NPS для использования прокси-сервера аутентификации

Эта задача относится к новой установке NPS, выделенной для Webex для Cisco BroadWorks.

Если вы хотите настроить прокси-сервер аутентификации на сервере NPS, который используется совместно с другими мобильными приложениями, см. раздел Обновление Cisco BroadWorks NPS для использования прокси-сервера NPS.

1

Получение учетных данных OAuth для вашего Webex для Cisco BroadWorks.

2

Создайте учетную запись клиента в NPS.

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Чтобы проверить соответствие введенных значений с заданными, выполните команду XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI issuerUrl ВСЕГДА должен соответствовать кластеру US CI независимо от вашего местоположения, а значение по умолчанию должно быть: 

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

3

Введите URL-адрес прокси-сервера NPS и установите интервал обновления токена (рекомендуется 30 минут):

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

Для повышения скорости разрешения DNS вместо текущего полного доменного имени nps.uc-one.broadsoft.com мы рекомендуем вам использовать соответствующее полное доменное имя в зависимости от вашего региона.

Региональные полные доменные имена:

Восток США:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

Запад США:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

Европа:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Если push-уведомления истекают из-за задержки в разрешении DNS, увеличьте значение тайм-аута в "/etc/resolv.conf" файл на сервере BroadWorks.

4

(Для уведомлений Android) Добавьте ID приложения Android в контекст приложений FCM на NPS.

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

5

(Для уведомлений Apple iOS) Добавьте ID приложения в контекст приложений APNS, не указывая ключ Auth (оставьте его пустым).

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

6

Настройте приведенные ниже URL-адреса NPS.

XSP|Контекст ADP CLI

Параметр

Значение

  • XSP|ADP_CLI/Applications/NotificationPushServer/FCM>

authURL

https://www.googleapis.com/oauth2/v4/token

pushURL

https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send

scope

https://www.googleapis.com/auth/firebase.messaging

  • XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production>

url

https://api.push.apple.com/3/device

7

Настройте следующие параметры соединения NPS в соответствии с рекомендуемыми значениями, приведенными ниже.

XSP|Контекст ADP CLI

Параметр

Значение

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Убедитесь в том, что сервер приложений фильтрует ID приложений, поскольку может потребоваться добавить приложения Webex в список разрешений.

  1. Запустите AS_CLI/System/PushNotification> get и проверьте значение enforceAllowedApplicationList. Если это true, вам необходимо выполнить эту подзадачу. В противном случае пропустите остальную часть подзадачи.

  2. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

9

Перезапустите XSP|ADP: bwrestart

10

Проверьте уведомления о вызовах путем осуществления вызовов от подписчика BroadWorks двум пользователям мобильных устройств Webex. Убедитесь, что уведомление о вызове отображается на устройствах iOS и Android.

Перенос NPS в FCMv1

В этом разделе содержатся дополнительные процедуры, которые можно использовать в консоли FCM Google для существующего развертывания NPS, которое необходимо перенести в FCMv1. Существует три процедуры:

Перенос клиентов UC-One на FCMv1

Для миграции клиентов UC-One на Google FCM HTTPv1 выполните следующие действия в консоли Google FCM.

Если для клиента используется брендинг, у клиента должен быть Идентификатор отправителя. В консоли FCM откройте раздел Настройки проекта > Обмен сообщениями в облаке Этот параметр появится в таблице учетных данных проекта.

Подробную информацию см. в Руководстве по брендингу Connect Mobile по адресу https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Обратитесь к параметру gcm_defaultSenderId, который находится в папке Branding Kit, Resource, файле branding.xml со следующим синтаксисом:

xxxxxxxxxxxxx

  1. Войдите в FCM Admin SDK http://console.firebase.google.com.

  2. Выберите соответствующее приложение Android.

  3. Откройте вкладку Общие и запишите идентификатор проекта.

  4. Перейдите на вкладку учетных записей служб, чтобы настроить учетную запись службы. Можно создать новую учетную запись службы или настроить существующую.

    Чтобы создать новую учетную запись службы, нужно сделать это.

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

    2. Щелкните синюю кнопку, чтобы создать новый закрытый ключ.

    3. Скачайте ключ в безопасную папку.

    Для повторного использования существующей учетной записи службы, выполните следующие действия:

    1. Щелкните синий текст, чтобы просмотреть существующие учетные записи службы.

    2. Определите учетную запись службы, которая будет использоваться. Для учетной записи службы требуется разрешение firebaseadmin-sdk.

    3. Справа щелкните значок «гамбургер» и создайте новый закрытый ключ.

    4. Скачайте файл JSON, содержащий ключ, и сохраните его в безопасном местоположении.

  5. Скопируйте файл json в XSP|ADP.

  6. Настройте идентификатор проекта и:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add

  7. Настройте приложение:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add  projectId 
...Done

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
  Application ID    Project ID
==============================
          my_app    my_project

  8. Включить FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  9. Выполните команду bwrestart, чтобы перезапустить XSP|ADP.

Миграция клиентов SaaS в FCMv1

Чтобы перенести клиенты SaaS в FCMv1, воспользуйтесь приведенной ниже таблицей.

Убедитесь в том, что процедура «Настройка NPS для использования прокси-сервера аутентификации» уже завершена.

  1. Отключить FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
...Done

  2. Выполните команду bwrestart, чтобы перезапустить XSP|ADP.

  3. Включить FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  4. Выполните команду bwrestart, чтобы перезапустить XSP|ADP.

Обновить сервер ADP

При переносе NPS для работы с сервером ADP выполните следующие действия в консоли Google FCM.

  1. Получите файл JSON из консоли Google Cloud Console.

    1. На консоли Google Cloud Console перейдите на страницу Учетные записи служб.

    2. Щелкните Выбрать проект, выберите свой проект и щелкните Открыть.

    3. Найдите строку учетной записи службы, для которой вы хотите создать ключ, нажмите вертикальную кнопку Еще, затем нажмите Создать ключ.

    4. Выберите тип ключа и нажмите Создать

      Файл будет скачан.

  2. Добавьте FCM к серверу ADP:

    1. Импортируйте файл JSON на сервер ADP с помощью команды /bw/install.

    2. Войдите в CLI ADP и добавьте «Проект» и «Ключ API»:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :

    3. Затем добавьте приложение и ключ:

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done

    4. Подтвердите конфигурацию:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g
Project ID Accountkey
========================
connect-ucaas ********

ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas
Была ли статья полезной?
Была ли статья полезной?
ЦеныПриложение WebexСовещанияCallingСообщенияСовместный доступ к экрану
Webex SuiteCallingСовещанияСообщенияSlidoВебинарыEventsКонтакт-центрCPaaSБезопасностьControl Hub
гарнитурыКамерыСерия DeskСерия RoomСерия BoardСерия PhoneПринадлежности
ОбразованиеЗдравоохранениеГосударственный сектор"Финансы";Спорт и шоу-бизнесРабота с клиентамиНекоммерческие организацииСтартапыРабота в гибридном режиме
СкачиванияПрисоединиться к тестовому совещаниюОнлайн-урокиИнтеграцииСпециальные возможностиИнклюзивностьВебинары в режиме реального времени и по запросуСообщество WebexРазработчики WebexНовости и инновации
CiscoОбратиться в службу поддержкиСвязаться с отделом продажWebex BlogНоваторские идеи WebexМагазин брендированной продукции WebexВакансии
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Условия и положенияЗаявление о конфиденциальностиФайлы cookieТоварные знаки
©2026 Cisco и/или филиалы компании. Все права защищены.
Условия и положенияЗаявление о конфиденциальностиФайлы cookieТоварные знаки