Hívás push értesítések konfigurálása a Webex BroadWorkshöz
Ebben a dokumentumban a Hívásértesítések leküldéses kiszolgálója (CNPS) kifejezést használjuk a környezetben futó XSP-ben vagy ADP-üzemeltetett alkalmazás leírására. A CNPS együttműködik a BroadWorks rendszerével, hogy tisztában legyen a felhasználókhoz érkező hívásokkal, és lekéri az értesítéseket a Google Firebase Cloud Messaging (FCM) vagy az Apple Push Notification service (APNs) értesítési szolgáltatásaiba.
Ezek a szolgáltatások értesítik a Webex mobil eszközeit a Cisco BroadWorks előfizetői számára, hogy bejövő hívásokat folytatnak a Webex-en.
A hálózati házirend-kiszolgálóval kapcsolatos további információkért tekintse meg az Értesítési leküldési kiszolgáló szolgáltatás leírását.
A Webex hasonló mechanizmusa együttműködik a Webex üzenetküldő és jelenléti szolgáltatásokkal, hogy értesítéseket küld a Google (FCM) vagy az Apple (APNS) értesítési szolgáltatásaihoz. Ezek a szolgáltatások viszont értesítik a mobil Webex felhasználókat a bejövő üzenetekről vagy a jelenlét változásairól.
Ez a szakasz leírja, hogyan konfigurálható a hálózati házirend-kiszolgáló (NPS) hitelesítési proxyhoz, ha az NPS még nem támogat más alkalmazásokat. Ha megosztott hálózati házirend-kiszolgálót kell migrálnia az NPS proxy használatára, tekintse meg a Cisco BroadWorks NPS frissítése NPS proxy használatáracímű részt.
Nps proxy – áttekintés
A Cisco BroadWorks Webex-szel való kompatibilitásához a CNPS-t javítani kell az NPS Proxy szolgáltatás, a Push Server for VoIP UCaaS támogatásához.
A funkció új tervet valósít meg az értesítési leküldéses kiszolgálón a leküldéses értesítési tanúsítvány privát kulcsainak a mobil ügyfelek szolgáltatóival való megosztásának biztonsági résének megoldására. Ahelyett, hogy a leküldéses értesítési tanúsítványokat és kulcsokat megosztaná a szolgáltatóval, az nps egy új API-t használ egy rövid életű leküldéses értesítési jogkivonat beszerzéséhez a Webex-től a Cisco BroadWorks háttérhez, és ezt a jogkivonatot használja az Apple APN-ekkel és a Google FCM szolgáltatásokkal való hitelesítéshez.
A funkció azt is javítja, hogy az értesítési leküldéses kiszolgáló az új Google Firebase Cloud Messaging (FCM) HTTPv1 API-n keresztül lekérje az értesítéseket androidos eszközökre.
-
További információ: Push Server for VoIP az UCaaS szolgáltatásleírásában.
-
A funkció BroadWorks javításai elérhetők a következő címen: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Az NPS szoftverekkel és javításokkal kapcsolatban lásd a NPS előkészítése Webexhez Cisco BroadWorks rendszerhezcímű részt.
Keresd meg és töltsd le a javítást a szoftver letöltési oldaláról.
-
Az ADP szerverről további információ a Cisco BroadWorks Application Delivery Platformweboldalon található.
APNS megfontolások
Az Apple 2021. március 31.-e után már nem támogatja a HTTP/1 alapú bináris protokollt az Apple Push Notification szolgáltatásban. Javasoljuk, hogy az XSP|ADP-t a következő használatára konfigurálja: HTTP/2-based APN-ekhez való interfész. A frissítéshez az NPS-t üzemeltető XSP|ADP-nek R22-es vagy újabb verziót kell futtatnia.
Készítse elő NPS-ét a Webex számára a Cisco BroadWorks számára
| 1 |
Telepítsen és konfiguráljon egy dedikált XSP-t (R22 minimális verzió) vagy alkalmazás-kézbesítési platformot (ADP). |
| 2 |
Telepítse a hálózati házirend-kiszolgáló proxy javításait: XSP R22 tapaszok: XSP R23 tapaszok: |
| 3 |
Aktiválja az Értesítési leküldéses kiszolgáló alkalmazást. |
| 4 |
(Android-értesítésekhez) Engedélyezze az FCM v1 API-t a hálózati házirend-kiszolgálón.
|
| 5 |
(Apple iOS-értesítésekhez) Engedélyezze a HTTP/2-t az NPS-en.
Ez kizárólag a 22-es és korábbi verziókban érhető el; a 23-as és újabb verziókban nem érhető el, amelyek csak a következőket támogatják: HTTP/2. |
| 6 |
Csatoljon egy techsupportot az NPS XSP/ADP-ből. |
| 7 |
Minden egyes AS-kiszolgálón a Példa: _pushnotification-kliens._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149 A beállítás után a változtatások végrehajtásához az alábbiak egyikére van szükség:
|
Mi a következő teendő
NPS friss telepítéséhez látogasson el a NPS konfigurálása hitelesítési proxy használatáracímű részre.
Egy meglévő Android-környezet FCMv1-re való migrálásához látogasson el a NPS migrálása FCMv1-reoldalra.
NPS konfigurálása hitelesítési proxy használatára
Ez a feladat az NPS új telepítésére vonatkozik, amelyet a Cisco BroadWorks webexének szenteltek.
Ha egy olyan NPS-en szeretnéd konfigurálni a hitelesítési proxyt, amely más mobilalkalmazásokkal is meg van osztva, lásd : A Cisco BroadWorks NPS frissítése NPS proxy használatára.
| 1 |
OAuth hitelesítő adatok beszerzése a Webexhez a Cisco BroadWorks rendszerben. | |||||||||||||||||||
| 2 |
Hozza létre az ügyfélfiókot a hálózati házirend-kiszolgálón:
Ha ellenőrizni szeretné, hogy a megadott értékek megegyeznek-e a megadott értékekkel, futtassa a A CiscoCI issuerUrl értékének MINDIG US CI clusternek kell lennie, függetlenül a tartózkodási helyedtől, az alapértelmezett érték pedig a következő:
| |||||||||||||||||||
| 3 |
Adja meg a hálózati házirend-kiszolgáló proxy URL-címét, és állítsa be a jogkivonat frissítési időközét (30 perc ajánlott):
A DNS-feloldás sebességének növelése érdekében a jelenlegi FQDN (nps.uc-one.broadsoft.com) helyett azt javasoljuk, hogy a régiójának megfelelő FQDN-t használja. Régió alapú FQDN-ek: USA keleti régiója: USA Nyugat:
Európa:
Ha a push értesítések időtúllépést jeleznek a DNS-feloldás késése miatt, növelje az időtúllépési értéket a "/etc/resolv.conf" fájl a BroadWorks szerveren. | |||||||||||||||||||
| 4 |
(Android-értesítésekhez) Adja hozzá az Android-alkalmazásazonosítót az NPS FCM-alkalmazások környezetéhez.
| |||||||||||||||||||
| 5 |
(Apple iOS értesítések esetén) Adja hozzá az alkalmazásazonosítót az APNS-alkalmazások környezetéhez, és győződjön meg róla, hogy kihagyja az Auth kulcsot – állítsa üresre.
| |||||||||||||||||||
| 6 |
Konfigurálja a következő nps URL-címeket:
| |||||||||||||||||||
| 7 |
Konfigurálja a következő hálózati házirend-kiszolgáló kapcsolati paramétereket az ajánlott értékekre:
| |||||||||||||||||||
| 8 |
Ellenőrizze, hogy az Alkalmazáskiszolgáló szűri-e az alkalmazásazonosítókat, mert előfordulhat, hogy hozzá kell adnia a Webex alkalmazásokat az engedélyezési listához: | |||||||||||||||||||
| 9 |
Indítsa újra az XSP|ADP-t: | |||||||||||||||||||
| 10 |
Tesztelje a hívásértesítéseket úgy, hogy a BroadWorks előfizetője két Webex mobilfelhasználóhoz kezdeményez hívásokat. Ellenőrizze, hogy a hívásértesítés megjelenik-e iOS és Android eszközökön. |
Nps áttelepítése AZ FCMv1-be
Ez a témakör olyan választható eljárásokat tartalmaz, amelyeket a Google FCM-konzolon akkor használhat, ha meglévő hálózati házirend-kiszolgálótelepítéssel rendelkezik, amelyet át kell telepítenie az FCMv1-re. Három eljárás létezik:
-
UC-One kliensek migrálása FCMv1-re— Ha meglévő UCaaS kliensei vannak, és migrálnia kell őket az FCMv1 használatára.
-
SaaS-kliensek migrálása FCMv1-re— Ha meglévő SaaS-kliensei vannak, és migrálnia kell őket az FCMv1 használatára.
-
ADP-kiszolgáló frissítése— Amikor az NPS-t ADP-kiszolgálóra migrálja.
UC-One kliensek migrálása FCMv1-re
A Google FCM konzolban az alábbi lépéseket követve migrálhatja az UC-One klienseket Google FCM HTTPv1-re.
Ha a márkajelzést az ügyfélre alkalmazza, az ügyfélnek rendelkeznie kell a Feladó azonosítójával. Az FCM-konzolon tekintse meg a témakört. A beállítás a Projekt hitelesítő adatai táblában jelenik meg.
Részletekért lásd a Connect Mobile Márkaépítési Útmutatót a 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?címen. Lásd a gcm_defaultSenderId paramétert, amely a Branding Kit, Resource mappában, a branding.xml fájlban található az alábbi szintaxissal:
xxxxxxxxxxxxx
-
Jelentkezzen be az FCM Admin SDK-ba a http://console.firebase.google.com.
-
Válassza ki a megfelelő Android alkalmazást.
-
Az Általános lapon jegyezze fel a projektazonosítót
-
A szolgáltatásfiók konfigurálásához keresse meg a szolgáltatásfiókok lapot. Létrehozhat új szolgáltatási fiókot, vagy konfigurálhat egy meglévőt.
Új szolgáltatási fiók létrehozása:
-
Kattintson a kék gombra új szolgáltatási fiók létrehozásához
-
Kattintson a kék gombra egy új privát kulcs létrehozásához
-
Kulcs letöltése biztonságos helyre
Meglévő szolgáltatási fiók újrafelhasználása:
-
Kattintson a kék szövegre a meglévő szolgáltatási fiókok megtekintéséhez.
-
Határozza meg a használni használt szolgáltatási fiókot. A szervizfióknak engedélyre van szüksége firebaseadmin-sdk.
-
A jobb oldalon kattintson a hamburger menüre, és hozzon létre egy új privát kulcsot.
-
Töltse le a kulcsot tartalmazó json fájlt, és mentse biztonságos helyre.
-
-
Másold a JSON fájlt az XSP|ADP-re.
-
Konfigurálja a projekt azonosítóját és :
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add -
Az alkalmazás konfigurálása:
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 engedélyezése:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Futtassa a
bwrestartparancsot az XSP|ADP újraindításához.
SaaS-ügyfelek áttelepítése az FCMv1-be
Ha SaaS-ügyfeleket szeretne áttelepíteni az FCMv1-be, használja az alábbi lépéseket a Google FCM Console-on.
Győződjön meg arról, hogy már befejezte a "Hálózati házirend-kiszolgáló konfigurálása hitelesítési proxy használatára" eljárást.
-
FCM letiltása:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
Futtassa a
bwrestartparancsot az XSP|ADP újraindításához. -
FCM engedélyezése:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
Futtassa a
bwrestartparancsot az XSP|ADP újraindításához.
ADP-kiszolgáló frissítése
Használja a Google FCM Konzol alábbi lépéseit, ha a hálózati házirend-kiszolgálót ADP-kiszolgáló használatára migrálja.
-
A JSON fájl bekérés a Google Cloud Console-ról:
-
A Google Cloud Console-on lépjen a Szolgáltatási fiókok oldalra.
-
Kattintson a Projekt kijelöléseelemre, válassza ki a projektet, majd kattintson a Megnyitás parancsra.
-
Keresse meg a szolgáltatásfiók sorát, amelyhez kulcsot szeretne létrehozni, kattintson a Továbbiak függőleges gombra, majd a Kulcs létrehozásagombra.
-
Válasszon egy Kulcs típust, majd kattintson a Létrehozásgombra
A fájl letöltődik.
-
-
FCM hozzáadása az ADP-kiszolgálóhoz:
-
Importálja a JSON fájlt az ADP-kiszolgálóra a
/bw/installparancs használatával. -
Jelentkezzen be az ADP CLI-be, és adjon hozzá Projekt- és API-kulcsot:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
Ezután adja hozzá az alkalmazást és a kulcsot:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
Ellenőrizze a konfigurációt:
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
-