Налаштування push-сповіщень про виклики для Webex BroadWorks

У цьому документі ми використовуємо термін Push-сервер сповіщень про виклики (CNPS) для опису програми, розміщеної на XSP або ADP, яка працює у вашому середовищі. Ваш CNPS працює з вашою системою BroadWorks, щоб знати про вхідні дзвінки вашим користувачам, і надсилає сповіщення про них до служб сповіщень Google Firebase Cloud Messaging (FCM) або служби push-сповіщень Apple (APNs).

Ці послуги сповіщають мобільні пристрої Webex для абонентів Cisco BroadWorks про те, що у них є вхідні дзвінки на Webex.

Для отримання додаткової інформації про NPS перегляньте описфункції push-сервера сповіщень.

Аналогічний механізм в Webex працює з службами обміну повідомленнями Webex і присутності для push-повідомлень в сервіси повідомлень Google (FCM) або Apple (APNS). Ці послуги, у свою чергу, сповіщають користувачів мобільного Webex про вхідні повідомлення або зміни присутності.

У цьому розділі описано, як налаштувати NPS для проксі-сервера автентифікації, якщо NPS ще не підтримує інші програми. Якщо вам потрібно перенести спільний NPS для використання проксі-сервера NPS, див . Оновлення Cisco BroadWorks NPS для використання проксі-сервера NPS.

Огляд проксі-сервера NPS

Для сумісності з Webex для Cisco BroadWorks ваш CNPS повинен бути виправлений для підтримки функції проксі-сервера NPS, Push Server for VoIP в UCaaS.

Ця функція реалізує новий дизайн у Push-сервері сповіщень для усунення вразливості безпеки спільного використання приватних ключів сертифіката push-сповіщення з постачальниками послуг для мобільних клієнтів. Замість того, щоб ділитися сертифікатами та ключами push-повідомлень з постачальником послуг, NPS використовує новий API для отримання короткоживучого токена push-повідомлень від Webex для бекенда Cisco BroadWorks, і використовує цей токен для аутентифікації за допомогою Apple APNs та сервісів Google FCM.

Ця функція також покращує можливості Push-сервера сповіщень для надсилання сповіщень на пристрої Android за допомогою нового API HTTPv1 для хмарних повідомлень Google Firebase (FCM).

Для отримання додаткової інформації дивіться Push-сервер для VoIP в описіфункцій UCaaS.
Патчі BroadWorks для цієї функції доступні на: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.

Інформацію про програмне забезпечення та виправлення NPS див. у розділі Підготовка NPS до роботи з Webex для Cisco BroadWorks.

Знайдіть та завантажте патч зі сторінки завантаження програмного забезпечення.
Більше інформації про ADP-сервер можна знайти на Cisco BroadWorks Application Delivery Platform.

Міркування щодо APNS

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

Підготуйте свій NPS для Webex для Cisco BroadWorks

1	Встановіть і налаштуйте виділену XSP (мінімальна версія R22) або платформу доставки додатків (ADP).
2	Встановіть патчі проксі-сервера аутентифікації NPS: Патчі XSP R22: AP.xsp.22.0.1123.ap369607 AP.platform.22.0.1123.ap369607 AP.xsp.22.0.1123.ap374677 AP.xsp.22.0.1123.ap375206 AP.xsp.22.0.1123.ap354313 AP.platform.22.0.1123.ap354313 Патчі XSP R23: AP.xsp.23.0.1075.ap369607 AP.platform.23.0.1075.ap369607 AP.xsp.23.0.1075.ap374677 AP.xsp.23.0.1075.ap375206
3	Активуйте додаток Push Server повідомлень.
4	(Для повідомлень Android) Увімкніть API FCM v1 на 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 для сервера push-повідомлень. (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 Після налаштування для застосування змін потрібно виконати одну з наступних дій: Перезапуск bw має бути виконаний у вікні технічного обслуговування. Через інтерфейс командного рядка 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.

Отримання облікових даних OAuth для вашого Webex для Cisco BroadWorks.

Створіть обліковий запис клієнта на 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

Введіть 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.

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

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

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

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

Налаштуйте наступні URL-адреси NPS:

XSP\|Контекст командного рядка ADP	Параметр	Значення
`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`

Налаштуйте наступні параметри підключення NPS до показаних рекомендованих значень:

XSP\|Контекст командного рядка ADP	Параметр	Значення
`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

Перевірте, чи сервер програм перевіряє ідентифікатори програм, оскільки вам може знадобитися додати програми Webex до списку дозволених:

Запустіть AS_CLI/System/PushNotification> get та перевірте значення enforceAllowedApplicationList. Якщо це true, вам потрібно виконати це підзавдання. В іншому випадку пропустіть решту підзавдання.
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”
AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

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

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

Міграція NPS на FCMv1

Цей розділ містить додаткові процедури, які можна використовувати в Google FCM Console, якщо у вас є наявне розгортання NPS, яке потрібно перенести на FCMv1. Існує три процедури:

Міграція клієнтів UC-One до FCMv1— Якщо у вас є клієнти UCaaS, і вам потрібно перенести їх для використання FCMv1.
Міграція SaaS-клієнтів до FCMv1— Якщо у вас є SaaS-клієнти, і вам потрібно перенести їх для використання FCMv1.
Оновити ADP-сервер— під час міграції NPS на ADP-сервер.

Міграція клієнтів UC-One до FCMv1

Виконайте наведені нижче дії в Консолі Google FCM, щоб перенести клієнти UC-One до Google FCM HTTPv1.

Якщо до клієнта застосовується брендинг, клієнт повинен мати ідентифікатор відправника. У консолі FCM дивіться Налаштування проекту > Хмарні повідомлення. Ця настройка відображається в таблиці облікових даних Project.

Докладніше див. Посібник із брендингу 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.xml, папці Resource, у Branding Kit, з наведеним нижче синтаксисом:

xxxxxxxxxxxxx

Увійдіть в FCM Admin SDK за адресою http://console.firebase.google.com.
Виберіть відповідний додаток для Android.
На вкладці Загальні запишіть ідентифікатор проекту
Перейдіть на вкладку Облікові записи служб, щоб настроїти обліковий запис служби. Можна створити новий обліковий запис служби або настроїти наявний.

Щоб створити новий обліковий запис служби:
1. Натисніть синю кнопку для створення нового облікового запису служби
2. Натисніть на синю кнопку, щоб згенерувати новий приватний ключ
3. Ключ завантаження в безпечне місце
Щоб повторно використати наявний обліковий запис служби, виконайте такі дії:
1. Натисніть на синій текст, щоб переглянути існуючі облікові записи служби.
2. Ідентифікуйте обліковий запис служби, яким потрібно користуватися. Службовий обліковий запис потребує дозволу пожежної базиadmin-sdk.
3. У самому правому куті натисніть меню гамбургера і створіть новий закритий ключ.
4. Завантажте файл json, який містить ключ, і збережіть у безпечному місці.
Скопіюйте JSON-файл на XSP|ADP.
Настроювання ідентифікатора проекту та:
```
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
```

Налаштування програми:

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

Увімкнути FCMv1:

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

Виконайте команду bwrestart, щоб перезапустити XSP|ADP.

Міграція Клієнтів SaaS до FCMv1

Використовуйте наведені нижче кроки на консолі Google FCM, якщо ви хочете перенести клієнти SaaS на FCMv1.

Переконайтеся, що ви вже пройшли процедуру "Налаштувати NPS на використання проксі аутентифікації".

Відключити ПВМ:

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

Виконайте команду bwrestart, щоб перезапустити XSP|ADP.

Увімкнути ПВМ:

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

Виконайте команду bwrestart, щоб перезапустити XSP|ADP.

Оновлення СЕРВЕРА ADP

Виконайте наведені нижче дії в Консолі FCM Google, якщо ви переносите NPS, щоб використовувати сервер ADP.

Отримайте файл JSON з хмарної консолі Google:
1. На google Cloud Console перейдіть на сторінку Облікові записи служб.
2. Виберіть проект, виберіть свій проект і натисніть кнопку Відкрити.
3. Знайдіть рядок облікового запису служби, для якого потрібно створити ключ, натисніть вертикальну кнопку «Більше», а потім натисніть «Створити ключ».
4. Виберіть тип ключата натисніть кнопку Створити
  
  Файл завантажується.
Додайте FCM до сервера ADP:
1. Імпортуйте JSON-файл на ADP-сервер за допомогою команди /bw/install.
2. Увійдіть до ADP CLI та додайте ключ проекту та 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
```

Cisco AI Assistant

Дякуємо за відгук.

Налаштування push-сповіщень про виклики для Webex BroadWorks

Огляд проксі-сервера NPS

Міркування щодо APNS

Підготуйте свій NPS для Webex для Cisco BroadWorks

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

Міграція NPS на FCMv1

Міграція клієнтів UC-One до FCMv1

Міграція Клієнтів SaaS до FCMv1

Оновлення СЕРВЕРА ADP

Малий бізнес

Enterprise

Пристрої

Рішення для

Ресурси

Компанія