Kiitos palautteestasi.
Puheluiden push-ilmoitusten määrittäminen Webex BroadWorksille
Onko sinulla palautetta?Tässä asiakirjassa käytämme termiä Puheluilmoitusten push-palvelin (CNPS) kuvaamaan XSP- tai ADP-pohjaista sovellusta, joka toimii omassa ympäristössäsi. CNPS toimii BroadWorks-järjestelmäsi kanssa ja on tietoinen käyttäjillesi tulevista puheluista. Se lähettää niistä ilmoitukset Google Firebase Cloud Messagingin (FCM) tai Apple Push Notification -palvelun (APN) ilmoituspalveluihin.
Nämä palvelut ilmoittavat Cisco BroadWorks -tilaajien Webex-mobiililaitteille, että heillä on saapuvia puheluita Webexissä.
Lisätietoja NPS:stä on Notification Push Server -ominaisuuden kuvauksessa.
Samankaltainen mekanismi Webexissä toimii Webexin viesti- ja läsnäolopalveluiden kanssa ilmoitusten lähettämiseksi Googlen (FCM) tai Applen (APNS) ilmoituspalveluihin. Nämä palvelut puolestaan ilmoittavat mobiilikäyttäjille Webexin saapuvista viesteistä tai läsnäolotietojen muutoksista.
Tässä osiossa kuvataan, miten NPS määritetään todennusvälityspalvelimelle, kun NPS ei vielä tue muita sovelluksia. Jos sinun on siirrettävä jaettu NPS käyttämään NPS-välityspalvelinta, katso Cisco BroadWorks NPS:n päivittäminen NPS-välityspalvelimen käyttöön.
NPS-välityspalvelimen yleiskatsaus
Jotta CNPS olisi yhteensopiva Webex for Cisco BroadWorksin kanssa, se on päivitettävä tukemaan NPS-välityspalvelinominaisuutta Push Server for VoIP in UCaaS.
Ominaisuus toteuttaa uuden rakenteen Notification Push Serverissä ratkaistakseen tietoturvahaavoittuvuuden, joka liittyy push-ilmoitussertifikaattien yksityisten avainten jakamiseen palveluntarjoajien kanssa mobiiliasiakkaille. Sen sijaan, että NPS jakaisi push-ilmoitussertifikaatteja ja -avaimia palveluntarjoajan kanssa, se käyttää uutta API:a lyhytikäisen push-ilmoitustunnuksen hakemiseen Webexiltä Cisco BroadWorks -taustajärjestelmää varten ja käyttää tätä tunnusta todennukseen Apple APN:ien ja Google FCM -palveluiden kanssa.
Ominaisuus parantaa myös Notification Push Serverin kykyä lähettää ilmoituksia Android-laitteisiin uuden Google Firebase Cloud Messaging (FCM) HTTPv1 -rajapinnan kautta.
-
Lisätietoja on UCaaS:n VoIP-push-palvelimen ominaisuuskuvauksessa.
-
BroadWorks-korjaukset tälle ominaisuudelle ovat saatavilla osoitteesta: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
NPS-ohjelmistojen ja -korjausten osalta katso osio Valmistele NPS Webexiä varten Cisco BroadWorksille.
Etsi ja lataa korjaustiedosto ohjelmiston lataussivulta.
-
Lisätietoja ADP-palvelimesta on osoitteessa Cisco BroadWorks Application Delivery Platform.
APNS-huomioita
Apple ei enää tue HTTP/1-based binääriprotokolla Applen Push-ilmoituspalvelussa 31. maaliskuuta 2021 jälkeen. Suosittelemme, että määrität XSP|ADP:n käyttämään HTTP/2-based APN-liitäntä. Tämä päivitys edellyttää, että NPS:ää isännöivä XSP|ADP käyttää R22-versiota tai uudempaa.
Valmistele NPS:si Webexiä ja Cisco BroadWorksia varten
| 1 |
Asenna ja konfiguroi erillinen XSP (vähintään versio R22) tai Application Delivery Platform (ADP). |
| 2 |
Asenna NPS-todennusvälityspalvelimen korjaustiedostot: XSP R22 -korjaukset: XSP R23 -korjaukset: |
| 3 |
Aktivoi Notification Push Server -sovellus. |
| 4 |
(Android-ilmoituksia varten) Ota FCM v1 -rajapinta käyttöön NPS:ssä.
|
| 5 |
(Apple iOS -ilmoituksille) Ota käyttöön HTTP/2 NPS:ssä.
Tämä koskee vain versiota 22 ja sitä aiempia versioita; se ei ole saatavilla versiossa 23 ja sitä uudemmissa versioissa, jotka tukevat vain HTTP/2. |
| 6 |
Liitä NPS:n tekninen tukipyyntö XSP/ADP. |
| 7 |
Jokaisella AS-palvelimella Esimerkki: _pushnotification-asiakas._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 Kun asetus on tehty, muutosten voimaantulo edellyttää yhtä seuraavista:
|
Mitä tehdä seuraavaksi
NPS:n uusia asennuksia varten siirry kohtaan NPS:n määrittäminen käyttämään todennusvälityspalvelinta
Jos haluat siirtää olemassa olevan Android-käyttöönoton FCMv1-versioon, siirry kohtaan NPS:n siirtäminen FCMv1-versioon
NPS:n määrittäminen käyttämään todennusvälityspalvelinta
Tämä tehtävä koskee uutta NPS-asennusta, joka on tarkoitettu Webex for Cisco BroadWorksille.
Jos haluat määrittää todennusvälityspalvelimen NPS:lle, joka on jaettu muiden mobiilisovellusten kanssa, katso Cisco BroadWorks NPS:n päivittäminen NPS-välityspalvelimen käyttöön.
| 1 |
OAuth-tunnistetietojen hankkiminen Webex-käyttöjärjestelmääsi varten Cisco BroadWorksissa. | |||||||||||||||||||
| 2 |
Luo asiakastili NPS:ään:
Tarkistaaksesi, vastaavatko syöttämäsi arvot annettuja, suorita CiscoCI-issuerUrl-osoitteen tulisi AINA olla US CI -klusteri sijainnistasi riippumatta, ja oletusarvon tulisi olla: | |||||||||||||||||||
| 3 |
Anna NPS-välityspalvelimen URL-osoite ja aseta tunnuksen päivitysväli (suositus 30 minuuttia):
DNS-selvityksen nopeuden parantamiseksi suosittelemme käyttämään alueesi mukaista FQDN-nimeä nykyisen FQDN-nimen nps.uc-one.broadsoft.com sijaan. Aluepohjaiset FQDN-nimet: Yhdysvaltain itäosa: Yhdysvaltain länsiosa:
Eurooppa:
Jos push-ilmoitukset aikakatkaistaan DNS-selvityksen viiveen vuoksi, lisää aikakatkaisuarvoa kohdassa "/etc/resolv.conf" tiedosto BroadWorks-palvelimella. | |||||||||||||||||||
| 4 |
(Android-ilmoituksille) Lisää Android-sovelluksen tunnus FCM-sovellusten kontekstiin NPS:ssä.
| |||||||||||||||||||
| 5 |
(Apple iOS -ilmoituksille) Lisää sovellustunnus APNS-sovelluskontekstiin ja varmista, että todennusavain jätetään pois – aseta se tyhjäksi.
| |||||||||||||||||||
| 6 |
Määritä seuraavat NPS:n URL-osoitteet:
| |||||||||||||||||||
| 7 |
Määritä seuraavat NPS-yhteysparametrit näytettyihin suositeltuihin arvoihin:
| |||||||||||||||||||
| 8 |
Tarkista, tarkistaako sovelluspalvelin sovellustunnuksia, koska sinun on ehkä lisättävä Webex-sovellukset sallittujen luetteloon: | |||||||||||||||||||
| 9 |
Käynnistä XSP|ADP uudelleen: | |||||||||||||||||||
| 10 |
Testaa puheluilmoituksia soittamalla puheluita BroadWorks-tilaajalta kahdelle Webex-mobiilikäyttäjälle. Varmista, että puheluilmoitus näkyy iOS- ja Android-laitteissa. |
NPS:n siirtäminen FCMv1:een
Tämä aihe sisältää valinnaisia menettelytapoja, joita voit käyttää Google FCM Consolessa, kun sinulla on olemassa oleva NPS-käyttöönotto, joka sinun on siirrettävä FCMv1:een. On olemassa kolme menettelytapaa:
-
UC-One-asiakkaiden siirtäminen FCMv1-versioon—Kun sinulla on olemassa olevia UCaaS-asiakkaita ja ne on siirrettävä käyttämään FCMv1-versiota.
-
SaaS-asiakkaiden siirtäminen FCMv1:een—Kun sinulla on olemassa olevia SaaS-asiakkaita ja ne on siirrettävä käyttämään FCMv1:tä.
-
Päivitä ADP-palvelin— Kun siirrät NPS:n ADP-palvelimelle.
UC-One-asiakkaiden siirtäminen FCMv1:een
Siirrä UC-One-asiakkaat Google FCM HTTPv1 -käyttöön seuraavien Google FCM -konsolin ohjeiden mukaisesti.
Jos asiakkaaseen sovelletaan brändäystä, asiakkaalla on oltava lähettäjän tunnus. Katso FCM-konsolista . Asetus näkyy Projektin tunnistetiedot -taulukossa.
Lisätietoja on Connect Mobilen brändäysoppaassa osoitteessa 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?. Katso gcm_defaultSenderId -parametria, joka sijaitsee Branding Kit -tiedoston resurssikansiossa branding.xml-tiedostossa alla olevalla syntaksilla:
xxxxxxxxxxxxx
-
Kirjaudu FCM Admin SDK:hon osoitteessa http://console.firebase.google.com.
-
Valitse sopiva Android-sovellus.
-
Kirjaa Yleiset -välilehdelle projektin tunnus
-
Siirry palvelutilit-välilehdelle määrittääksesi palvelutilin. Voit luoda uuden palvelutilin tai määrittää olemassa olevan.
Uuden palvelutilin luominen:
-
Luo uusi palvelutili napsauttamalla sinistä painiketta
-
Napsauta sinistä painiketta luodaksesi uuden yksityisen avaimen
-
Lataa avain turvalliseen sijaintiin
Voit käyttää uudelleen olemassa olevaa palvelutiliä seuraavasti:
-
Napsauta sinistä tekstiä nähdäksesi olemassa olevat palvelutilit.
-
Valitse käytettävä palvelutili. Palvelutili tarvitsee käyttöoikeuden firebaseadmin-sdk.
-
Napsauta oikealla puolella olevaa hampurilaisvalikkoa ja luo uusi yksityinen avain.
-
Lataa avaimen sisältävä json-tiedosto ja tallenna se turvalliseen sijaintiin.
-
-
Kopioi json-tiedosto XSP|ADP:lle.
-
Määritä projektitunnus ja :
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add -
Sovelluksen määrittäminen:
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 -
Ota FCMv1 käyttöön:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Käynnistä XSP|ADP uudelleen suorittamalla komento
bwrestart.
SaaS-asiakkaiden migrointi FCMv1:een
Noudata alla olevia ohjeita Google FCM Consolessa, jos haluat siirtää SaaS-asiakkaat FCMv1:een.
Varmista, että olet jo suorittanut toimenpiteen "NPS:n määrittäminen käyttämään todennusvälityspalvelinta".
-
Poista FCM käytöstä:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Käynnistä XSP|ADP uudelleen suorittamalla komento
bwrestart. -
Ota FCM käyttöön:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Käynnistä XSP|ADP uudelleen suorittamalla komento
bwrestart.
Päivitä ADP-palvelin
Noudata alla olevia ohjeita Google FCM -konsolissa, jos siirrät NPS:n käyttämään ADP-palvelinta.
-
Hae JSON-tiedosto Google Cloud Consolesta:
-
Siirry Google Cloud Consolessa Palvelutilit -sivulle.
-
Napsauta Valitse projekti, valitse projektisi ja napsauta Avaa.
-
Etsi sen palvelutilin rivi, jolle haluat luoda avaimen, napsauta Lisää -pystypainiketta ja napsauta sitten Luo avain.
-
Valitse Avaimen tyyppi ja napsauta Luo
Tiedosto latautuu.
-
-
Lisää FCM ADP-palvelimelle:
-
Tuo JSON-tiedosto ADP-palvelimelle käyttämällä
/bw/install-komentoa. -
Kirjaudu ADP CLI:hen ja lisää projekti ja API-avain:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
Lisää seuraavaksi sovellus ja avain:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
Tarkista kokoonpano:
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
-
