Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken: Configuratiehandleiding
Meer informatie over het bijwerken van Cisco BroadWorks NPS om NPS-proxy te gebruiken met deze configuratiehandleiding. Ontdek stapsgewijze instructies, overwegingen en optimale werkwijzen voor naadloze integratie en verbeterde netwerkprestaties.
In dit artikel wordt beschreven hoe u een gedeelde NPS configureert om de NPS-verificatieproxy te gebruiken, zodat deze ook kan worden gebruikt om gespreksmeldingen naar Webex-apps te pushen. Als uw NPS geen andere apps ondersteunt, kunt u de vereenvoudigde procedure volgen in de Webex for BroadWorks-oplossingshandleiding https://help.webex.com/z9gt5j.
Overzicht van NPS-proxy
Voor 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 pushserver voor meldingen om het beveiligingsprobleem van het delen van privésleutels voor pushmeldingscertificaten met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een korte pushmeldingstoken te verkrijgen van UCaaS-backend en gebruikt deze token voor verificatie met de Apple APN's en Google FCM-services.
De functie verbetert ook de mogelijkheid van de Notification Push Server om meldingen naar Android-apparaten te pushen via de nieuwe Google Firebase Cloud Messaging (FCM) HTTPv1 API.
Zie voor meer informatie de functiebeschrijving Pushserver voor VoIP in UCaaS op Xchange: https://xchange.broadsoft.com/node/1045458.
De BroadWorks-patches voor de functie zijn beschikbaar op Xchange: https://xchange.broadsoft.com/node/1046235.
Meer informatie over de ADP-server vindt u op https://xchange.broadsoft.com/node/1051580.
De XSP (of Application Delivery Platform ADP) die NPS host, moet aan de volgende vereisten voldoen:
Minimale versies en beperkingen voor co-residentie
NPS moet worden geactiveerd op een speciale XSP/ADP en NPS moet de enige gehoste toepassing op de server zijn. Dit is om interferentie met de levering van pushmeldingen te elimineren.
Er mag slechts één NPS-app in een implementatie zijn. Als u mobiele UC-One Collaborate/Connect en of UC-One SaaS gebruikt en Webex voor BroadWorks implementeert, moet u deze enkele NPS voor alle apps delen.
NPS moet versie R22 of later XSP of ADP hebben.
R22/R23 XSP is compatibel met een R21 stack indien de XSP enkel NPS draait en de AS R21.SP1 is. Zie de BroadWorks-compatibiliteitsmatrix voor meer informatie.
Meer informatie over de ADP-server vindt u op https://xchange.broadsoft.com/node/1051580.
Gedeelde NPS
Lees deze aantekeningen voordat u uw gedeelde NPS configureert om de NPS-proxy te gebruiken:
Als uw NPS wordt gebruikt met andere apps (niet alleen de Webex-app): Configureer eerst de NPS-proxy en wijzig vervolgens de NPS van het gebruik van de FCM legacy-API naar het gebruik van de FCM HTTP v1-API.
Nadat u hebt geverifieerd dat meldingen goed werken voor oudere apps met de NPS-proxy, verwijdert u de FCM API-sleutel voor de Android-app en de verificatiesleutel voor APN's voor de iOS-app.
APN's HTTP/2
Als u iOS-apps hebt geïmplementeerd die niet van Cisco/BroadSoft zijn, configureert u deze apps om het HTTP/2 APNS-protocol te gebruiken voordat u NPS configureert om de NPS-proxy te gebruiken.
XSP/ADP's die de Collaborate- of SaaS BroadWorks-app al ondersteunen, moeten worden gemigreerd naar HTTP/2. Zie HTTP/2-ondersteuning voor de pushserver voor meldingen voor APNS voor meer informatie over het configureren van HTTP/2 (migratie van NPS om deze iOS-apps te ondersteunen wordt in dit artikel samengevat).
Android FCMv1
Als u Android-apps hebt geïmplementeerd die niet van Cisco/BroadSoft zijn, configureert u deze apps om de FCMv1-toetsen te gebruiken voordat u NPS configureert om de NPS-proxy te gebruiken.
Als XSP/ADP momenteel de Connect- of UC-One SaaS-app ondersteunt, schakelt u 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 vervolgens uit te schakelen totdat u klaar bent om de installatie-instructies te voltooien (de migratiestroom is gedocumenteerd in dit artikel).
Volgorde | Titel van taak | Wanneer/waarom is een taak vereist? |
---|---|---|
1 |
Migreer NPS naar HTTP/2 voor UC-One SaaS (of Connect) iOS-apps. |
Als de NPS deze apps ondersteunt en deze nog niet zijn geconfigureerd voor HTTP/2. |
2 |
Migreer NPS naar FCMv1 voor UC-One SaaS (of Connect) Android-apps. |
Als de NPS deze apps ondersteunt en deze nog niet zijn geconfigureerd voor FCMv1. |
3 |
Schakel de FCMv1-modus in en test pushmeldingen. |
Als de NPS UC-One Connect en/of andere (niet-Cisco) Android-apps ondersteunt. |
4 |
Schakel de oude FCM-modus opnieuw in. |
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-verificatieproxypatches. |
Als NPS zich op XSP R22 of XSP R23 bevindt. |
6 |
Configureer NPS om de NPS-verificatieproxy te gebruiken:
|
Altijd vereist. |
7 |
Verwijder de sleutels van de verouderde FCM-modus. |
Voor apps die met succes 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 wordt uitgevoerd, moet u ap354313 toepassen voordat u de NPS-toepassing kunt configureren om HTTP/2 voor APNS te gebruiken.
1 | Stel de productie-URL en verbindingsparameters in op
Opmerking: Stel de time-out van de verbinding niet in onder 1000. |
2 | Voeg de toepassings-id's toe aan de context van de APNS-toepassingen en zorg ervoor dat u de verificatiesleutel weglaat. Stel deze in op leeg. Voor UC-One SaaS: Voor de Webex-app: |
3 | Controleer de verificatiesleutels met |
4 | Als de verificatiesleutel niet leeg is voor |
5 | HTTP/2 inschakelen:
|
6 | Alleen voor UC-One SaaS-apps: Meld u aan bij de reseller portal en ga naar |
7 | Scrol omlaag naar het gedeelte Notification Push Server en selecteer uw versie (bijv. versie 22) en volg de instructies in de portal. |
Deze taak is van toepassing op NPS op XSP. Negeer het als uw NPS op ADP 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.
Met deze taak wordt de NPS voor FCMv1 voorbereid zodat u deze kunt inschakelen als onderdeel van de configuratie van de NPS-verificatieproxy. Schakel FCMv1 pas in als u klaar bent om de NPS-verificatieproxy te configureren, anders mislukken meldingen naar SaaS-clients.
1 | Haal de project-ID op van de Firebase-console: | ||||||||||||||||
2 | Haal de privésleutel van uw serviceaccount op via 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 FCM-projectcontext:
| ||||||||||||||||
5 | Voeg de UC-One-toepassing (Connect of SaaS) en de bijbehorende project-ID toe aan de context van de FCM-toepassingen:
| ||||||||||||||||
6 | Controleer de configuratie voor FCM aan de hand van de attributen en aanbevolen waarden die hier worden weergegeven. gebruiken Uitvoeren
|
Deze taak is van toepassing op NPS op 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.
Met deze taak wordt de NPS voor FCMv1 voorbereid zodat u deze kunt inschakelen als onderdeel van de configuratie van de NPS-verificatieproxy. Schakel FCMv1 pas in als u klaar bent om de NPS-verificatieproxy te configureren, anders mislukken meldingen naar SaaS-clients.
1 | Haal de project-ID op van de Firebase-console: |
2 | Haal de privésleutel van uw serviceaccount op via Firebase: |
3 | Importeer het .json-bestand naar de ADP-server |
4 | Meld u aan bij ADP CLI en voeg het project en de API-sleutel toe aan de context van FCM-projecten:
|
5 | Voeg de toepassing en project-id toe aan de context van de FCM-toepassingen:
|
6 | Controleer uw configuratie:
|
Dit hoeft u 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 of pushmeldingen voor gesprekken naar andere apps werken met FCMv1-API.
U schakelt FCMv1 tijdelijk uit omdat FCMv1-sleutels voor deze apps alleen moeten worden ingeschakeld tijdens het configuratieproces van de NPS-verificatieproxy.
1 | Meld u aan bij de XSP die uw gedeelde NPS host. |
2 | Ga naar de FCM-context en schakel FCM v1 uit: |
Installeer de volgende patches ter ondersteuning van de functie NPS-verificatieproxy:
R22-pleisters
R23-pleisters
1 | Maak een serviceverzoek met uw onboardingcontactpersoon of met TAC om uw OAuth-clientaccount (Webex Common Identity) in te richten. Geef uw serviceaanvraag de titel NPS-configuratie voor het instellen van de verificatieproxy. Cisco geeft u een OAuth-client-id, een clientgeheim en een vernieuwingstoken die 60 dagen geldig is. Als het token verloopt voordat u het gebruikt met uw NPS, kunt u een andere aanvraag indienen.
| |||||||||||||||||||
2 | Maak het clientaccount aan op de NPS:
Om te controleren of de waarden die u hebt ingevoerd overeenkomen met wat u werd gegeven, voert u | |||||||||||||||||||
3 | Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval voor het token in (30 minuten aanbevolen):
| |||||||||||||||||||
4 | (Voor Android-meldingen) Voeg de Android-toepassings-id's toe aan de context van de FCM-toepassingen op de NPS. Voor de Webex-app op Android: Voor UC-One-app op Android: | |||||||||||||||||||
5 | (Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van de APNS-toepassingen en zorg ervoor dat u de verificatiesleutel weglaat. Stel deze in op leeg. Voor de Webex-app op iOS: Voor UC-One-app op iOS: | |||||||||||||||||||
6 | Configureer de volgende NPS-URL's:
| |||||||||||||||||||
7 | Configureer de volgende NPS-verbindingsparameters voor de weergegeven aanbevolen waarden:
| |||||||||||||||||||
8 | Controleer of de toepassingsserver de toepassings-id's screent, omdat u mogelijk de Webex-apps moet toevoegen aan de lijst met toegestane toepassingen: |
1 | Start de XSP opnieuw: bwrestart
|
2 | Test gespreksmeldingen naar Android door gesprekken te voeren van een BroadWorks-abonnee naar de belclient op Android. Controleer of de gespreksmelding wordt weergegeven op het Android-apparaat. Opmerking: Als pushmeldingen mislukken voor de UC-One Android-toepassing, is het mogelijk dat er een fout is opgetreden. Als dit uw situatie is, kunt u als volgt terugkeren naar de oude FCM:
|
3 | Test gespreksmeldingen naar iOS door te bellen van een BroadWorks-abonnee naar de gespreksclient op iOS. Controleer of de gespreksmelding wordt weergegeven op het iOS-apparaat. Opmerking: Als pushmeldingen mislukken voor de UC-One iOS-toepassing, is het mogelijk dat er een fout is opgetreden. Als dit uw situatie is, kunt u terugkeren naar de oude binaire interface met |