Konfigurirajte potisna obvestila o klicih za Webex BroadWorks
V tem dokumentu uporabljamo izraz strežnik za pošiljanje obvestil o klicih (CNPS) za opis aplikacije, ki jo gosti XSP ali ADP in se izvaja v vašem okolju. Vaš CNPS sodeluje z vašim sistemom BroadWorks, da se zaveda dohodnih klicev vaših uporabnikov in o njih pošilja obvestila v storitve obveščanja Google Firebase Cloud Messaging (FCM) ali Apple Push Notification service (APNs).
Te storitve obvestijo mobilne naprave naročnikov Webex za Cisco BroadWorks, da imajo dohodne klice na Webexu.
Za več informacij o NPS glejte Opis funkcije strežnika za potisna obvestila.
Podoben mehanizem v Webexu deluje s storitvami za sporočanje in prisotnost Webex za pošiljanje obvestil storitvam za obveščanje Google (FCM) ali Apple (APNS). Te storitve nato obveščajo uporabnike mobilnega Webexa o dohodnih sporočilih ali spremembah prisotnosti.
V tem razdelku je opisano, kako konfigurirati NPS za posredniški strežnik za preverjanje pristnosti, če NPS še ne podpira drugih aplikacij. Če morate migrirati skupni NPS za uporabo proxyja NPS, glejte Posodobitev Cisco BroadWorks NPS za uporabo proxyja NPS.
Pregled proxyja NPS
Za združljivost z Webexom za Cisco BroadWorks mora biti vaš CNPS popravljen, da podpira funkcijo NPS Proxy, Push Server za VoIP v UCaaS.
Funkcija uvaja novo zasnovo v strežniku za potisna obvestila, da bi odpravila varnostno ranljivost deljenja zasebnih ključev potrdil za potisna obvestila s ponudniki storitev za mobilne odjemalce. Namesto deljenja potrdil in ključev za potisna obvestila s ponudnikom storitev NPS uporablja nov API za pridobitev kratkotrajnega žetona za potisna obvestila od Webexa za zaledni sistem Cisco BroadWorks in ta žeton uporablja za preverjanje pristnosti z Apple APN-ji in storitvami Google FCM.
Funkcija prav tako izboljšuje zmožnost strežnika Notification Push Server za pošiljanje obvestil v naprave Android prek novega API-ja Google Firebase Cloud Messaging (FCM) HTTPv1.
-
Za več informacij glejte Opis funkcije strežnika Push za VoIP v UCaaS.
-
Popravki BroadWorks za to funkcijo so na voljo na: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Za programsko opremo in popravke NPS glejte razdelek Priprava vašega NPS za Webex za Cisco BroadWorks.
Poiščite in prenesite popravek s strani za prenos programske opreme.
-
Več informacij o strežniku ADP najdete na Cisco BroadWorks Application Delivery Platform.
Premisleki glede APNS
Apple ne bo več podpiral HTTP/1-based binarni protokol v storitvi Apple Push Notification po 31. marcu 2021. Priporočamo, da konfigurirate svoj XSP|ADP za uporabo HTTP/2-based vmesnik za APN-je. Ta posodobitev zahteva, da vaš XSP|ADP, ki gosti NPS, uporablja različico R22 ali novejšo.
Pripravite svoj NPS za Webex za Cisco BroadWorks
| 1 |
Namestite in konfigurirajte namensko platformo XSP (najmanj različice R22) ali platformo za dostavo aplikacij (ADP). |
| 2 |
Namestite popravke proxyja za preverjanje pristnosti NPS: Popravki XSP R22: Popravki XSP R23: |
| 3 |
Aktivirajte aplikacijo Strežnik za potisna obvestila. |
| 4 |
(Za obvestila za Android) Omogočite API FCM v1 na NPS-ju.
|
| 5 |
(Za obvestila Apple iOS) Omogoči HTTP/2 na NPS.
To velja izključno za izdajo 22 in starejše različice; ni na voljo v izdaji 23 in novejših različicah, ki podpirajo samo HTTP/2. |
| 6 |
Priložite tehnično podporo NPS-a XSP/ADP. |
| 7 |
Na vsakem strežniku AS mora biti datoteka namedefs v Primer: _pushnotification-odjemalec._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com V A 10.193.78.149 Ko je nastavljeno, je za prevzem sprememb potrebno eno od naslednjega:
|
Kaj storiti naprej
Za nove namestitve NPS-ja pojdite na Konfiguriranje NPS-ja za uporabo proxyja za preverjanje pristnosti
Če želite obstoječo uvedbo sistema Android preseliti v FCMv1, pojdite na Migracija NPS v FCMv1
Konfigurirajte NPS za uporabo posredniškega strežnika za preverjanje pristnosti
To opravilo velja za novo namestitev NPS, namenjeno Webexu za Cisco BroadWorks.
Če želite konfigurirati proxy za preverjanje pristnosti na NPS-ju, ki je v skupni rabi z drugimi mobilnimi aplikacijami, glejte Posodobitev Cisco BroadWorks NPS za uporabo proxyja NPS.
| 1 |
Pridobivanje poverilnic OAuth za vaš Webex za Cisco BroadWorks. | |||||||||||||||||||
| 2 |
Ustvarite odjemalski račun na NPS:
Če želite preveriti, ali se vnesene vrednosti ujemajo s prejetimi, zaženite IssuerUrl CiscoCI mora VEDNO biti gruča US CI, ne glede na vašo lokacijo, privzeta vrednost pa mora biti:
| |||||||||||||||||||
| 3 |
Vnesite URL proxyja NPS in nastavite interval osveževanja žetona (priporočeno 30 minut):
Za povečanje hitrosti razreševanja DNS-ov vam namesto trenutnega FQDN nps.uc-one.broadsoft.com priporočamo uporabo ustreznega FQDN-ja glede na vašo regijo. Regijski FQDN-ji: Vzhod ZDA: Zahod ZDA:
Evropa:
Če potisna obvestila zaradi zamude pri razreševanju DNS-a prenehajo veljati, povečajte vrednost časovne omejitve v "/etc/resolv.conf" datoteka na strežniku BroadWorks. | |||||||||||||||||||
| 4 |
(Za obvestila za Android) Dodajte ID aplikacije za Android v kontekst aplikacij FCM na NPS.
| |||||||||||||||||||
| 5 |
(Za obvestila Apple iOS) Dodajte ID aplikacije v kontekst aplikacij APNS, pri čemer izpustite ključ za avtorizacijo – nastavite ga na prazno.
| |||||||||||||||||||
| 6 |
Konfigurirajte naslednje URL-je NPS:
| |||||||||||||||||||
| 7 |
Konfigurirajte naslednje parametre povezave NPS na prikazane priporočene vrednosti:
| |||||||||||||||||||
| 8 |
Preverite, ali aplikacijski strežnik pregleduje ID-je aplikacij, ker boste morda morali aplikacije Webex dodati na seznam dovoljenih: | |||||||||||||||||||
| 9 |
Znova zaženite XSP|ADP: | |||||||||||||||||||
| 10 |
Preizkusite obvestila o klicih tako, da opravite klice z naročnika BroadWorks dvema uporabnikoma mobilnih naprav Webex. Preverite, ali se obvestilo o klicu prikaže v napravah iOS in Android. |
Migracija NPS-ja v FCMv1
Ta tema vsebuje izbirne postopke, ki jih lahko uporabite v konzoli Google FCM, če imate obstoječo uvedbo NPS, ki jo morate preseliti v FCMv1. Obstajajo trije postopki:
-
Prenesite odjemalce UC-One na FCMv1– Ko imate obstoječe odjemalce UCaaS in jih morate prenesti na FCMv1.
-
Migracija odjemalcev SaaS v FCMv1– Ko imate obstoječe odjemalce SaaS in jih morate migrirati, da bodo uporabljali FCMv1.
-
Posodobi strežnik ADP– Ko selite NPS na strežnik ADP.
Migracija odjemalcev UC-One v FCMv1
Za migracijo odjemalcev UC-One v Google FCM HTTPv1 uporabite spodnje korake v konzoli Google FCM.
Če se na stranko nanaša blagovna znamka, mora imeti stranka ID pošiljatelja. V konzoli FCM glejte . Nastavitev se prikaže v tabeli poverilnic projekta.
Za podrobnosti glejte Vodnik za mobilno blagovno znamko Connect na 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?. Glejte parameter gcm_defaultSenderId, ki se nahaja v mapi Resource v kompletu Branding Kit, datoteki branding.xml, s spodnjo sintakso:
xxxxxxxxxxxxx
-
Prijavite se v skrbniški SDK FCM na http://console.firebase.google.com.
-
Izberite ustrezno aplikacijo za Android.
-
Na zavihku Splošno zabeležite ID projekta
-
Za konfiguracijo računa storitve se pomaknite na zavihek računov storitev. Ustvarite lahko nov račun storitve ali konfigurirate obstoječega.
Če želite ustvariti nov račun storitve:
-
Kliknite modri gumb za ustvarjanje novega servisnega računa
-
Kliknite modri gumb za ustvarjanje novega zasebnega ključa
-
Prenesite ključ na varno mesto
Če želite ponovno uporabiti obstoječi račun storitve:
-
Kliknite modro besedilo za ogled obstoječih računov storitev.
-
Določite račun storitve, ki ga želite uporabiti. Storitveni račun potrebuje dovoljenje firebaseadmin-sdk.
-
Na skrajni desni strani kliknite meni hamburgerja in ustvarite nov zasebni ključ.
-
Prenesite datoteko JSON, ki vsebuje ključ, in jo shranite na varno mesto.
-
-
Kopirajte datoteko json na XSP|ADP.
-
Konfigurirajte ID projekta in :
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add -
Konfigurirajte aplikacijo:
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 -
Omogoči FCMv1:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Za ponovni zagon XSP|ADP zaženite ukaz
bwrestart.
Migracija odjemalcev SaaS v FCMv1
Če želite odjemalce SaaS preseliti v FCMv1, sledite spodnjim korakom v konzoli Google FCM.
Prepričajte se, da ste že zaključili postopek »Konfiguracija NPS za uporabo posredniškega strežnika za preverjanje pristnosti«.
-
Onemogoči FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Za ponovni zagon XSP|ADP zaženite ukaz
bwrestart. -
Omogoči FCM:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Za ponovni zagon XSP|ADP zaženite ukaz
bwrestart.
Posodobi strežnik ADP
Če selite NPS za uporabo strežnika ADP, uporabite spodnje korake v konzoli Google FCM.
-
Pridobite datoteko JSON iz konzole Google Cloud:
-
V konzoli Google Cloud Console pojdite na stran Računi storitev.
-
Kliknite Izberi projekt, izberite svoj projekt in kliknite Odpri.
-
Poiščite vrstico storitvenega računa, za katerega želite ustvariti ključ, kliknite navpični gumb Več in nato kliknite Ustvari ključ.
-
Izberite vrsto ključa in kliknite Ustvari
Datoteka se prenese.
-
-
Dodajte FCM na strežnik ADP:
-
Uvozite datoteko JSON na strežnik ADP z ukazom
/bw/install. -
Prijavite se v ADP CLI in dodajte projektni in API ključ:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
Nato dodajte aplikacijo in ključ:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
Preverite konfiguracijo:
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
-