A Cisco BroadWorks NPS frissítése NPS proxy használatára: Konfigurációs útmutató
Ez a cikk azt ismerteti, hogyan konfigurálhat egy megosztott nps-t nps hitelesítési proxy használatára, hogy az a webex-alkalmazások hívásértesítéseinek leküldésére is használható legyen. Ha az NPS nem támogat más alkalmazásokat, követheti a Webex for BroadWorks megoldási útmutatóbantalálható egyszerűsített eljárást.
Hálózati házirend-kiszolgáló proxyjának áttekintése
A BroadWorks Webex-szel való kompatibilitás érdekében az NPS-t ki kell javítani, hogy támogassa az NPS Proxy funkciót, a Push Server for VoIP-ot az UCaaS-ben.
A szolgáltatás új kialakítást valósít meg az értesítési leküldéses kiszolgálón, hogy megoldja 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ét. A push értesítési tanúsítványok és kulcsok szolgáltatóval való megosztása helyett az NPS egy új API-t használ egy rövid életű push értesítési tokenek beszerzéséhez az UCaaS háttérrendszerétől, és ezt a tokent használja hitelesítéshez az Apple APN-ekkel és a Google FCM szolgáltatásokkal.
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 ADP szerverről további információ a Cisco BroadWorks Application Delivery Platformweboldalon található.
A hálózati házirend-kiszolgálót futtató XSP-nek (vagy alkalmazáskézbesítési platform ADP-jének) meg kell felelnie a következő követelményeknek:
Minimális verziók és közös tartózkodási korlátozások
-
A hálózati házirend-kiszolgálót aktiválni kell egy dedikált XSP/ADP-n, és a hálózati házirend-kiszolgálónak kell lennie az egyetlen üzemeltetett alkalmazásnak a kiszolgálón. Ennek célja, hogy megszüntesse a push értesítések kézbesítésébe való interferenciát.
-
Egy központi telepítésben csak egy NPS-alkalmazásnak kell lennie. Ha mobil UC-One Collaborate/Connect és UC-One SaaS rendszert használ, és a BroadWorks webex-jét valósítja meg, meg kell osztania ezt az egyetlen nps-t az összes alkalmazáshoz.
-
A hálózati házirend-kiszolgálónak az R22 vagy újabb XSP vagy újabb XSP vagy ADP verzión kell lennie.
Az R22/R23 XSP kompatibilis egy R21 veremmel, ha az XSP csak nps-t futtat, az AS pedig R21. SP1. További információ: BroadWorks kompatibilitási mátrix .
-
Az ADP szerverről további információ a Cisco BroadWorks Application Delivery Platformweboldalon található.
Megosztott nps
Olvassa el ezeket a megjegyzéseket, mielőtt konfigurálná a megosztott hálózati házirend-kiszolgálót a hálózati házirend-kiszolgáló proxyjának használatára:
-
Ha az NPS-t más alkalmazásokkal is használja (nem csak a Webex alkalmazással): Először konfigurálja az NPS-proxyt, majd módosítsa a hálózati házirend-kiszolgálót az FCM örökölt API használatáról az FCM HTTP v1 API használatára.
-
Miután ellenőrizte, hogy az értesítések megfelelően működnek-e a régebbi, NPS proxyt használó alkalmazások esetében, távolítsa el az FCM API-kulcsot az Android-alkalmazáshoz, valamint az APN-ek hitelesítési kulcsát az iOS-alkalmazáshoz.
APN-ek HTTP/2
-
Ha olyan iOS-alkalmazásokat telepített, amelyek nem a következő forrásból származnak: Cisco/BroadSoft, konfigurálja ezeket az alkalmazásokat a használatukhoz HTTP/2 APNS protokoll az NPS NPS proxy használatára való konfigurálása előtt.
-
Azokat az XSP/ADP-ket, amelyek már támogatják az Együttműködés vagy az SaaS BroadWorks alkalmazást, át kell telepíteni a HTTP/2-re. A HTTP/2 konfigurálásával kapcsolatos részletes információkért lásd: HTTP/2 Támogatás az ÉRTESÍTÉSI LEKÜLDÉSES KISZOLGÁLÓHOZ APNS-hez (a hálózati házirend-kiszolgáló áttelepítése ezen iOS-alkalmazások támogatására ebben a cikkben foglalható össze).
Android FCMv1
-
Ha olyan Android-alkalmazásokat telepített, amelyek nem a következő forrásból származnak: Cisco/BroadSoft, Konfigurálja ezeket az alkalmazásokat az FCMv1 kulcsok használatára, mielőtt konfigurálná az NPS-t az NPS proxy használatára.
-
Ha XSP/ADP jelenleg támogatja a Connect vagy az UC-One SaaS alkalmazást, majd engedélyezze az FCMv1 kulcsokat az NPS proxy konfigurálása után. Azt javasoljuk, hogy minden további alkalmazást migráljon FCMv1 kulcsokba, engedélyezze és tesztelje azokat, majd tiltsa le őket, amíg készen nem áll a telepítési utasítások végrehajtására (az migrálási folyamatot ebben a cikkben dokumentáljuk).

Következés |
Tevékenység címe |
Mikor/miért van szükség feladatra? |
---|---|---|
1 |
Migrálja a hálózati házirend-kiszolgálót HTTP/2-re az UC-One SaaS (vagy Connect) iOS-alkalmazásokhoz. |
Ha a hálózati házirend-kiszolgáló támogatja ezeket az alkalmazásokat, és még nincsenek konfigurálva HTTP/2-re. |
2 |
Migrálja a hálózati házirend-kiszolgálót az FCMv1-re az UC-One SaaS (vagy Connect) Android-alkalmazásokhoz. |
Ha a hálózati házirend-kiszolgáló támogatja ezeket az alkalmazásokat, és még nincsenek konfigurálva az FCMv1-hez. |
3 |
Engedélyezze az FCMv1 módot, és tesztelje a leküldéses értesítéseket. |
Ha a hálózati házirend-kiszolgáló támogatja az UC-One Connect és/vagy más (nem Cisco) Android-alkalmazásokat. |
4 |
Engedélyezze újra az FCM örökölt módot. |
Ha az NPS támogatja az UC-One SaaS-t. Ha az FCMv1-et engedélyezve hagyja, mielőtt konfigurálná az NPS-proxyt, akkor az értesítések leküldése az UC-One SaaS-ra sikertelenné válik. |
5 |
Telepítse a hálózati házirend-kiszolgáló hitelesítési proxyjavításait. |
Ha a hálózati házirend-kiszolgáló XSP R22 vagy XSP R23 rendszeren van. |
6 |
Konfigurálja a hálózati házirend-kiszolgálót a hálózati házirend-kiszolgáló hitelesítési proxyjának használatára:
|
Mindig szükség van rá. |
7 |
Távolítsa el az FCM örökölt módbillentyűit. |
Olyan alkalmazásokhoz, amelyeket az NPS sikeresen támogatott az FCMv1-en. |
Ez a feladat kötelező az iOS platformokon az UC-One SaaS és Webex alkalmazásokba irányuló leküldéses értesítésekhez.
Mielőtt elkezdené
Ha az XSP R22 rendszert futtat, az ap354313-at kell alkalmaznia, mielőtt beállíthatja, hogy az NPS-alkalmazás HTTP/2-t használjon az APNS-hez.
1 |
Állítsa be a termelési URL-címet és a kapcsolati paramétereket a következő helyen:
Megjegyzés: Ne állítsa a kapcsolat időtúllépését 1000 alá. |
2 |
Adja hozzá az alkalmazásazonosítókat az APNS-alkalmazások környezetéhez, és győződjön meg róla, hogy kihagyja az Auth kulcsot – állítsa üresre. Az UC-One SaaS esetében: Webex alkalmazás esetén: |
3 |
Ellenőrizze az auth kulcsokat a |
4 |
Ha |
5 |
HTTP/2 engedélyezése:
|
6 |
Csak UC-One SaaS-alkalmazások esetén: Jelentkezzen be a viszonteladói portálra, és lépjen a |
7 |
Görgessen le az Értesítési push szerver részhez, és válassza ki a kiadását (pl. 22-es kiadás), majd kövesse a portálon található utasításokat. |
-
Ez a feladat az XSP-n lévő nps-re vonatkozik. Hagyja figyelmen kívül, ha a hálózati házirend-kiszolgáló ADP-n van.
-
Ezzel az eljárással az UC-One Connect vagy az UC-One SaaS Android alkalmazások FCMv1 értesítéseire való áttéréshez válthat.
-
Az FCMv1-et kell használnia, ha az NPS-proxyt szeretné használni az UC-One vagy a Webex Android alkalmazások leküldéses értesítéseinek hitelesítéséhez.
-
Ez a feladat előkészíti a hálózati házirend-kiszolgálót az FCMv1-hez, hogy az nps hitelesítési proxy konfigurációjának részeként engedélyezhesse azt. Ne engedélyezze az FCMv1-et, amíg nem áll készen az NPS hitelesítési proxy konfigurálására, vagy az SaaS-ügyfelek értesítései sikertelenek lesznek.
1 |
A projektazonosító lekérése a Firebase konzolról: | ||||||||||||||||
2 |
Szerezze be a szolgáltatásfiók privát kulcsát a Firebase-től: | ||||||||||||||||
3 |
Másolja a kulcsot az NPS-t tároló XSP-re. | ||||||||||||||||
4 |
Adja hozzá a projektazonosítót és a kapcsolódó személyes kulcsot az FCM-projektek környezetéhez:
| ||||||||||||||||
5 |
Adja hozzá az UC-One (Connect vagy SaaS) alkalmazást és a kapcsolódó projektazonosítót az FCM-alkalmazások környezetéhez:
| ||||||||||||||||
6 |
Ellenőrizze az FCM konfigurációját az itt látható attribútumokkal és ajánlott értékekkel. A parancs Futtatás
|
-
Ez a feladat az ADP-n lévő hálózati házirend-kiszolgálóra vonatkozik. Hagyja figyelmen kívül, ha a hálózati házirend-kiszolgáló XSP-n van.
-
Ezzel az eljárással az UC-One Connect vagy az UC-One SaaS Android alkalmazások FCMv1 értesítéseire való áttéréshez válthat.
-
Az FCMv1-et kell használnia, ha az NPS-proxyt szeretné használni az UC-One vagy a Webex Android alkalmazások leküldéses értesítéseinek hitelesítéséhez.
-
Ez a feladat előkészíti a hálózati házirend-kiszolgálót az FCMv1-hez, hogy az nps hitelesítési proxy konfigurációjának részeként engedélyezhesse azt. Ne engedélyezze az FCMv1-et, amíg nem áll készen az NPS hitelesítési proxy konfigurálására, vagy az SaaS-ügyfelek értesítései sikertelenek lesznek.
1 |
A projektazonosító lekérése a Firebase konzolról: |
2 |
Szerezze be a szolgáltatásfiók privát kulcsát a Firebase-től: |
3 |
Importálja a .json fájlt az ADP-kiszolgálóra |
4 |
Jelentkezzen be az ADP CLI-be, és adja hozzá a projekt- és API-kulcsot az FCM-projektek környezetéhez:
|
5 |
Adja hozzá az alkalmazást és a projektazonosítót az FCM alkalmazások környezetéhez:
|
6 |
Ellenőrizze a konfigurációt: |
Ezt csak akkor kell megtennie (az áttelepítés részeként), ha:
-
A hálózati házirend-kiszolgálót UC-One SaaS vagy BroadWorks Connect Android-alkalmazásokhoz használják.
-
Már tesztelte, hogy a hívásleküldési értesítések más alkalmazásokba működnek-e az FCMv1 API-val.
Ideiglenesen letiltja az FCMv1-et, mert ezeknek az alkalmazásoknak az FCMv1 kulcsait csak az NPS hitelesítési proxy konfigurációs folyamata során kell engedélyezni.
1 |
Jelentkezzen be a megosztott nps-t üzemeltető XSP-be. |
2 |
Keresse meg az FCM kontextust, és tiltsa le az FCM v1-et: |
Telepítse a következő javításokat a hálózati házirend-kiszolgáló hitelesítési proxy funkciójának támogatásához:
R22 javítások
R23 javítások
1 |
Hozzon létre egy szolgáltatási kérelmet a beszálló partnerével vagy a TAC-mal a (Webex Common Identity) OAuth ügyfélfiók létrehozásához. Címezze a szolgáltatáskérési hálózati házirend-kiszolgáló konfigurációját az Auth Proxy Setupszolgáltatáshoz. Kapsz egy OAuth kliensazonosítót, egy kliens titkos kódot és egy 60 napig érvényes frissítési tokent. Ha a jogkivonat lejár, mielőtt a hálózati házirend-kiszolgálóval használná, újabb kérést kezdeményezhet.
| |||||||||||||||||||
2 |
Hozza létre az ügyfélfiókot a hálózati házirend-kiszolgálón:
Futtassa a parancsot annak ellenőrzéséhez, hogy a megadott értékek megegyeznek-e a kapott értékekkel. | |||||||||||||||||||
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és értékét a "/etc/resolv.conf" fájl a BroadWorks szerveren. | |||||||||||||||||||
4 |
(Android-értesítések esetén) Adja hozzá az Android alkalmazásazonosítókat az FCM-alkalmazások környezetéhez az NPS-en. Webex alkalmazás Androidon: UC-One alkalmazás Androidon: | |||||||||||||||||||
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. Webex alkalmazás iOS rendszeren: Az iOS-en található UC-One alkalmazás esetén: | |||||||||||||||||||
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: |
1 |
Indítsa újra az XSP-t: bwrestart |
2 |
Tesztelje az Android hívásértesítéseit úgy, hogy hívásokat kezdeményez egy BroadWorks előfizetőtől az Android hívó klienséhez. Ellenőrizze, hogy a hívásértesítés megjelenik-e az Android-eszközön. Megjegyzés: Ha a leküldéses értesítések sikertelenek lesznek az UC-One androidos alkalmazásnál, lehetséges, hogy hibás konfiguráció történik. Ha ez a helyzet, akkor visszatérhet az örökölt FCM-hez az alábbiak szerint:
|
3 |
Tesztelje az iOS-re irányuló hívásértesítéseket úgy, hogy hívásokat kezdeményez egy BroadWorks-előfizetőtől az iOS hívó ügyféléhez. Ellenőrizze, hogy a hívásértesítés megjelenik-e az iOS-eszközön. Megjegyzés: Ha a leküldéses értesítések sikertelenek lesznek az UC-One iOS-alkalmazásnál, előfordulhat, hogy hibás konfiguráció történik. Ha ez a helyzet, akkor visszatérhet az örökölt bináris felülethez a |