Конфигуриране на push известия за обаждания за Webex BroadWorks
В този документ използваме термина Call Notifications Push Server (CNPS), за да опишем хоствано с XSP или aDP хоствано приложение, което се изпълнява във вашата среда. Вашият CNPS работи с вашата система BroadWorks, за да е наясно с входящите обаждания към потребителите ви, и избутва известия за тези към услугите за уведомяване на Google Firebase Cloud Messaging (FCM) или apple Push Notification service (APNs).
Тези услуги уведомяват мобилните устройства на Webex за абонатите на Cisco BroadWorks, че имат входящи повиквания в Webex.
За повече информация относно NPS вижте известие push сървър функция описание.
Подобен механизъм в Webex работи с услугите за съобщения и присъствие на Webex, за да прокара известия до услугите за уведомяване на Google (FCM) или Apple (APNS). Тези услуги от своя страна уведомяват потребителите на mobile Webex за входящи съобщения или промени в присъствието.
Този раздел описва как да конфигурирате NPS за прокси за удостоверяване, когато NPS не поддържа други приложения. Ако трябва да мигрирате споделен NPS, за да използвате NPS прокси, вижте Актуализиране на Cisco BroadWorks NPS за използване на NPS прокси.
Общ преглед на NPS прокси
За съвместимост с Webex за Cisco BroadWorks вашият CNPS трябва да бъде закърпена, за да поддържа функцията NPS прокси сървър, Push Server за VoIP в UCaaS.
Функцията внедрява нов дизайн в Известяване Push Server за разрешаване на уязвимостта на защитата на споделяне push уведомление сертификат частни ключове с доставчици на услуги за мобилни клиенти. Вместо да споделя сертификати за push известия и ключове с доставчика на услуги, NPS използва нов API, за да получи краткотраен маркер за известия за натискане от Webex за Cisco BroadWorks 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.
За софтуера и корекциите за NPS вижте раздела Подготовка на вашия NPS за Webex за Cisco BroadWorks.
Търсете и изтеглете корекцията от страницата за изтегляне на софтуер.
-
Повече информация за ADP сървъра можете да намерите на Cisco BroadWorks Application Delivery Platform.
APNS Съображения
Apple вече няма да поддържа базирания на HTTP/1 двоичен протокол на услугата Apple Push Notification след 31 март 2021 г. Препоръчваме ви да конфигурирате вашия 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 |
Активиране на приложението "Избутване на сървър за известия". |
| 4 |
(За известия за Android) Разрешаване на FCM v1 API на NPS.
|
| 5 |
(За известия на Apple iOS) Разрешаване на HTTP/2 на NPS.
Това е ексклузивно за Версия 22 и по-ранни версии; не е налично във Версия 23 и по-нови версии, които поддържат само HTTP/2. |
| 6 |
Прикрепете техноподдържане от NPS XSP/ADP. |
| 7 |
На всеки AS сървър, файлът namedefs в Пример: _pushnotification-клиент._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com В A 10.193.78.149 След като е настроено, е необходимо едно от следните неща, за да се приемат промените:
|
Какво да направите след това
За нови инсталации на NPS, отидете на Конфигуриране на NPS за използване на прокси сървър за удостоверяване
За да мигрирате съществуващо внедряване на Android към FCMv1, отидете на Мигриране на NPS към FCMv1
Конфигуриране на NPS за използване на прокси за удостоверяване
Тази задача се отнася за нова инсталация на NPS, посветена на Webex за Cisco BroadWorks.
Ако искате да конфигурирате прокси сървър за удостоверяване на NPS, който се споделя с други мобилни приложения, вижте Актуализиране на Cisco BroadWorks NPS за използване на NPS прокси.
| 1 |
Получаване на OAuth идентификационни данни за вашия Webex за Cisco BroadWorks. | |||||||||||||||||||
| 2 |
Създаване на клиентския акаунт на NPS:
За да проверите стойностите, които въведохте, съвпадат с това, което ви е дадено, изпълнете CiscoCI issuerUrl ВИНАГИ трябва да бъде US CI клъстер, независимо от вашето местоположение, а по подразбиране трябва да бъде:
| |||||||||||||||||||
| 3 |
Въведете NPS Прокси URL адреса и задайте интервала за обновяване на маркера (препоръчват се 30 минути):
За да подобрите скоростта на преобразуване на DNS, вместо текущото FQDN име nps.uc-one.broadsoft.com, ви препоръчваме да използвате подходящото FQDN име, базирано на вашия регион. Регионално базирани FQDN имена: САЩ Изток: Западна част на САЩ:
Европа:
Ако времето за изчакване на push известията изтече поради забавяне в разрешаването на DNS, увеличете стойността на времето за изчакване в "/etc/resolv.conf" файл на сървъра BroadWorks. | |||||||||||||||||||
| 4 |
(За известия за Android) Добавете Идентификационния номер на приложението android към контекста на Приложенията на FCM на NPS.
| |||||||||||||||||||
| 5 |
(За известия на Apple iOS) Добавете ИД на приложението в контекста на приложенията APNS, като се уверите, че пропускате ключа Auth – задайте го да се изпразни.
| |||||||||||||||||||
| 6 |
Конфигуриране на следните NPS URL адреси:
| |||||||||||||||||||
| 7 |
Конфигурирайте следните параметри на NPS връзка към показаните препоръчителни стойности:
| |||||||||||||||||||
| 8 |
Проверете дали Сървърът за приложения скрининг приложение Идентификатори, защото може да се наложи да добавите приложенията webex към списъка с разрешения: | |||||||||||||||||||
| 9 |
Рестартирайте XSP|ADP: | |||||||||||||||||||
| 10 |
Тествайте известията за обаждания, като провеждате обаждания от абонат на BroadWorks до двама мобилни потребители на Webex. Проверете дали известието за обаждане се показва на устройства с iOS и Android. |
Мигриране на НПС към 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 вижте облака . Настройката се появява в таблицата идентификационни данни на проекта.
За подробности вижте Ръководството за брандиране на 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
-
Влезте В FCM Администратор SDK при http://console.firebase.google.com.
-
Изберете съответното приложение за Android.
-
В раздела Общи запишете ИД на проекта
-
Навигирайте до раздела акаунти за услуги, за да конфигурирате акаунт за сервиз. Можете да създадете нов акаунт за сервиз или да конфигурирате съществуващ такъв.
За да създадете нов акаунт за сервиз:
-
Щракнете върху синия бутон за създаване на нов акаунт за услуги
-
Кликнете върху синия бутон, за да генерирате нов частен ключ
-
Изтегляне на ключ на сигурно място
За да използвате повторно съществуващ сервизен акаунт:
-
Кликнете върху синия текст, за да видите съществуващите акаунти за услуги.
-
Идентифицирайте сервизния акаунт, който да използвате. Сервизен акаунт се нуждае от разрешение firebaseadmin-sdk.
-
В самото дясно кликнете върху менюто с хамбургери и създайте нов частен ключ.
-
Изтеглете файла 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 Console, ако искате да мигрирате SaaS клиенти към FCMv1.
Уверете се, че вече сте завършили процедурата "Конфигуриране на NPS за използване на прокси за удостоверяване".
-
Забраняване на FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Изпълнете командата
bwrestart, за да рестартирате XSP|ADP. -
Разрешаване на FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Изпълнете командата
bwrestart, за да рестартирате XSP|ADP.
Актуализиране на ADP сървър
Използвайте стъпките по-долу в Google FCM Console, ако мигрирате NPS, за да използвате ADP сървър.
-
Получете файла JSON от облачната конзола на Google:
-
В облачната конзола на Google отидете на страницата Профили за услуги.
-
Щракнете върху Избор на проект , изберете вашия проект и щракнете върху Отвори .
-
Намерете реда на сервизния акаунт, за който искате да създадете ключ, щракнете върху вертикалния бутон Още и след това щракнете върху Създаване на ключ.
-
Изберете тип ключ и щракнете върху Създаване
Файлът изтегля.
-
-
Добавяне на FCM към ADP сървъра:
-
Импортирайте JSON файла към ADP сървъра, като използвате командата
/bw/install. -
Вход в ADP CLI и добавете Project и API ключ:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
След това добавете Приложението и ключа:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
Проверете конфигурацията:
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
-