Актуализиране на Cisco BroadWorks NPS за използване на NPS прокси: Ръководство за конфигурация
В тази статия се описва как да конфигурирате споделен NPS да използва nPS прокси сървър за удостоверяване, така че да може да се използва и за натискане на известия за обаждания към приложения на Webex. Ако вашият NPS не поддържа други приложения, можете да следвате опростената процедура в Ръководството за решение Webex for BroadWorks.
Общ преглед на NPS прокси
За съвместимост с Webex за BroadWorks вашата NPS трябва да бъде закърпена, за да поддържа функцията NPS прокси сървър, Push Server за VoIP в UCaaS.
Функцията внедрява нов дизайн в Известяване Push Server за разрешаване на уязвимостта на защитата на споделяне push уведомление сертификат частни ключове с доставчици на услуги за мобилни клиенти. Вместо да споделя сертификати и ключове за push известия с доставчика на услуги, NPS използва нов API, за да получи краткотраен токен за push известия от UCaaS backend-а и използва този токен за удостоверяване с Apple APNs и Google FCM услугите.
Функцията също така повишава възможността на Сървъра за натискане на известията да прокара известия до устройства с Android чрез новия API на Google Firebase Cloud Съобщения (FCM) HTTPv1.
-
За повече информация вижте push сървър за VoIP в UCaaS описание на функциите.
-
Пачовете на BroadWorks за функцията са достъпни на: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
-
Повече информация за ADP сървъра можете да намерите на Cisco BroadWorks Application Delivery Platform.
ADP на XSP (или Платформа за доставка на приложения), който е домакин на NPS, трябва да отговаря на следните изисквания:
Минимални версии и Ограничения за съвместно пребиваване
-
NPS трябва да се активира на специализиран XSP/ADP и NPS трябва да бъде единственото хоствано приложение на сървъра. Това е, за да се премахнат смущенията в доставката на известията push.
-
Трябва да има само едно NPS приложение в разполагане. Ако използвате мобилни UC-One Collaborate/Connect и или UC-One SaaS, и внедрявате Webex за BroadWorks, трябва да споделите този единствен NPS за всички приложения.
-
NPS трябва да бъде на версия R22 или по-нова XSP, или ADP.
R22/R23 XSP е съвместим с R21 стека, ако XSP работи само NPS и AS е R21. SP1. Вижте матрицата за съвместимост на BroadWorks за повече информация.
-
Повече информация за ADP сървъра можете да намерите на Cisco BroadWorks Application Delivery Platform.
Споделена НПС
Прочетете тези бележки, преди да конфигурирате вашия споделен NPS да използва NPS прокси:
-
Ако вашият NPS се използва с други приложения (не само с приложението Webex): Първо конфигурирайте NPS прокси, след това променете NPS от използването на FCM наследство API да използвате FCM HTTP v1 API.
-
След като сте проверили, че известията работят правилно за по-стари приложения с NPS прокси, премахнете FCM API ключа за приложението за Android и APNs auth key за приложението за iOS.
APNs HTTP/2
-
Ако сте внедрили iOS приложения, които не са от Cisco/BroadSoft, конфигурирайте тези приложения да използват HTTP/2 APNS протокол, преди да конфигурирате NPS да използва NPS прокси.
-
XSP/ADPs, които вече поддържат приложението Collaborate или SaaS BroadWorks, трябва да бъдат мигрирани към HTTP/2. За подробна информация относно конфигурирането на HTTP/2 вижте HTTP/2 поддръжка на уведомяване push server за APNS (миграция на NPS за поддръжка на тези приложения iOS е обобщено в тази статия).
Андроид FCMv1
-
Ако сте внедрили приложения за Android, които не са от Cisco/BroadSoft, Конфигурирайте тези приложения да използват FCMv1 ключовете, преди да конфигурирате NPS да използва NPS прокси.
-
Ако XSP/ADP в момента поддържа приложението Connect или UC-One SaaS, след това активирайте FCMv1 ключове след конфигуриране на NPS прокси. Препоръчваме ви да мигрирате всички допълнителни приложения към FCMv1 ключове, да ги активирате и тествате, след което да ги деактивирате, докато не сте готови да изпълните инструкциите за настройка (процесът на миграция е документиран в тази статия).

Последователност |
Заглавие на задача |
Кога/Защо се изисква задача? |
---|---|---|
1 |
Мигриране на NPS към HTTP/2 за UC-One SaaS (или Свързване) iOS приложения. |
Ако NPS поддържа тези приложения и те все още не са конфигурирани за HTTP/2. |
2 |
Мигрирайте NPS към FCMv1 за UC-One SaaS (или Свържете) приложения за Android. |
Ако NPS поддържа тези приложения, и те все още не са конфигурирани за FCMv1. |
3 |
Разрешаване на режим FCMv1 и известия за пробно натискане. |
Ако NPS поддържа UC-One Свързване и/или други (не-Cisco) Android приложения. |
4 |
Повторно разрешаване на режим Наследени FCM. |
Ако NPS поддържа UC-One SaaS. Ако оставите FCMv1 разрешен, преди да конфигурирате NPS прокси, след това натиснете известия към UC-One SaaS започват да са неуспешни. |
5 |
Инсталирайте NPS прокси кръпки за удостоверяване. |
Ако NPS е на XSP R22 или XSP R23. |
6 |
Конфигуриране на NPS да използва nPS удостоверяване прокси:
|
Винаги се изисква. |
7 |
Премахване на клавишите за наследен режим на FCM. |
За приложения, които се поддържат успешно от NPS на FCMv1. |
Тази задача е задължителна за push известия до UC-One SaaS и Webex приложения на iOS платформи.
Преди да започнете
Ако вашият XSP работи R22, трябва да приложите ap354313, преди да можете да конфигурирате NPS приложението да използва HTTP/2 за APNS.
1 |
Задаване на производствения URL адрес и параметрите на връзката при
Забележка: Не задавайте времето за изчакване на връзката под 1000. |
2 |
Добавете идентификаторите на приложението в контекста на APNS приложенията, като се уверите, че пропускате ключа Auth – задайте го да се изпразни. За UC-One SaaS: За webex приложение: |
3 |
Проверете клавишите auth с |
4 |
Ако ключът за оторизация не е празен за |
5 |
Разрешаване на HTTP/2:
|
6 |
Само за UC-One SaaS приложения: Влезте в портала за дистрибутори и отидете на |
7 |
Превъртете надолу до секцията „Сървър за известия“ и изберете вашата версия (напр. Версия 22), след което следвайте инструкциите, предоставени в портала. |
-
Тази задача се отнася за NPS на XSP. Игнорирайте го, ако вашият NPS е на ADP.
-
Можете да използвате тази процедура за мигриране към FCMv1 известия за UC-One Connect или UC-One SaaS Android приложения.
-
Трябва да използвате FCMv1, ако искате да използвате NPS прокси за удостоверяване на известия за натискане на UC-One или приложенията на Webex Android.
-
Тази задача подготвя NPS за FCMv1, така че да можете да го разрешите като част от конфигурацията на NPS удостоверяване прокси. Не разрешавайте FCMv1, докато не сте готови да конфигурирате NPS прокси за удостоверяване, или известията до SaaS клиенти ще са неуспешни.
1 |
Получете ИД на проекта от конзолата на Firebase: | ||||||||||||||||
2 |
Получете личния ключ на сервизния си акаунт от Firebase: | ||||||||||||||||
3 |
Копирайте ключа в XSP хостинг вашия NPS. | ||||||||||||||||
4 |
Добавете ИД на проекта и свързания частен ключ към контекста на проектите на FCM:
| ||||||||||||||||
5 |
Добавете приложението UC-One (Свързване или SaaS) и свързан ид на проект в контекста на Приложенията на FCM:
| ||||||||||||||||
6 |
Проверете конфигурацията за FCM спрямо атрибутите и препоръчителните стойности, показани тук. Използвайте Изпълни
|
-
Тази задача се отнася за NPS на ADP. Игнорирайте го, ако вашият NPS е на XSP.
-
Можете да използвате тази процедура за мигриране към FCMv1 известия за UC-One Connect или UC-One SaaS Android приложения.
-
Трябва да използвате FCMv1, ако искате да използвате NPS прокси за удостоверяване на известия за натискане на UC-One или приложенията на Webex Android.
-
Тази задача подготвя NPS за FCMv1, така че да можете да го разрешите като част от конфигурацията на NPS удостоверяване прокси. Не разрешавайте FCMv1, докато не сте готови да конфигурирате NPS прокси за удостоверяване, или известията до SaaS клиенти ще са неуспешни.
1 |
Получете ИД на проекта от конзолата на Firebase: |
2 |
Получете личния ключ на сервизния си акаунт от Firebase: |
3 |
Импортирайте .json файла на ADP сървъра |
4 |
Вход в ADP CLI и добавете проекта и API ключ към контекста на проектите на FCM:
|
5 |
Добавете приложението и ИД на проекта в контекста на приложенията на FCM:
|
6 |
Проверете конфигурацията си: |
Трябва да направите това (като част от миграцията), само ако:
-
Вашият NPS се използва за приложения за UC-One SaaS или BroadWorks Connect Android.
-
Вече тествахте, че известията за натискане на обажданията до други приложения работят с FCMv1 API.
Временно забранявате FCMv1, защото FCMv1 ключове за тези приложения трябва да са активирани само по време на процеса на конфигуриране на прокси сървъра за удостоверяване на NPS.
1 |
Влезте в XSP хостинг на вашия споделен NPS. |
2 |
Навигирайте до контекста на FCM и деактивирайте FCM v1: |
Инсталирайте следните лепенки, за да поддържате nPS удостоверяване прокси функцията:
R22 Лепенки
R23 Лепенки
1 |
Създайте заявка за услуга с вашия бордови контакт, или с ТАС, за да осигурите вашия (Webex Обща самоличност) OAuth клиентски акаунт. Заглавие на вашата заявка за услуга NPS конфигурация за Настройкана прокси сървъра на Auth. Предоставяме ви OAuth клиентски идентификатор, клиентска тайна и токен за опресняване, валиден 60 дни. Ако маркерът изтече, преди да го използвате с вашия NPS, можете да повдигнете друга заявка.
| |||||||||||||||||||
2 |
Създаване на клиентския акаунт на NPS:
Изпълнете командата, за да проверите дали въведените от вас стойности съвпадат с предоставените ви. | |||||||||||||||||||
3 |
Въведете NPS Прокси URL адреса и задайте интервала за обновяване на маркера (препоръчват се 30 минути):
За да подобрите скоростта на преобразуване на DNS, вместо текущото FQDN име nps.uc-one.broadsoft.com, ви препоръчваме да използвате подходящото FQDN име, базирано на вашия регион. Регионално базирани FQDN имена: САЩ Изток: Западна част на САЩ:
Европа:
Ако времето за изчакване на push известията изтече поради забавяне в разрешаването на DNS, увеличете стойността на времето за изчакване в "/etc/resolv.conf" файл на сървъра BroadWorks. | |||||||||||||||||||
4 |
(За известия за Android) Добавете Идентификаторите на приложенията за Android към контекста на приложенията на FCM на NPS. За приложението Webex на Android: За приложението UC-One на Android: | |||||||||||||||||||
5 |
(За известия на Apple iOS) Добавете ИД на приложението в контекста на приложенията APNS, като се уверите, че пропускате ключа Auth – задайте го да се изпразни. За приложението Webex на iOS: За приложение UC-One на iOS: | |||||||||||||||||||
6 |
Конфигуриране на следните NPS URL адреси:
| |||||||||||||||||||
7 |
Конфигурирайте следните параметри на NPS връзка към показаните препоръчителни стойности:
| |||||||||||||||||||
8 |
Проверете дали Сървърът за приложения скрининг приложение Идентификатори, защото може да се наложи да добавите приложенията webex към списъка с разрешения: |
1 |
Рестартирайте XSP: bwrestart |
2 |
Тествайте известията за обаждания до Android, като провеждате обаждания от абонат на BroadWorks до повикващия клиент на Android. Проверете дали известието за повикване се появява на устройството с Android. Забележка: Ако push известията започнат да се провалят за приложението за Android UC-One, възможно е да има погрешна конфигурация. Ако това е вашата ситуация, можете да се обърнете към наследството FCM, както следва:
|
3 |
Тествайте известията за обаждания до iOS, като провеждате обаждания от абонат на BroadWorks до повикващия клиент на iOS. Проверете дали известието за повикване се появява на iOS устройството. Забележка: Ако push известията започнат да са неуспешни за UC-One iOS приложението, е възможно да има погрешна конфигурация. Ако това е вашата ситуация, можете да се обърнете към наследен двоичен интерфейс с |