Cisco BroadWorks NPS bijwerken om NPS Proxy te gebruiken: Configuratiehandleiding
Dit artikel beschrijft hoe u een gedeelde NPS configureert voor het gebruik van de NPS-verificatieproxy, zodat het ook kan worden gebruikt om oproepmeldingen naar Webex-apps te pushen. Als uw NPS geen andere apps ondersteunt, kunt u de vereenvoudigde procedure volgen in de Webex for BroadWorks Solution Guide.
Overzicht NPS-proxy
Voor de compatibiliteit met Webex voor BroadWorks moet uw NPS worden gepatcht ter ondersteuning van de NPS-proxyfunctie, pushserver voor VoIP in UCaaS.
De functie implementeert een nieuw ontwerp in de Push-server voor meldingen om het beveiligingsprobleem van het delen van pushmeldingcertificaat privésleutels met serviceproviders voor mobiele clients op te lossen. In plaats van pushnotificatiecertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een kortstondig pushnotificatietoken te verkrijgen van de UCaaS-backend, en gebruikt dit token voor authenticatie met de Apple APNs- en Google FCM-services.
De functie biedt ook een verbeterde functionaliteit van de Berichten pushserver om meldingen naar Android-apparaten te pushen via de nieuwe HTPv1-API van Google Firebase Cloud Messaging (FCM).
-
Zie de Push-server voor meer informatie over VoIP in functiebeschrijving UCaaS.
-
De BroadWorks-patches voor deze functie zijn beschikbaar op: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
-
Meer informatie over de ADP-server is te vinden op Cisco BroadWorks Application Delivery Platform.
De XSP (of Application Delivery Platform ADP) die nps host moet aan de volgende vereisten voldoen:
Minimale versies en beperkingen voor co-residentie
-
NPS moeten worden geactiveerd in een speciale XSP/ADP en NPS moeten de enige gehoste toepassing op de server zijn. Hiermee voorkomt u storing bij de levering van pushmeldingen.
-
Er moet slechts één NPS-app zijn in een implementatie. Als u het mobiele UC-One Collaborate/Connect en of UC-One SaaS gebruikt en Webex for BroadWorks implementeert, moet u deze enkele NPS delen voor alle apps.
-
NPS moet op versie R22 of hoger XSP of ADP zijn.
R22/R23 XSP is compatibel met een R21-gestapeld als de XSP alleen NPS gebruikt en de AS R21 is. SP1. Zie de BroadWorks-compatibiliteitsmatrix voor meer informatie.
-
Meer informatie over de ADP-server is te vinden op Cisco BroadWorks Application Delivery Platform.
Gedeelde NPS
Lees deze aantekeningen voordat u uw gedeelde NPS configureert voor het gebruik van de NPS Proxy:
-
Als uw NPS-account ook met andere apps wordt gebruikt (niet alleen met de Webex-app): Configureer eerst de NPS-proxy en wijzig vervolgens de NPS vanuit de FCM legacy API in het gebruik van FCM HTTP v1 API.
-
Nadat je hebt gecontroleerd of meldingen voor oudere apps met de NPS-proxy correct werken, verwijder je de FCM API-sleutel voor de Android-app en de APNs-authenticatiesleutel voor de iOS-app.
APN's HTTP/2
-
Als u iOS-apps hebt geïmplementeerd die niet afkomstig zijn van Cisco/BroadSoft, configureer die apps om te gebruiken HTTP/2 APNS-protocol voordat NPS wordt geconfigureerd om de NPS-proxy te gebruiken.
-
XSP/ADP's die de app Collaborate of SaaS BroadWorks al ondersteunen, moeten worden gemigreerd naar HTTP/2. Zie HTTP/2-ondersteuning voor pushserver voor meldingen voor APNS (migratie van NPS om deze iOS-apps te ondersteunen is in dit artikel samengevat voor gedetailleerde informatie over het configureren van HTTP/2 ).
Android FCMv1
-
Als u Android-apps hebt geïmplementeerd die niet afkomstig zijn van Cisco/BroadSoft, Configureer die apps om de FCMv1-sleutels te gebruiken voordat u NPS configureert om de NPS-proxy te gebruiken.
-
Als XSP/ADP Als de Connect- of UC-One SaaS-app momenteel wordt ondersteund, schakel dan FCMv1-sleutels in nadat u de NPS-proxy hebt geconfigureerd. We raden u aan alle extra apps te migreren naar FCMv1-sleutels, in te schakelen en te testen, en ze vervolgens weer uit te schakelen totdat u klaar bent om de installatie-instructies te voltooien (de migratieprocedure wordt beschreven in dit artikel).

|
Volgorde |
Taaktitel |
Wanneer/waarom is een taak vereist? |
|---|---|---|
|
1 |
Nps migreren naar HTTP/2 voor UC-One SaaS- (of Connect)iOS-apps. |
Als de NPS deze apps ondersteunt en ze nog niet zijn geconfigureerd voor HTTP/2. |
|
2 |
NPS migreren naar FCMv1 voor UC-One SaaS- (of Connect)-Android-apps. |
Als de NPS deze apps ondersteunt en ze nog niet zijn geconfigureerd voor FCMv1. |
|
3 |
Schakel de FCMv1-modus in en test pushmeldingen. |
Als de NPS UC-One Connect en/of andere Android-apps (niet Cisco) ondersteunt. |
|
4 |
FcM legacy-modus opnieuw inschakelen. |
Als de NPS UC-One SaaS ondersteunt. Als u FCMv1 ingeschakeld laat, voordat u de NPS-proxy configureert, mislukken pushmeldingen naar UC-One SaaS. |
|
5 |
Installeer NPS-verificatie proxypatches. |
Als NPS op XSP R22 of XSP R23 staat. |
|
6 |
Configureer NPS om de NPS-verificatieproxy te gebruiken:
|
Altijd vereist. |
|
7 |
Verwijder de sleutels van de verouderde FCM-modus. |
Voor apps die worden ondersteund door NPS op FCMv1. |
Deze taak is verplicht voor pushmeldingen naar UC-One SaaS- en Webex-apps op iOS-platforms.
Voordat u begint
Als uw XSP R22 gebruikt, moet u ap354313 toepassen voordat u de NPS-toepassing kunt configureren voor het gebruik van HTTP/2 voor APNS.
| 1 |
Stel de productie-URL en de verbindingsparameters in op
Opmerking: Stel de verbindings time-out niet onder 1000 in. |
| 2 |
Voeg de toepassings-ID's toe aan de context van APNS-toepassingen, zodat u de Auth-sleutel weglaten en deze leeg laten. Voor UC-One SaaS: Voor de Webex-app: |
| 3 |
Controleer de auth-sleutels met |
| 4 |
Als de authenticatiesleutel niet leeg is voor |
| 5 |
HTTP/2 inschakelen:
|
| 6 |
Alleen voor UC-One SaaS-apps: Meld u aan bij het resellerportaal en ga naar |
| 7 |
Scroll naar beneden naar het gedeelte 'Notification Push Server' en selecteer uw release (bijv. Release 22), volg dan de instructies in het portaal. |
-
Deze taak is van toepassing op NPS op XSP. Negeer het als uw NPS een ADP-beleid heeft.
-
U kunt deze procedure gebruiken voor het migreren naar FCMv1-meldingen voor UC-One Connect- of UC-One SaaS Android-apps.
-
U moet FCMv1 gebruiken als u de NPS-proxy wilt gebruiken om pushmeldingen naar UC-One of de Webex Android-apps te verifiëren.
-
Deze taak bereidt de NPS voor FCMv1 voor zodat u deze kunt inschakelen als onderdeel van de configuratie van NPS-verificatieproxy. Schakel FCMv1 pas in als u klaar bent om de NPS-verificatieproxy te configureren, of meldingen voor SaaS-clients mislukken.
| 1 |
Haal de project-id op uit de Firebase-console: | ||||||||||||||||
| 2 |
Haal de privésleutel van uw serviceaccount op vanuit Firebase: | ||||||||||||||||
| 3 |
Kopieer de sleutel naar de XSP die uw NPS host. | ||||||||||||||||
| 4 |
Voeg de project-id en de bijbehorende privésleutel toe aan de context van fcm-projecten:
| ||||||||||||||||
| 5 |
Voeg de UC-One-toepassing (Connect of SaaS) en de bijbehorende project-id toe aan de FCM-toepassingencontext:
| ||||||||||||||||
| 6 |
Controleer de configuratie voor FCM op de kenmerken en aanbevolen waarden die hier worden weergegeven. Gebruik de Uitvoeren
|
-
Deze taak is van toepassing op NPS binnen ADP. Negeer het als uw NPS op XSP staat.
-
U kunt deze procedure gebruiken voor het migreren naar FCMv1-meldingen voor UC-One Connect- of UC-One SaaS Android-apps.
-
U moet FCMv1 gebruiken als u de NPS-proxy wilt gebruiken om pushmeldingen naar UC-One of de Webex Android-apps te verifiëren.
-
Deze taak bereidt de NPS voor FCMv1 voor zodat u deze kunt inschakelen als onderdeel van de configuratie van NPS-verificatieproxy. Schakel FCMv1 pas in als u klaar bent om de NPS-verificatieproxy te configureren, of meldingen voor SaaS-clients mislukken.
| 1 |
Haal de project-id op uit de Firebase-console: |
| 2 |
Haal de privésleutel van uw serviceaccount op vanuit Firebase: |
| 3 |
Importeer het .json-bestand naar de ADP-server |
| 4 |
Meld u aan bij ADP CLI en voeg de project- en API-sleutel toe aan de FCM-projectencontext:
|
| 5 |
Voeg de toepassing en de project-id toe aan de context van FCM-toepassingen:
|
| 6 |
Controleer uw configuratie: |
U hoeft dit alleen te doen (als onderdeel van de migratie) als:
-
Uw NPS wordt gebruikt voor UC-One SaaS- of BroadWorks Connect Android-apps.
-
U hebt al getest dat pushmeldingen voor bellen naar andere apps werken met FCMv1 API.
U staat FCMv1 tijdelijk uit omdat FCMv1-sleutels voor deze apps alleen moeten worden ingeschakeld tijdens het NPS-verificatieproxyconfiguratieproces.
| 1 |
Meld u aan bij de XSP die uw gedeelde NPS host. |
| 2 |
Navigeer naar de FCM-context en schakel FCM v1 uit: |
Installeer de volgende patches ter ondersteuning van de NPS-verificatieproxyfunctie:
R22-patches
R23 Patches
| 1 |
Maak een serviceverzoek bij uw onboardingcontact of met TAC om uw (Webex Common Identity) OAuth-clientaccount in te stellen. Titel van uw serviceaanvraag NPS-configuratie voor auth-proxyconfiguratie. We geven je een OAuth-client-ID, een clientgeheim en een vernieuwingstoken dat 60 dagen geldig is. Als het token verloopt voordat u het gebruikt met uw NPS, kunt u nog een verzoek indienen.
| |||||||||||||||||||
| 2 |
Maak de clientaccount in de NPS:
Voer de opdracht uit om te controleren of de ingevoerde waarden overeenkomen met de waarden die u zijn verstrekt. | |||||||||||||||||||
| 3 |
Voer de NPS-proxy-URL in en stel het interval voor het vernieuwen van het token in (30 minuten aanbevolen):
Om de DNS-resolutiesnelheid te verbeteren, raden we u aan om in plaats van de huidige FQDN nps.uc-one.broadsoft.com de juiste FQDN te gebruiken op basis van uw regio. Regio-gebaseerde FQDN's: Oosten van de Verenigde Staten: West-VS:
Europa:
Saoedi-Arabië:
Als pushmeldingen een time-out geven vanwege een vertraging in de DNS-resolutie, verhoog dan de time-outwaarde in de instellingen. "/etc/resolv.conf" bestand op de BroadWorks-server. | |||||||||||||||||||
| 4 |
(Voor Android-meldingen) Voeg de ID's van de Android-toepassing toe aan de context van FCM-toepassingen op de NPS. Voor de Webex-app op Android: Voor de UC-One-app op Android: | |||||||||||||||||||
| 5 |
(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van APNS-toepassingen, zodat u de Auth-sleutel weglaten en deze leeg laat. Voor de Webex-app op iOS: Voor UC-One-app in iOS: | |||||||||||||||||||
| 6 |
Configureer de volgende NPS-URL's:
| |||||||||||||||||||
| 7 |
Configureer de volgende NPS-verbindingsparameters voor de aanbevolen waarden die worden weergegeven:
| |||||||||||||||||||
| 8 |
Controleer of de toepassingsserver een toepassings-id heeft, omdat u de Webex-apps mogelijk aan de lijst met toegestane toepassingen moet toevoegen: |
| 1 |
Start de XSP opnieuw: bwrestart |
| 2 |
Test oproepmeldingen naar Android door te bellen via een BroadWorks-abonnee naar de belclient in Android. Controleer of de oproepmelding wordt weergegeven op het Android-apparaat. Opmerking: Als pushmeldingen beginnen te mislukken voor de UC-One Android-toepassing, is het mogelijk dat er een verkeerde configuratie is. Als dit uw situatie is, kunt u als volgt terugkeren naar de verouderde FCM:
|
| 3 |
Test oproepmeldingen naar iOS door te bellen via een BroadWorks-abonnee naar de belclient in iOS. Controleer of de oproepmelding wordt weergegeven op het iOS-apparaat. Opmerking: Als pushmeldingen beginnen te mislukken voor de UC-One iOS-toepassing, is het mogelijk dat er een verkeerde configuratie is. Als dit uw situatie is, kunt u terugkeren naar de verouderde binaire interface met |