In dit artikel
Overzicht van de NPS-verificatieproxy
dropdown icon
Vereisten voor NPS-verificatieproxy
    Minimumversies en beperkingen voor co-residenties
    Gedeelde NPS
    APN's HTTP/2
    Android FCMv1
Samenvatting van de migratie van NPS Proxy
Migreer de iOS-apps van BroadWorks Collaborate naar HTTP/2
BroadWorks UC-One Connect/SaaS Android-apps migreren naar FCMv1
BroadWorks UC-One Connect/SaaS Android-apps migreren naar FCMv1 (op ADP)
FCM Legacy-modus opnieuw inschakelen
dropdown icon
Proxy-patches voor NPS-verificatie installeren
    R22-patches
    R23-pleisters
NPS configureren om een authenticatieproxy te gebruiken
NPS opnieuw starten en pushmeldingen testen
Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken: Configuratiegids
list-menuIn dit artikel
list-menuFeedback?

Leer met deze configuratiehandleiding hoe u Cisco BroadWorks NPS kunt updaten om NPS Proxy te gebruiken. Ontdek stapsgewijze instructies, overwegingen en best practices voor naadloze integratie en verbeterde netwerkprestaties.

Overzicht van de NPS-verificatieproxy

In dit artikel wordt beschreven hoe u een gedeelde NPS kunt configureren voor het gebruik van een NPS-verificatieproxy, zodat deze ook kan worden gebruikt om oproepmeldingen naar Webex-apps te sturen. Als uw NPS andere apps niet ondersteunt, kunt u de vereenvoudigde procedure volgen in de Webex for BroadWorks Solution Guide.

Overzicht van de NPS Proxy

Voor compatibiliteit met Webex voor BroadWorks moet uw NPS worden gepatcht om de NPS Proxy-functie, Push Server for VoIP in UCaaS, te ondersteunen.

De functie implementeert een nieuw ontwerp in de Notification Push Server om het beveiligingsprobleem op te lossen van het delen van privésleutels voor pushmeldingscertificaten met serviceproviders voor mobiele clients. In plaats van certificaten en sleutels voor pushmeldingen te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een token voor pushmeldingen van korte duur te verkrijgen via de UCaaS-backend, en gebruikt dit token voor authenticatie 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.

Vereisten voor NPS-verificatieproxy

Het XSP (of Application Delivery Platform ADP) dat NPS host, moet aan de volgende vereisten voldoen:

Minimumversies en beperkingen voor co-residenties

  • NPS moet geactiveerd zijn 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 voorkomen.

  • Er mag maar één NPS-app in een implementatie zijn. Als u de 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 hoger zijn, XSP of ADP.

    R22/R23 XSP is compatibel met een R21-stack als de XSP alleen NPS draait en de AS R21.SP1 is. Zie de BroadWorks Compatibility Matrix voor meer informatie.

  • Meer informatie over de ADP-server is te vinden op Cisco BroadWorks Application Delivery Platform.

Gedeelde NPS

Lees deze opmerkingen 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 verouderde FCM-API naar de FCM HTTP v1-API.

  • Nadat u hebt geverifieerd dat de meldingen goed werken voor oudere apps met de NPS-proxy, verwijdert u de FCM API-sleutel voor de Android-app en de APN-authenticatiesleutel voor de iOS-app.

APN's HTTP/2

  • Als u iOS-apps hebt geïmplementeerd die niet van Cisco/BroadSoft zijn, moet u die apps configureren 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. Voor gedetailleerde informatie over het configureren van HTTP/2, zie HTTP/2 Support to Notification Push Server for APNS (de migratie van NPS ter ondersteuning van deze iOS-apps wordt in dit artikel samengevat).

Android FCMv1

  • Als u Android-apps hebt geïmplementeerd die niet van Cisco/BroadSoft zijn, moet u die apps configureren om de FCMv1-sleutels te gebruiken voordat u NPS configureert om de NPS-proxy te gebruiken.

  • Als XSP/ADP momenteel de Connect- of UC-One SaaS-app ondersteunt, schakel dan de FCMv1-sleutels in nadat u de NPS-proxy hebt geconfigureerd. We raden u aan alle aanvullende 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).

Samenvatting van de migratie van NPS Proxy

Visueel overzicht van de migratie naar NPS Authentication Proxy
Tabel 1. Samenvatting van de taken om naar NPS Proxy te migreren

Sequentie

Titel van de 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 ze 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 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 (niet-Cisco) Android-apps ondersteunt.

4

Schakel de FCM-legacy-modus opnieuw in.

Als de NPS UC-One SaaS ondersteunt. Als u FCMv1 ingeschakeld laat voordat u de NPS-proxy configureert, dan beginnen de pushmeldingen naar UC-One SaaS te mislukken.

5

Proxy-patches voor NPS-authenticatie installeren.

Als de NPS op XSP R22 of XSP R23 staat.

6

Configureer NPS om de NPS-verificatieproxy te gebruiken:

  • Voeg technische ondersteuning van de NPS toe

  • CI OAuth-account aanvragen

  • Maak een CI-account aan op NPS en configureer de time-out voor het vernieuwen van tokens

  • ID's voor Android-apps toevoegen

  • ID's van iOS-apps toevoegen

  • URL's en verbindingstime-outs controleren/instellen

  • Apps toevoegen aan de AS-toestemplijst

  • FCMv1 (Her-) inschakelen

  • XSP/ADP opnieuw starten

  • PN's testen voor iOS- en Android-apps

Altijd nodig.

7

Verwijder de FCM-toetsen in de oude modus.

Voor apps die succesvol worden ondersteund door NPS op FCMv1.

Migreer de iOS-apps van BroadWorks Collaborate naar HTTP/2

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 om HTTP/2 voor APNS te gebruiken.

1

Stel de productie-URL en de verbindingsparameters in op xsp_cli/applications/notificationPushServer/APNS/Production>

URL instellen https://api.push.apple.com/3/device

verbinding instellen Poolsize 2

ConnectionTimeOut 3000 instellen

Stel de time-out van de verbinding voor inactief gebruik in seconden 600

Opmerking: Stel de verbindingsduur niet lager dan 1000 in.

2

Voeg de toepassings-ID's toe aan de context van de APNS-toepassingen en zorg ervoor dat u de Auth-sleutel weglaat — stel deze in op leeg.

Voor UC-One SaaS: xsp_cli/applications/notificationPushServer/APNS/Production/Tokens> voeg com.broadsoft.uc-one toe

Voor de Webex-app: xsp_cli/applications/notificationPushServer/APNS/Production/Tokens> voeg com.cisco.squared toe

3

Controleer de authenticatiesleutels met xsp_cli/applications/notificationPushServer/APNS/Production/Tokens> get

4

Als de authenticatiesleutel niet leeg is voor com.broadsoft.uc-one, kunt u deze wissen met xsp_cli/applications/notificationPushServer/APNS/Production/Tokens> clear the-authkey

5

HTTP/2 inschakelen:

xsp_cli/applications/notificationPushServer/APNS/GeneralSettings> stel HTTP2-enabled in op true

6

Alleen voor SaaS-apps van UC-One: Meld u aan bij het resellerportaal en ga naar Configuratie > BroadWorks >.

7

Blader omlaag naar de sectie Notification Push Server en selecteer uw release (bijvoorbeeld Release 22) en volg daarna de instructies op de portal.

BroadWorks UC-One Connect/SaaS Android-apps migreren naar FCMv1

  • Deze taak is van toepassing op NPS op XSP. Negeer het als uw NPS op ADP staat.

  • U kunt deze procedure gebruiken om te 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 op FCMv1, zodat u deze kunt inschakelen als onderdeel van de configuratie van de NPS-verificatieproxy. Schakel FCMv1 niet in totdat u klaar bent om de NPS-verificatieproxy te configureren, anders mislukken de meldingen naar SaaS-clients.

1

Haal de project-ID op via de Firebase-console:

  1. Meld u aan op console.firebase.google.com.

  2. Selecteer het project van de UC-One-app (Connect of SaaS) en open de bijbehorende projectinstellingen.

  3. Open het tabblad Algemeen en noteer de project-ID.

2

Vraag de privésleutel van uw serviceaccount aan bij Firebase:

  1. Navigeer naar het tabblad Serviceaccounts in de projectinstellingen.

  2. Of maak een nieuw serviceaccount aan en ontvang de privésleutel.

  3. Of open een bestaand serviceaccount en genereer daarvoor een nieuwe privésleutel.

    Opmerking: Het serviceaccount moet de toestemming firebaseadmin-sdk hebben.

  4. Download de sleutel naar een veilige locatie.

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 het FCM-project:

xsp_cli/applications/NotificationPushServer/FCM/Projects> project-id pad/naar/sleutelbestand toevoegen

5

Voeg de UC-One-toepassing (Connect of SaaS) en de bijbehorende project-ID toe aan de context van de FCM-toepassingen:

xsp_cli/applications/NotificationPushServer/FCM/Applications> toepassings-ID com.broadsoft.connect ProjectID project-id toevoegen

6

Vergelijk de configuratie voor FCM met de kenmerken en aanbevolen waarden die hier worden weergegeven. Gebruik de ingestelde versie van de opdracht om waarden te wijzigen indien nodig:

XSP_CLI/applications/NotificationPushServer/FCM uitvoeren > get

Parameter

Aanbevolen waarde

AuthURL

https://www.googleapis.com/oauth2/v4/token

PushURL

https://fcm.googleapis.com/v1/projects/ PROJECT-ID/berichten:verzenden

toepassingsgebied

https://www.googleapis.com/auth/firebase.messaging

Token heeft de tijd om in enkele seconden te leven

3600

Grootte van de verbindingspool

10

Time-out voor de verbinding in milliseconden

3000

Time-out bij inactiviteit van de verbinding binnen enkele seconden

600

BroadWorks UC-One Connect/SaaS Android-apps migreren naar FCMv1 (op ADP)

  • Deze taak is van toepassing op NPS op ADP. Negeer het als uw NPS op XSP staat.

  • U kunt deze procedure gebruiken om te 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 op FCMv1, zodat u deze kunt inschakelen als onderdeel van de configuratie van de NPS-verificatieproxy. Schakel FCMv1 niet in totdat u klaar bent om de NPS-verificatieproxy te configureren, anders mislukken de meldingen naar SaaS-clients.

1

Haal de project-ID op via de Firebase-console:

  1. Meld u aan op console.firebase.google.com.

  2. Selecteer het project van de UC-One-app (Connect of SaaS) en open de bijbehorende projectinstellingen.

  3. Open het tabblad Algemeen en noteer de project-ID.

2

Vraag de privésleutel van uw serviceaccount aan bij Firebase:

  1. Navigeer naar het tabblad Serviceaccounts in de projectinstellingen.

  2. Of maak een nieuw serviceaccount aan en ontvang de privésleutel.

  3. Of open een bestaand serviceaccount en genereer daarvoor een nieuwe privésleutel.

    Opmerking: Het serviceaccount moet de toestemming firebaseadmin-sdk hebben.

  4. Download de sleutel (.json-bestand) naar een veilige locatie.

3

Importeer het .json-bestand naar de ADP-server /bw/install.

4

Meld u aan bij ADP CLI en voeg het project en de API-sleutel toe aan de context van het FCM-project:

adp_cli/applications/NotificationPushServer/FCM/Projects> connect-ucaas /bw/install/bestandsnaam.json toevoegen

5

Voeg de applicatie en het project-ID toe aan de context van de FCM-toepassingen:

adp_cli/applications/NotificationPushServer/FCM/Applications> toepassings-ID com.broadsoft.ucaas.connect ProjectID project-id toevoegen

6

Controleer uw configuratie:

ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get
Project ID Accountkey
========================
connect-ucaas ********
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas

FCM Legacy-modus opnieuw inschakelen

U hoeft dit alleen te doen (als onderdeel van de migratie) als:

  • Uw NPS wordt gebruikt voor de Android-apps UC-One SaaS of BroadWorks Connect.

  • U hebt al getest of pushmeldingen voor gesprekken naar andere apps werken met de FCMv1 API.

U schakelt FCMv1 tijdelijk uit omdat de FCMv1-sleutels voor deze apps alleen mogen worden ingeschakeld tijdens de configuratie van de NPS-verificatieproxy.

1

Meld u aan bij de XSP die uw gedeelde NPS host.

2

Navigeer naar de FCM-context en schakel FCM v1 uit: xsp_cli/applications/notificationPushServer/FCM> stel v1enabled false in om terug te keren naar het gebruik van de verouderde FCM-API-sleutel.

NPS configureren om een authenticatieproxy te gebruiken

1

Stel een serviceaanvraag in bij uw contactpersoon voor onboarding, of met TAC, om uw OAuth-klantaccount (Webex Common Identity) beschikbaar te stellen. Geef uw serviceverzoek de titel van NPS Configuration for Auth Proxy Setup.

We geven u een OAuth-client-ID, een klantgeheim en een vernieuwingstoken dat 60 dagen geldig is. Als het token verloopt voordat u het met uw NPS gebruikt, kunt u een nieuw verzoek indienen.
2

Maak een klantenaccount aan op de NPS:

xsp_cli/applications/NotificationPushServer/Cisco CI/Client> client-ID instellen vanuit stap 1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Voer de opdracht uit om te controleren of de waarden die u hebt ingevoerd, overeenkomen met de waarden die u hebt gekregen. xsp_cli/applications/NotificationPushServer/Ciscoci/Client> get

3

Voer de URL van de NPS-proxy in en stel het vernieuwingsinterval van de token in (aanbevolen 30 minuten):

FQDN's op basis van de regio:

Oostelijk deel van de VS:

xsp_cli/applications/NotificationPushServer/CloudNPSService> stel de URL in https://broadworks-idp-proxy-a.wbx2.com/nps/

West van de VS:

xsp_cli/applications/NotificationPushServer/CloudNPSService> stel de URL in https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

xsp_cli/applications/NotificationPushServer/CloudNPSService> stel de URL in https://broadworks-idp-proxy-k.wbx2.com/nps/

xsp_cli/Applications/NotificationPushServer/Cloud NPS Service > stel VoIP Token Refresh Interval 1800 in

Saoedi-Arabië:

xsp_cli/applications/NotificationPushServer/CloudNPSService> stel de URL in https://broadworks-idp-proxy-d.wbx2.com/nps/

Australië:

xsp_cli/applications/NotificationPushServer/CloudNPSService> stel de URL in https://broadworks-idp-proxy-m.wbx2.com/nps/

Als er een time-out optreedt bij pushmeldingen vanwege een vertraging in de DNS-resolutie, verhoog dan de time-outwaarde in het bestand „/etc/resolv.conf” op de BroadWorks-server.

4

(Voor Android-meldingen) Voeg de ID's van Android-apps toe aan de context van de FCM-toepassingen op de NPS.

Voor de Webex-app op Android: xsp_cli/applications/notificationPushServer/fcm/Applications> voeg com.cisco.wx2.android toe

Voor de UC-One-app op Android: xsp_cli/applications/NotificationPushServer/FCM/Applications> voeg com.broadsoft.connect toe

5

(Voor Apple iOS meldingen) Voeg de toepassings-ID toe aan de context van de APNS-toepassing en zorg ervoor dat u de Auth-sleutel weglaat — stel deze in op leeg.

Voor de Webex-app op iOS: xsp_cli/applications/notificationPushServer/APNS/Production/Tokens> voeg com.cisco.squared toe

Voor de UC-One-app op iOS: xsp_cli/applications/NotificationPushServer/APNS/Production/Tokens> voeg com.cisco.squared toe

6

Configureer de volgende NPS-URL's:

XSP CLI-context

Parameter

Waarde

xsp_cli/Applications/NotificationPushServer/FCM>

AuthURL

https://www.googleapis.com/oauth2/v4/token

PushURL

https://fcm.googleapis.com/v1/projects//messages:send

toepassingsgebied

https://www.googleapis.com/auth/firebase.messaging

xsp_cli/Applications/NotificationPushServer/APNS/Production>

url

https://api.push.apple.com/3/device

7

Configureer de volgende NPS-verbindingsparameters op de aanbevolen waarden die worden weergegeven:

XSP CLI-context

Parameter

Waarde

xsp_cli/Applications/NotificationPushServer/FCM>

Token heeft de tijd om in enkele seconden te leven

3600

Grootte van de verbindingspool

10

Time-out voor de verbinding in milliseconden

3000

Time-out bij inactiviteit van de verbinding binnen enkele seconden

600

xsp_cli/Applications/NotificationPushServer/APNS/Production>

Time-out voor de verbinding

3000

Grootte van de verbindingspool

2

Time-out bij inactiviteit van de verbinding binnen enkele seconden

600

8

Controleer of de toepassingsserver toepassings-ID's screent, want het kan zijn dat u de Webex-apps aan de toestemmingslijst moet toevoegen:

  1. Voer as_CLI/System/PushNotification uit > haal de waarde van EnforceAllowedApplicationList op en controleer deze. Als dat waar is, moet u deze subtaak voltooien. Sla anders de rest van de subtaak over.

  2. as_cli/system/pushnotification/AllowedApplications > voeg com.cisco.wx2.android „Webex Android” toe

  3. as_cli/system/pushnotification/AllowedApplications > voeg com.cisco.squared „Webex iOS” toe

NPS opnieuw starten en pushmeldingen testen

1

Start de XSP opnieuw:

barestart
2

Test de oproepmeldingen naar Android door te bellen van een BroadWorks-abonnee naar de belclient op Android. Controleer of de oproepmelding op het Android-apparaat verschijnt.

Opmerking: Als de pushmeldingen voor de Android-app UC-One niet meer werken, is het mogelijk dat er een verkeerde configuratie is. Als dit uw situatie is, kunt u als volgt terugkeren naar de oude FCM:

  1. FCMv1 uitschakelen: XSP_CLI/Applications/NotificationPushServer/FCM> stel V1Enabled false in

  2. DSP opnieuw starten: barestart

  3. Controleer uw configuratie.

  4. FCMv1 opnieuw inschakelen en de XSP opnieuw starten.

  5. Herhaal de test.

3

Test de oproepmeldingen naar iOS door te bellen van een BroadWorks-abonnee naar de belende client op iOS. Controleer of de oproepmelding op het iOS-apparaat verschijnt.

Opmerking: Als de pushmeldingen voor de UC-One iOS-applicatie niet meer werken, is het mogelijk dat er een verkeerde configuratie is. Als dit uw situatie is, kunt u terugkeren naar de oude binaire interface met de set HTTP2enabled false

Vond u dit artikel nuttig?
Vond u dit artikel nuttig?