Конфигуришите push обавештења о позивима за Webex BroadWorks
U ovom dokumentu koristimo termin Pozivna obaveštenja Push Server (CNPS) da bismo opisali aplikaciju hostovanu u XSP-u ili aplikaciju hostovanu za ADP koja se pokreće u vašem okruženju. Vaš CNPS radi sa vašim BroadWorks sistemom da bi bio svestan dolaznih poziva vašim korisnicima, i gura obaveštenja o njima u Google Firebase Cloud Messaging (FCM) ili Apple Push Notification servis (APNS) usluge obaveštavanja.
Te usluge obaveštavaju mobilne uređaje Webex-a za pretplatnike Cisco BroadWorks-a da imaju dolazne pozive na Webex-u.
Više informacija o NPS-u potražite u opisu funkcije "Obaveštenje PushServer".
Sličan mehanizam u Webexu funkcioniše sa Webex servisima za razmenu poruka i prisustva kako bi se pogurala obaveštenja na Google (FCM) ili Apple (APNS) servise za obaveštavanje. Te usluge zauzvrat obaveštavaju korisnike mobilnog Webexa o dolaznim porukama ili promenama prisustva.
Овај одељак описује како конфигурисати NPS за прокси за аутентификацију када NPS већ не подржава друге апликације. Ако је потребно да мигрирате дељени NPS да би користио NPS прокси, погледајте Ажурирање Cisco BroadWorks NPS-а за коришћење NPS проксија.
Pregled proxy servera NPS
Da biste bili kompatibilni sa Webex-om za Cisco BroadWorks, vaš CNPS mora biti zakrpljen da bi podržao NPS Proxy funkciju, Push Server za VoIP u UCaaS-u.
Funkcija primenjuje novi dizajn u serveru za guranje obaveštenja da bi rešila bezbednosnu ranjivost deljenja potvrde o guranju privatnih ključeva certifikata sa dobavljačima usluga za mobilne klijente. Umesto deljenja push notification sertifikata i ključeva sa provajderom usluga, NPS koristi novi API za dobijanje kratkotrajnog push notification tokena od Webex-a za Cisco BroadWorks backend, i koristi ovaj token za potvrdu identiteta sa Apple APNS i Google FCM servisima.
Funkcija takođe poboljšava mogućnost Notification Push Servera da gura obaveštenja na Android uređaje putem novog Google Firebase Cloud Messaging (FCM) HTTPv1 API.
-
Više informacija potražite u članku Push Server for VoIP u opisu funkcije 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.
Razmatranja APNS-a
Apple više neće podržavati BINARNI protokol zasnovan na HTTP/1 na Apple Push Notification servisu posle 31. marta 2021. godine. Препоручујемо да конфигуришете свој XSP|ADP да користи HTTP/2-based интерфејс за АПН-ове. Ово ажурирање захтева да ваш XSP|ADP који хостује NPS користи R22 или новију верзију.
Pripremite svoj NPS za Webex za Cisco BroadWorks
| 1 |
Instalirajte i konfigurišite namenski XSP (minimalna verzija R22) ili Platformu za isporuku aplikacija (ADP). |
| 2 |
Instalirajte proxy zakrpe za NPS potvrdu identiteta: XSP R22 zakrpe: XSP R23 zakrpe: |
| 3 |
Aktivirajte aplikaciju Notification Push Server. |
| 4 |
(Za Android obaveštenja) Omogućite FCM v1 API na NPS- u.
|
| 5 |
(Za Apple iOS obaveštenja) Omogućite HTTP/2 na NPS-u.
Ово је ексклузивно за издање 22 и старије верзије; није доступно у издању 23 и новијим верзијама, које подржавају само HTTP/2. |
| 6 |
Priložite techsupport iz NPS XSP/ADP. |
| 7 |
На сваком AS серверу, датотека namedefs у Primer: _pushnotification-клијент._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com У А 10.193.78.149 Једном подешено, потребно је једно од следећег да би се промене примениле:
|
Šta je sledeće
За нове инсталације NPS-а, идите на Конфигуришите NPS да користи прокси за аутентификацију
Да бисте мигрирали постојеће Андроид имплементирање на FCMv1, идите на Мигрирај NPS на FCMv1
Конфигуришите NPS да користи прокси за аутентификацију
Ovaj zadatak se odnosi na novu instalaciju NPS-a, posvećenu Webex-u za Cisco BroadWorks.
Ако желите да конфигуришете прокси за аутентификацију на NPS-у који се дели са другим мобилним апликацијама, погледајте Ажурирање Cisco BroadWorks NPS-а за коришћење NPS проксија.
| 1 | ||||||||||||||||||||
| 2 |
Kreirajte klijentski nalog u NPS-u:
Da biste proverili da li se vrednosti koje ste uneli podudaraju sa datim vrednostima, pokrenite CiscoCI issuerUrl треба УВЕК да буде US CI кластер без обзира на вашу локацију, а подразумевана вредност треба да буде:
| |||||||||||||||||||
| 3 |
Unesite NPS proxy URL adresu i podesite interval osvežavanja simbola (preporučuje se 30 minuta):
Да бисте побољшали брзину DNS резолуције, уместо тренутног FQDN-а nps.uc-one.broadsoft.com, препоручујемо вам да користите одговарајући FQDN на основу вашег региона. FQDN-ови засновани на региону: US East: Запад САД:
Evropa:
Ако време чекања за push обавештења истекне због кашњења у DNS резолуцији, повећајте вредност временског ограничења у "/etc/resolv.conf" датотеку на BroadWorks серверу. | |||||||||||||||||||
| 4 |
(Za Android obaveštenja) Dodajte ID Android aplikacije u kontekst FCM aplikacija na NPS- u.
| |||||||||||||||||||
| 5 |
(Za Apple iOS obaveštenja) Dodajte ID aplikacije u kontekst APNS aplikacija, obavezno izostavite taster Auth – podesite ga na prazan.
| |||||||||||||||||||
| 6 |
Konfigurišite sledeće NPS URL adrese:
| |||||||||||||||||||
| 7 |
Konfigurišite sledeće parametre NPS veze sa prikazanim preporučenim vrednostima:
| |||||||||||||||||||
| 8 |
Proverite da li server aplikacije pregleda ID-ove aplikacija zato što ćete možda morati da dodate Webex aplikacije na listu dozvoljenih stavki: | |||||||||||||||||||
| 9 |
Поново покрените XSP|ADP: | |||||||||||||||||||
| 10 |
Testirajte obaveštenja o pozivima tako što ćete pozivati pretplatnika BroadWorks-a na dva Webex mobilna korisnika. Проверите да ли се обавештење о позиву појављује на iOS и Android уређајима. |
Preseli NPS u FCMv1
Ova tema sadrži opcionalne procedure koje možete koristiti u Google FCM Konzoli kada imate postojeću NPS primenu koja vam je potrebna za migraciju na FCMv1. Postoje tri procedure:
-
Мигрирајте UC-One клијенте на FCMv1— Када имате постојеће UCaaS клијенте и потребно их је мигрирати да би користили FCMv1.
-
Мигрирајте SaaS клијенте на FCMv1— Када имате постојеће SaaS клијенте и потребно их је мигрирати да би користили FCMv1.
-
Ажурирање ADP сервера— Када мигрирате NPS на ADP сервер.
Мигрирајте UC-One клијенте на FCMv1
Користите доленаведене кораке у Google FCM конзоли да бисте мигрирали UC-One клијенте на Google FCM HTTPv1.
Ako je brendiranje primenjeno na klijenta, klijent mora da ima ID pošiljaoca. U fcM konzoli pogledajte . Postavka se pojavljuje u tabeli Akreditivi projekta.
За детаље погледајте Водич за брендирање 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
-
Prijavite se u FCM Admin SDK na http://console.firebase.google.com.
-
Izaberite odgovarajuću Android aplikaciju.
-
Na kartici Opšte postavke zakažete ID projekta
-
Dođite do kartice "Nalozi usluga" da biste konfigurisali nalog usluge. Možete da kreirate novi nalog usluge ili da konfigurišete postojeći.
Da biste kreirali novi nalog usluge:
-
Kliknite na plavo dugme za kreiranje novog naloga usluge
-
Kliknite na plavo dugme da biste generisali novi privatni ključ
-
Preuzimanje ključa na bezbednu lokaciju
Da biste ponovo uradili postojeći nalog usluge:
-
Kliknite na plavi tekst da biste videli postojeće naloge servisa.
-
Identifikujte nalog usluge koji ćete koristiti. Nalogu usluge potrebna je dozvola firebaseadmin-sdk.
-
Sa desne strane, kliknite na meni hamburgera i kreirajte novi privatni ključ.
-
Preuzmite json datoteku koja sadrži ključ i sačuvajte je na bezbednoj lokaciji.
-
-
Копирајте json датотеку на XSP|ADP.
-
Konfigurišite ID projekta i:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add -
Konfigurišite aplikaciju:
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 -
Omogući FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Покрените команду
bwrestartда бисте поново покренули XSP|ADP.
Preseli SaaS klijente u FCMv1
Koristite dole navedene korake na Google FCM Konzoli ako želite da migrirate SaaS klijente u FCMv1.
Uverite se da ste već dovršili proceduru "Konfigurisanje NPS-a za korišćenje proxy servera za potvrdu identiteta".
-
Onemogući FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Покрените команду
bwrestartда бисте поново покренули XSP|ADP. -
Omogući FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Покрените команду
bwrestartда бисте поново покренули XSP|ADP.
Ažuriraj ADP server
Koristite dole navedene korake u Google FCM Konzoli ako migrirate NPS da biste koristili ADP server.
-
Nabavite JSON fajl iz Google Cloud Konzole:
-
Na Google Cloud konzoli idite na stranicu "Nalozi usluga".
-
Izaberite projekat, odaberite projekat i kliknite na dugme Otvori.
-
Пронађите ред налога услуге за који желите да креирате кључ, кликните на вертикално дугме [ Више, а затим кликните на Креирај кључ
-
Изаберите тип кључа и кликните на Креирај
Datoteka preuzima.
-
-
Dodaj FCM ADP serveru:
-
Увезите JSON датотеку на ADP сервер помоћу команде
/bw/install. -
Prijavite se na ADP CLI i dodajte Project i API ključ:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
Zatim dodajte aplikaciju i ključ:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
Proverite konfiguraciju:
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
-