Cisco BroadWorks NPS bijwerken voor gebruik van NPS-proxy: 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 in de Webex voor BroadWorks Solution Guidevolgen.
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 certificaten en sleutels voor pushmeldingen te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een kortstondig pushmeldingstoken te verkrijgen van de UCaaS-backend. Deze token wordt vervolgens gebruikt voor authenticatie met de Apple APN's 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 vindt u 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 vindt u 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 wordt gebruikt met andere apps (niet alleen 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 u hebt gecontroleerd of de meldingen correct werken voor oudere apps met de NPS-proxy, verwijdert u 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 de HTTP/2 APNS-protocol voordat u NPS configureert voor gebruik van de NPS-proxy.
-
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 deze apps om de FCMv1-sleutels te gebruiken voordat u NPS configureert om de NPS-proxy te gebruiken.
-
Als XSP/ADP Ondersteunt momenteel de Connect- of UC-One SaaS-app, schakel dan FCMv1-sleutels in nadat u de NPS-proxy hebt geconfigureerd. Wij raden u aan alle extra apps te migreren naar FCMv1-sleutels, deze in te schakelen en te testen en vervolgens uit te schakelen totdat u klaar bent om de installatie-instructies te voltooien (de migratiestroom 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 autorisatiesleutel niet leeg is voor |
5 |
HTTP/2 inschakelen:
|
6 |
Alleen voor UC-One SaaS-apps: Meld u aan bij de resellerportal 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 de portal. |
-
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. U krijgt van ons 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 hebt gekregen. | |||||||||||||||||||
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 wij u aan om in plaats van de huidige FQDN nps.uc-one.broadsoft.com de juiste FQDN voor uw regio te gebruiken. Regiogebaseerde FQDN's: Oosten van de Verenigde Staten: VS West:
Europa:
Als pushmeldingen verlopen vanwege een vertraging in de DNS-resolutie, verhoogt u de time-outwaarde in de "/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 |