В тази статия
Преглед на NPS прокси за удостоверяване
dropdown icon
Предпоставки за NPS прокси удостоверяване
    Минимални версии и ограничения за съвместно пребиваване
    Споделени NPS
    АПН HTTP/2
    Андроид FCMv1
Резюме на миграцията на NPS прокси
Мигрирайте приложенията за iOS на BroadWorks за сътрудничество в HTTP/2
Мигрирайте BroadWorks UC-One Connect/SaaS приложения за Android към FCMv1
Мигрирайте BroadWorks UC-One Connect/SaaS приложения за Android към FCMv1 (на ADP)
Повторно активирайте FCM Наследния режим
dropdown icon
Инсталирайте NPS прокси корекции за удостоверяване
    R22 лепенки
    R23 лепенки
Конфигурирайте NPS за използване на прокси за удостоверяване
Рестартирайте NPS и тествайте Push известия
Актуализирайте Cisco BroadWorks NPS, за да използвате NPS прокси: Ръководство за конфигуриране
list-menuВ тази статия
list-menuОбратна връзка?

Научете как да актуализирате Cisco BroadWorks NPS, за да използвате NPS Proxy с това ръководство за конфигуриране. Открийте инструкции стъпка по стъпка, съображения и най-добри практики за безпроблемна интеграция и подобрена производителност на мрежата.

Преглед на NPS прокси за удостоверяване

Тази статия описва как да конфигурирате споделен NPS да използва NPS прокси сървъри за удостоверяване, така че да може да се използва и за изпращане на известия за повиквания към приложения на Webex. Ако вашият NPS не поддържа други приложения, можете да следвате опростената процедура в ръководството за решения на Webex за BroadWorks.

Преглед на NPS прокси

За съвместимост с Webex за BroadWorks, вашият NPS трябва да бъде коригиран, за да поддържа функцията NPS Proxy, P ush Server за VoIP в UCaaS.

Функцията внедрява нов дизайн в Notification Push Server, за да разреши уязвимостта в сигурността при споделянето на лични ключове на сертификата за push уведомяване с доставчици на услуги за мобилни клиенти. Вместо да споделя сертификати и ключове за push уведомяване с доставчика на услуги, NPS използва нов API, за да получи краткотраен токен за push уведомяване от backend на UCAAS и използва този токен за удостоверяване с APN на Apple и услугите на Google FCM.

Функцията също така подобрява способността на Notification Push Server да изпраща известия към устройства с Android чрез новия Google Firebase Cloud Messaging API (FCM) HTTPv1.

Предпоставки за NPS прокси удостоверяване

XSP (или платформата за доставка на приложения ADP), която хоства 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.

Споделени NPS

Прочетете тези бележки, преди да конфигурирате споделения NPS да използва NPS прокси сървъра:

  • Ако вашият NPS се използва с други приложения (не само с приложението Webex): Първо конфигури райте NPS прокси сървъра, след това променете NPS от използване на наследения API на FCM към използване на FCM HTTP v1 API.

  • След като проверите дали известията работят правилно за по-стари приложения с NPS прокси сървъра, премахнете клавиша FCM API за приложението за Android и клавиша за автоматизация на APN за приложението iOS.

АПН HTTP/2

  • Ако сте внедрили приложения за iOS, които не са от CISCO/BroadSoft, конфигурирайте тези приложения да използват протокола HTTP/2 APNS, преди да конфигурирате NPS да използва NPS прокси сървъра.

  • XSP/ADP, които вече поддържат приложението Collaborate или SaaS BroadWorks, трябва да бъдат мигрирани към HTTP/2. За подробна информация относно конфигурирането на HTTP/2 вижте HTTP/2 поддръжка на Notification Push Server за APNS (мигрирането на NPS за поддръжка на тези приложения за iOS е обобщено в тази статия).

Андроид FCMv1

  • Ако сте внедрили приложения за Android, които не са от CISCO/BroadSoft, конфигурирайте тези приложения да използват клавишите FCMv1, преди да конфигурирате NPS да използва NPS прокси сървъра.

  • Ако XSP/ADP в момента поддържа приложението Connect или UC-One SaaS, активирайте клавишите FCMv1, след като конфигурирате NPS прокси сървъра. Препоръчваме ви да мигрирате всички допълнителни приложения към клавишите FCMv1, да активирате и тествате, след което да деактивирате, докато не сте готови да изпълните инструкциите за настройка (потокът на миграция е документиран в тази статия).

Резюме на миграцията на NPS прокси

Визуално обобщение на миграцията към NPS прокси сървър за
Таблица 1. Обобщение на задачите за мигриране към NPS прокси

Последователност

Заглавие на задачата

Кога и защо се изисква задачата?

1

Мигрирайте NPS към HTTP/2 за UC-One SaaS (или Connect) приложения за iOS.

Ако NPS поддържа тези приложения и те все още не са конфигурирани за HTTP/2.

2

Мигрирайте NPS към FCMv1 за UC-One SaaS (или Connect) приложения за Android.

Ако NPS поддържа тези приложения и те все още не са конфигурирани за FCMv1.

3

Активирайте режим FCMv1 и тествайте push известия.

Ако NPS поддържа UC-One Connect и/или други (не-Cisco) приложения за Android.

4

Активирайте отново наследения режим на FCM.

Ако NPS поддържа UC-One SaaS. Ако оставите FCMv1 активиран, преди да конфигурирате NPS прокси сървъра, след това push известията до UC-One SaaS започват да се провалят.

5

Инсталирайте NPS прокси корекции за удостоверяване.

Ако NPS е на XSP R22 или XSP R23.

6

Конфигурирайте NPS да използва прокси сървъра за удостоверяване на NPS:

  • Прикачете техническа поддръжка от NPS

  • Заявете CI OAuth акаунт

  • Създайте CI акаунт в NPS и конфигурирайте времето за опресняване на токена

  • Добавете идентификатори на приложения за Android

  • Добавете идентификатори на приложения за iOS

  • Проверене/задайте URL адреси и времеви прекъсвания на връзката

  • Добавяне на приложения към списъка с разрешаване на AS

  • (Повторно) Активиране на FCMv1

  • Рестартирайте XSP/ADP

  • Тествайте PNs за приложения за iOS и Android

Винаги се изисква.

7

Премахнете клавишите за наследен режим на FCM.

За приложения, които успешно се поддържат от NPS на FCMv1.

Мигрирайте приложенията за iOS на BroadWorks за сътрудничество в HTTP/2

Тази задача е задължителна за push известия към приложенията UC-One SaaS и Webex на iOS платформи.

Преди да започнете

Ако вашият XSP работи с R22, трябва да приложите ap354313, преди да можете да конфигурирате приложението NPS да използва HTTP/2 за APNS.

1

Задайте производствения URL адрес и параметрите на връзката на X SP_CLI/Приложения/NotificationPushServer/APNS/Production>

зададете URL адрес https://api.push.apple.com/3/device

Комплект свързванеБасейнРазмер 2

комплект свързванеТайм аут 3000

задайте свързванеБезжично времеОтрайнсекунди 600

Забележка: Не задавайте времето за свързване под 1000.

2

Добавете идентификаторите на приложения към контекста на приложенията на APNS, като не забравяйте да пропуснете клавиша Auth - задайте го на празен.

За UC-One SaaS: X SP_CLI/Приложения/НотификацияPUSHSERVER/APNS/Производство/Токени> добавете com.broadsoft.uc-one

За приложението Webex: X SP_CLI/Приложения/ИзвестияPushServer/APNS/Производство/Токени> добавете com.cisco.squared

3

Проверете клавишите за автентизация с XSP_CLI/Приложения/NotificationPushServer/APNS/Производство/Токени> получете

4

Ако клавишът за автентизация не е празен за com.broadsoft.uc-one, можете да го изчистите с XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> изчистете ключа за автентизация

5

Активиране на HTTP/2:

XSP_CLI /Приложения/ИзвестияPushServer/APNS/Общи настройки> задайте HTTP2Acabled true

6

Само за UC-One SaaS приложения: Влезте в портала за дистрибутори и отидете на Конфигурация > BroadWor ks >.

7

Превъртете надолу до секцията Notification Push Server и изберете вашата версия (например версия 22), след което следвайте инструкциите, предоставени в портала.

Мигрирайте BroadWorks UC-One Connect/SaaS приложения за Android към FCMv1

  • Тази задача се отнася за NPS на XSP. Игнорирайте го, ако вашият NPS е на ADP.

  • Можете да използвате тази процедура за мигриране към известия FCMv1 за приложения за Android UC-One Connect или UC-One SaaS.

  • Трябва да използвате FCMv1, ако искате да използвате NPS прокси сървъра за удостоверяване на push известия към UC-One или Webex Android приложенията.

  • Тази задача подготвя NPS за FCMv1, така че да можете да го активирате като част от конфигурацията на NPS прокси сървъра за удостоверяване. Не активирайте FCMv1, докато не сте готови да конфигурирате NPS прокси за удостоверяване, или известията до клиенти на SaaS ще се провалят.

1

Вземете идентификатора на проекта от конзолата Firebase:

  1. Влезте в console.firebase.google.com.

  2. Изберете проекта за приложение UC-One (Connect или SaaS), отворете настройките на проекта му.

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

2

Вземете личния ключ на вашия акаунт за услуги от Firebase:

  1. Придвижете се до раздела Сервизни акаунти в настройките на проекта.

  2. Или създайте нов акаунт за услуга и вземете личния му ключ.

  3. Или отворете съществуващ акаунт за услуга и генерирайте нов частен ключ за него.

    Забележка: Про филът на услугата трябва да има разрешението firebaseadmin -sdk.

  4. Изтеглете ключа към сигурно място.

3

Копирайте ключа към XSP хостинг на вашия NPS.

4

Добавете идентификатора на проекта и свързания частен ключ към контекста на проектите на FCM:

XSP_CLI /Приложения/ИзвестияPushServer/FCM/Проекти> добавяне на пътек-идентификатор на проекта/до/ключов файл

5

Добавете приложението UC-One (Connect или SaaS) и свързания идентификатор на проекта към контекста на приложенията на FCM:

XSP_CLI/Приложения/ИзвестияPushServer/FCM/Приложения> добавяне на Applic ationID com.broadsoft.connect ProjectID project-id

6

Проверете конфигурацията за FCM спрямо атрибутите и препоръчителните стойности, показани тук. Използвайте зада дена версия на командата, за да промените стойностите, ако е необходимо:

Стартирайте XSP _CLI/Приложения/ИзвестияPushServer/FCM> получаване

параметър

Препоръчителна стойност

Авторски URL

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

Пушурл

https://fcm.googleapis.com/v1/projects/ ИДЕНТИФИКАЦИОНЕН НОМЕР НА ПРОЕКТА /съобщения:изпрати

обхват

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

ТокентиМетоливинСекунди

3600

ВръзкаРазмер на басейна

10

Време за свързванеПолисекунди

3000

СвързванеБезходно времеОтрайноСекунди

600

Мигрирайте BroadWorks UC-One Connect/SaaS приложения за Android към FCMv1 (на ADP)

  • Тази задача се отнася за NPS на ADP. Игнорирайте го, ако вашият NPS е на XSP.

  • Можете да използвате тази процедура за мигриране към известия FCMv1 за приложения за Android UC-One Connect или UC-One SaaS.

  • Трябва да използвате FCMv1, ако искате да използвате NPS прокси сървъра за удостоверяване на push известия към UC-One или Webex Android приложенията.

  • Тази задача подготвя NPS за FCMv1, така че да можете да го активирате като част от конфигурацията на NPS прокси сървъра за удостоверяване. Не активирайте FCMv1, докато не сте готови да конфигурирате NPS прокси за удостоверяване, или известията до клиенти на SaaS ще се провалят.

1

Вземете идентификатора на проекта от конзолата Firebase:

  1. Влезте в console.firebase.google.com.

  2. Изберете проекта за приложение UC-One (Connect или SaaS), отворете настройките на проекта му.

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

2

Вземете личния ключ на вашия акаунт за услуги от Firebase:

  1. Придвижете се до раздела Сервизни акаунти в настройките на проекта.

  2. Или създайте нов акаунт за услуга и вземете личния му ключ.

  3. Или отворете съществуващ акаунт за услуга и генерирайте нов частен ключ за него.

    Забележка: Про филът на услугата трябва да има разрешението firebaseadmin -sdk.

  4. Изтеглете ключа (.json файл) на сигурно място.

3

Импортиране.json файла в ADP сървъра /bw/install.

4

Влезте в ADP CLI и добавете ключа на проекта и API към контекста на проектите на FCM:

ADP_CLI/Приложения/ИзвестияPushServer/FCM/Проекти> добавяне на connect-ucaas /bw/install/ име на файла. json

5

Добавете идентификатора на приложението и проекта към контекста на приложенията на FCM:

ADP_CLI/Приложения/ИзвестияPushServer/FCM/Приложения> добавяне на идентификатор на приложението com.broadsoft.ucaas.connect ProjectID project-id

6

Проверете конфигурацията си:

ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get
Project ID Accountkey
========================
connect-ucaas ********
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas

Повторно активирайте FCM Наследния режим

Трябва да направите това (като част от миграцията) само ако:

  • Вашият NPS се използва за приложения за Android UC-One SaaS или BroadWorks Connect.

  • Вече сте тествали, че известията за повиквания към други приложения работят с FCmv1 API.

Временно деактивирате FCMv1, тъй като клавишите FCMv1 за тези приложения трябва да бъдат активирани само по време на процеса на конфигуриране на прокси сървъра за удостоверяване на NPS.

1

Влезте в XSP хостинг на вашия споделен NPS.

2

Придвижете се до контекста на FCM и деактивирайте FCM v1: XSP_CLI/Applications/NotificationPushServer/ FCM> задайте V1enabled false, за да се върнете към използването на наследения API ключ на FCM.

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

Конфигурирайте NPS за използване на прокси за удостоверяване

1

Създайте заявка за услуга с вашия контакт за внедряване или с TAC, за да предоставите вашия клиентски акаунт (Webex Common Identity) OAuth. Заглави заявката си за услуга Кон фигурация на NPS за настройка на Auth Proxy.

Даваме ви идентификационен номер на клиента OAuth, клиентска тайна и токен за опресняване, който е валиден за 60 дни. Ако токенът изтече, преди да го използвате с вашия NPS, можете да подадете друга заявка.
2

Създайте клиентски акаунт в NPS:

XSP_CLI/Приложения/ИзвестияPushServer/CISCOCI/клиент> задаване на клиентски идентификатор от-стъпка1

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

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

Изпълнете командата, за да проверите дали въведените от вас стойности съответстват на предоставените ви стойности. XSP_CLI/Приложения/ИзвестияPushServer/CISCOCI/клиент> получаване

3

Въведете URL адреса на NPS Proxy и задайте интервала за опресняване на токена (препоръчва се 30 минути):

Регионално базирани FqDNS:

Изток на САЩ:

XSP_CLI /Приложения/ИзвестияPushServer/CloudnpsService> задайте URL адрес https://broadworks-idp-proxy-a.wbx2.com/nps/

Запад на САЩ:

XSP_CLI /Приложения/ИзвестияPushServer/CloudnpsService> задайте URL адрес https://broadworks-idp-proxy-r.wbx2.com/nps/

Европа:

XSP_CLI /Приложения/ИзвестияPushServer/CloudnpsService> задайте URL адрес https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI /Приложения/ИзвестияPushServer/CloudnpsService> задайте VoipTokenRefreshInterval 1800

Саудитска Арабия:

XSP_CLI /Приложения/ИзвестияPushServer/CloudnpsService> задайте URL адрес https://broadworks-idp-proxy-d.wbx2.com/nps/

Австралия:

XSP_CLI /Приложения/ИзвестияPushServer/CloudnpsService> задайте URL адрес https://broadworks-idp-proxy-m.wbx2.com/nps/

Ако известията за push изтичат поради забавяне в резолюцията на DNS, увеличете стойността на таймаут във файла „/etc/resolv.conf“ на сървъра BroadWorks.

4

(За известия за Android) Добавете идентификаторите на приложения за Android към контекста на приложенията на FCM на NPS.

За приложението Webex на Android: XSP_CLI/Приложения/ИзвестияPushServer/FCM/Приложения> добавете com.cisco.wx2. android

За приложение UC-One на Android: X SP_CLI/Приложения/ИзвестияPushServer/FCM/Приложения> добавете com.broadsoft.connect

5

(За Apple iOS известия) Добавете идентификатора на приложението към контекста на приложенията на APNS, като не забравяйте да пропуснете клавиша Auth - задайте го на празен.

За приложението Webex на iOS: XSP_CLI/Приложения/ИзвестияPushServer/APNS/Производство/Токени> добавете com.cisco.squared

За приложение UC-One на iOS: XSP_CLI/Приложения/ИзвестияPushServer/APNS/Производство/Токени> добавете com.cisco.squared

6

Конфигурирайте следните URL адреси на NPS:

XSP CLI контекст

параметър

Стойност

XSP_CLI/Приложения/ИзвестияPushServer/FCM>

Авторски URL

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

Пушурл

https://fcm.googleapis.com/v1/projects//messages:send

обхват

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

XSP_CLI/Приложения/ИзвестияПушсървър/APNS/Производство>

URL адрес

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

7

Конфигурирайте следните параметри на NPS връзка с показаните препоръчителни стойности:

XSP CLI контекст

параметър

Стойност

XSP_CLI/Приложения/ИзвестияPushServer/FCM>

ТокентиМетоливинСекунди

3600

ВръзкаРазмер на басейна

10

Време за свързванеПолисекунди

3000

СвързванеБезходно времеОтрайноСекунди

600

XSP_CLI/Приложения/ИзвестияПушсървър/APNS/Производство>

СвързванеВреме за прекъсване

3000

ВръзкаРазмер на басейна

2

СвързванеБезходно времеОтрайноСекунди

600

8

Проверете дали сървърът за приложения проверява идентификаторите на приложения, защото може да се наложи да добавите Webex приложенията към списъка с разрешителни:

  1. Стартирайте AS_CLI/System/PushNotification> получете и проверете стойността на Executive AllowedApplicationList. Ако е вярно, трябва да изпълните тази подзадача. В противен случай пропуснете останалата част от подзадачата.

  2. AS_CLI/Система/Пушнотификация/Разрешени приложения> добавете com.cisco.wx2.android „Webex Android“

  3. AS_CLI/System/PushNoti fication/Разрешени приложения> добавете com.cisco.квадрат „Webex iOS“

Рестартирайте NPS и тествайте Push известия

1

Рестартирайте XSP:

старт
2

Тествайте известия за обаждания към Android, като осъществявате обаждания от абонат на BroadWorks към клиента за повикване на Android. Проверете дали известието за повикване се появява на устройството с Android.

Забележка: Ако push известия започнат да се провалят за приложението за Android UC-One, възможно е да има грешна конфигурация. Ако това е вашата ситуация, можете да се върнете към наследствения FCM, както следва:

  1. Деактивирайте FCMv1: XSP _CLI/Приложения/ИзвестияPushServer/FCM> зададете V1Разрешено невярно

  2. Рестартирайте XSP: стартирайте

  3. Проверете конфигурацията си.

  4. Активирайте отново FCMv1 и рестартирайте XSP.

  5. Повторете теста.

3

Тествайте известия за обаждания към iOS, като осъществявате обаждания от абонат на BroadWorks към клиента за повикване на iOS. Проверете дали известието за повикване се появява на устройството с iOS.

Забележка: Ако push известия започнат да се провалят за приложението UC-One iOS, възможно е да има грешна конфигурация. Ако това е вашата ситуация, можете да се върнете към наследения двоичен интерфейс със зададен HTTP2enabled false

Беше ли полезна тази статия?
Беше ли полезна тази статия?