I den här artikeln
Översikt över NPS-autentiseringsproxy
dropdown icon
Förutsättningar för NPS-autentiseringsproxy
    Minimiversioner och begränsningar för sambosättning
    Delad NPS
    APN:er HTTP/2
    Android FCMv1
Sammanfattning av NPS-proxymigrering
Migrera BroadWorks Collaborate iOS-appar till HTTP/2
Migrera BroadWorks UC-One Connect/SaaS Android-appar till FCMv1
Migrera BroadWorks UC-One Connect/SaaS Android-appar till FCMv1 (på ADP)
Återaktivera FCM Legacy Mode
dropdown icon
Installera proxykorrigeringar för NPS-autentisering
    R22-plåster
    R23-patchar
Konfigurera NPS för att använda autentiseringsproxy
Starta om NPS och testa push-meddelanden
10 oktober 2026 | 1129 visning(ar) | 0 personer tyckte att detta var till hjälp
Uppdatera Cisco BroadWorks NPS för att använda NPS Proxy: Konfigurationsguide
list-menuI den här artikeln
list-menuHar du feedback?

Lär dig hur du uppdaterar Cisco BroadWorks NPS för att använda NPS Proxy med den här konfigurationsguiden. Upptäck steg-för-steg-instruktioner, överväganden och bästa praxis för sömlös integration och förbättrad nätverksprestanda.

Översikt över NPS-autentiseringsproxy

I den här artikeln beskrivs hur du konfigurerar en delad NPS för att använda NPS-autentiseringsproxy, så att den också kan användas för att skicka samtalsmeddelanden till Webex-appar. Om din NPS inte stöder andra appar kan du följa den förenklade proceduren i Webex för BroadWorks Solution Guide.

Översikt över NPS Proxy

För kompatibilitet med Webex för BroadWorks måste din NPS korrigeras för att stödja funktionen NPS Proxy, P ush Server för VoIP i UCaaS.

Funktionen implementerar en ny design i Notification Push Server för att lösa säkerhetssårbarheten för att dela privata nycklar för push-aviseringscertifikat med tjänsteleverantörer för mobilklienter. Istället för att dela push-meddelandec ertifikat och nycklar med tjänsteleverantören använder NPS ett nytt API för att få en kortlivad push-meddelandetoken från UCaaS-backend och använder denna token för autentisering med Apples APN och Google FCM-tjänster.

Funktionen förbättrar också möjligheten för Notification Push Server att skicka aviseringar till Android-enheter via det nya Google Firebase Cloud Messaging (FCM) HTTPv1 API.

Förutsättningar för NPS-autentiseringsproxy

XSP (eller Application Delivery Platform ADP) som är värd för NPS måste uppfylla följande krav:

Minimiversioner och begränsningar för sambosättning

  • NPS måste aktiveras på en dedikerad XSP/ADP och NPS måste vara den enda värdbaserade applikationen på servern. Detta för att eliminera störningar i leveransen av Push-meddelanden.

  • Det bör bara finnas en NPS-app i en distribution. Om du använder mobil UC-One Collaborate/Connect och/eller UC-One SaaS och implementerar Webex för BroadWorks måste du dela denna enda NPS för alla appar.

  • NPS måste vara på version R22 eller senare XSP, eller ADP.

    R22/R23 XSP är kompatibel med en R21-stack om XSP endast kör NPS och AS är R21.SP1. Se BroadWorks Compatibility Matrix för mer information.

  • Mer information om ADP-servern finns på Cisco BroadWorks Application Deli very Platform.

Delad NPS

Läs dessa anteckningar innan du konfigurerar din delade NPS för att använda NPS-proxyservern:

  • Om din NPS används med andra appar (inte bara Webex-appen): Konfigurera först NPS-prox yn och ändra sedan NPS från att använda FCM äldre API till att använda FCM HTTP v1 API.

  • När du har verifierat att aviseringar fungerar korrekt för äldre appar med NPS-proxyn tar du bort FCM API-nyckeln för Android-appen och APN-autentiseringsnyckeln för iOS-appen.

APN:er HTTP/2

  • Om du har distribuerat iOS-appar som inte kommer från Cisco/Broadsoft konfigurerar du dessa appar så att de använder HTTP/2 APNS-protokollet innan du konfigurerar NPS för att använda NPS-proxyn.

  • XSP/ADP som redan stöder Collaborate- eller SaaS BroadWorks-appen måste migreras till HTTP/2. För detaljerad information om hur du konfigurerar HTTP/2, se HTTP/2-stöd till notifieringspush Server för APNS (migrering av NPS för att stödja dessa iOS-appar sammanfattas i den här artikeln).

Android FCMv1

  • Om du har distribuerat Android-appar som inte kommer från Cisco/Broadsoft konfigurerar du dessa appar så att de använder FCMv1-tangenterna innan du konfigurerar NPS för att använda NPS-proxyn.

  • Om XSP/ADP för närvarande stöder Connect- eller UC-One SaaS-appen aktiverar du FCMv1-nycklar när du har konfigurerat NPS-proxyn. Vi rekommenderar att du migrerar alla ytterligare appar till FCMv1-nycklar, aktiverar och testar och sedan inaktiverar tills du är redo att slutföra installationsanvisningarna (migreringsflödet dokumenteras i den här artikeln).

Sammanfattning av NPS-proxymigrering

Visuell sammanfattning av migrering till NPS-autentiseringsproxy
Tabell 1. Sammanfattning av uppgifter som ska migreras till NPS-proxy

Sekvens

Uppgiftstitel

När/varför krävs en uppgift?

1

Migrera NPS till HTTP/2 för UC-One SaaS (eller Connect) iOS-appar.

Om NPS stöder dessa appar, och de ännu inte är konfigurerade för HTTP/2.

2

Migrera NPS till FCMv1 för UC-One SaaS (eller Connect) Android-appar.

Om NPS stöder dessa appar, och de ännu inte är konfigurerade för FCMv1.

3

Aktivera FCMv1-läge och testa push-aviseringar.

Om NPS stöder UC-One Connect och/eller andra (icke-Cisco) Android-appar.

4

Återaktivera FCM äldre läge.

Om NPS stöder UC-One SaaS. Om du lämnar FCMv1 aktiverat, innan du konfigurerar NPS-proxyn, börjar push-aviseringar till UC-One SaaS misslyckas.

5

Installera proxykorrigeringar för NPS-autentisering.

Om NPS är på XSP R22 eller XSP R23.

6

Konfigurera NPS för att använda NPS-autentiseringsproxyn:

  • Bifoga teknisk support från NPS

  • Begär CI OAuth-konto

  • Skapa CI-konto på NPS och konfigurera timeout för uppdateringstoken

  • Lägg till Android-app-id

  • Lägg till iOS-app-id

  • Kontrollera/ställ in webbadresser och anslutningstidsgränser

  • Lägg till appar i AS-tillståndslista

  • (Re-) Aktivera FCMv1

  • Starta om XSP/ADP

  • Testa PNs för iOS- och Android-appar

Alltid nödvändigt.

7

Ta bort FCM äldre lägesnycklar.

För appar som stöds av NPS på FCMv1.

Migrera BroadWorks Collaborate iOS-appar till HTTP/2

Denna uppgift är obligatorisk för push-meddelanden till UC-One SaaS- och Webex-appar på iOS-plattformar.

Innan du börjar

Om din XSP kör R22 måste du använda ap354313 innan du kan konfigurera NPS-programmet för att använda HTTP/2 för APNS.

1

Ställ in produktions-URL och anslutningsparametrar på X SP_CLI/Applications/NotificationPushServer/APNS/Production>

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

Ställ in anslutningPoolStorlek 2

Ställ in anslutningTimeout 3000

ställ in anslutningIdleTimeoutInSeconds 600

Obs! Ställ inte in anslutningstiden under 1000.

2

Lägg till applikations-ID:n i APNS-programkontexten, se till att utelämna Auth-nyckeln — ställ in den till tom.

För UC-One SaaS: x sp_CLI/applikationer/NotificationPushServer/APNS/Produktion/Tokens> lägg till com.broadsoft.uc-one

För Webex-appen: XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> lägg till com.cisco.squared

3

Kontrollera autentiseringsnycklarna med xsp_cli/Applications/NotificationPushServer/APNS/Production/Tokens> get

4

Om autentiseringsnyckeln inte är tom för com.broadsoft.uc-one kan du rensa den med xsp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> rensa authkey

5

Aktivera HTTP/2:

xsp_CLI /Program/NotificationPushServer/APNS/GeneralSettings> ställ in HTTP2Enabled true

6

Endast för UC-One SaaS-appar: Logga in på återförsäljarportalen och gå till Konfiguration > BroadWorks >.

7

Bläddra ner till avsnittet Notification Push Server och välj din version (t.ex. Rel ease 22) och följ sedan instruktionerna i portalen.

Migrera BroadWorks UC-One Connect/SaaS Android-appar till FCMv1

  • Den här uppgiften gäller för NPS på XSP. Ignorera det om din NPS är på ADP.

  • Du kan använda den här proceduren för att migrera till FCMv1-aviseringar för UC-One Connect eller UC-One SaaS Android-appar.

  • Du måste använda FCMv1 om du vill använda NPS-proxy för att autentisera push-meddelanden till UC-One eller Webex Android-appar.

  • Den här uppgiften förbereder NPS för FCMv1 så att du kan aktivera den som en del av konfigurationen av NPS-autentiseringsproxy. Aktivera inte FCMv1 förrän du är redo att konfigurera NPS-autentiseringsproxy, annars misslyckas meddelanden till SaaS-klienter.

1

Hämta projekt-ID från Firebase-konsolen:

  1. Logga in på console.firebase.google.com.

  2. Välj UC-One (Connect eller SaaS) appprojekt, öppna dess projektinställningar.

  3. Öppna fliken Allmän t och registrera projekt-ID.

2

Hämta ditt servicekontos privata nyckel från Firebase:

  1. Navigera till fliken Servicekonton i projektinställningarna.

  2. Antingen skapa ett nytt servicekonto och få sin privata nyckel.

  3. Eller öppna ett befintligt servicekonto och skapa en ny privat nyckel för det.

    Obs! Serv icekontot måste ha behörigheten firebasead min-sdk.

  4. Ladda ner nyckeln till en säker plats.

3

Kopiera nyckeln till XSP som är värd för din NPS.

4

Lägg till projekt-ID och tillhörande privat nyckel i FCM-projektkontexten:

xsp_CLI /Applications/NotificationPushServer/FCM/Projects> lägg till projekt-id-sökväg/till/nyckelfil

5

Lägg till UC-One-programmet (Connect eller SaaS) och tillhörande projekt-ID i FCM-programkontexten:

xsp_CLI/Program/NotificationPushServer/FCM/Program> lägg till applik ationID com.broadsoft.connect ProjectID projekt-id

6

Kontrollera konfigurationen för FCM mot de attribut och rekommenderade värden som visas här. Använd den inställ da versionen av kommandot för att ändra värden vid behov:

Kör xsp _CLI/applikationer/NotificationPushServer/FCM> get

Parameter

Rekommenderat värde

AuthURL

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

PushUrl

https://fcm.googleapis.com/v1/projects/ PROJEKT- ID /meddelanden:skicka

omfattning

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

TokenTimeOliveinSeconds

3600

AnslutningPoolstorlek

10

AnslutningTimeoutInmillisekunder

3000

AnslutningIdleTimeoutInSeconds

600

Migrera BroadWorks UC-One Connect/SaaS Android-appar till FCMv1 (på ADP)

  • Denna uppgift gäller för NPS på ADP. Ignorera det om din NPS är på XSP.

  • Du kan använda den här proceduren för att migrera till FCMv1-aviseringar för UC-One Connect eller UC-One SaaS Android-appar.

  • Du måste använda FCMv1 om du vill använda NPS-proxy för att autentisera push-meddelanden till UC-One eller Webex Android-appar.

  • Den här uppgiften förbereder NPS för FCMv1 så att du kan aktivera den som en del av konfigurationen av NPS-autentiseringsproxy. Aktivera inte FCMv1 förrän du är redo att konfigurera NPS-autentiseringsproxy, annars misslyckas meddelanden till SaaS-klienter.

1

Hämta projekt-ID från Firebase-konsolen:

  1. Logga in på console.firebase.google.com.

  2. Välj UC-One (Connect eller SaaS) appprojekt, öppna dess projektinställningar.

  3. Öppna fliken Allmän t och registrera projekt-ID.

2

Hämta ditt servicekontos privata nyckel från Firebase:

  1. Navigera till fliken Servicekonton i projektinställningarna.

  2. Antingen skapa ett nytt servicekonto och få sin privata nyckel.

  3. Eller öppna ett befintligt servicekonto och skapa en ny privat nyckel för det.

    Obs! Serv icekontot måste ha behörigheten firebasead min-sdk.

  4. Ladda ner nyckeln (.json-fil) till en säker plats.

3

Importera filen.json till ADP-servern /bw/install.

4

Logga in på ADP CLI och lägg till projektet och API-nyckeln i FCM-projektets sammanhang:

adp_cli/applikationer/NotificationPushServer/FCM/Projects> lägg till connect-ucaas /bw/install/filnamn.json

5

Lägg till program- och projekt-ID i FCM-programkontexten:

adp_cli/applikationer/NotificationPushServer/FCM/Program> lägg till applik ationID com.broadsoft.ucaas.connect ProjectID projekt-id

6

Verifiera din konfiguration:

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

Återaktivera FCM Legacy Mode

Du behöver bara göra detta (som en del av migreringen) om:

  • Din NPS används för UC-One SaaS eller BroadWorks Connect Android-appar.

  • Du har redan testat att push-meddelanden för samtal till andra appar fungerar med FCMv1 API.

Du inaktiverar tillfälligt FCMv1 eftersom FCMv1-nycklar för dessa appar endast måste aktiveras under konfigurationsprocessen för NPS-autentiseringsproxy.

1

Logga in på XSP som är värd för din delade NPS.

2

Navigera till FCM-sammanhanget och inaktivera FCM v1: xsp_CLI/Applications/NotificationPushServer/ fcm> ställ in V1enabled false för att återgå till att använda FCM äldre API-nyckel.

Konfigurera NPS för att använda autentiseringsproxy

1

Skapa en serviceförfrågan med din onboardingkontakt eller med TAC för att tillhandahålla ditt (Webex Common Identity) OAuth-klientkonto. Namnge din serviceförfrågan NPS-konfiguration för inställning av autentiseringsproxy.

Vi ger dig ett OAuth-klient-ID, en klienthemlighet och en uppdateringstoken som är giltig i 60 dagar. Om token löper ut innan du använder den med din NPS kan du ta upp en ny begäran.
2

Skapa klientkontot på NPS:

xsp_CLI/Program/NotificationPushServer/Ciscoci/Client> ställ in klientID-klient-ID från-steg1

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

Kör kommandot för att verifiera att de värden du angav matchar de som du har angett. xsp_CLI/Program/NotificationPushServer/Ciscoci/Client> få

3

Ange NPS-proxy-webbadressen och ställ in tokenuppdateringsintervallet (30 minuter rekommenderas):

Regionbaserade FQDN:

USA öst:

xsp_CLI /Program/NotificationPushServer/CloudNPSService> ange url https://broadworks-idp-proxy-a.wbx2.com/nps/

USA väst:

xsp_CLI /Program/NotificationPushServer/CloudNPSService> ange url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

xsp_CLI /Program/NotificationPushServer/CloudNPSService> ange url https://broadworks-idp-proxy-k.wbx2.com/nps/

xsp_CLI /Program/NotificationPushServer/CloudNPSService> ställ in VoipTokenRefreshInterval 1800

Saudiarabien:

xsp_CLI /Program/NotificationPushServer/CloudNPSService> ange url https://broadworks-idp-proxy-d.wbx2.com/nps/

Australien:

xsp_CLI /Program/NotificationPushServer/CloudNPSService> ange url https://broadworks-idp-proxy-m.wbx2.com/nps/

Om push-aviseringar går ut på grund av en fördröjning i DNS-upplösningen ökar du timeout-värdet i filen ”/etc/resolv.conf” på BroadWorks-servern.

4

(För Android-aviseringar) Lägg till Android-applikations-ID:n i FCM-programkontexten på NPS.

För Webex-appen på Android: XSP_CLI/Applications/NotificationPushServer/FCM/Applications> lägg till com.cisco.wx2. android

För UC-One App på Android: X SP_CLI/Applications/NotificationPushServer/FCM/Applications> lägg till com.broadsoft.connect

5

(För Apple iOS aviseringar) Lägg till program-ID i APNS-applikationskontexten, se till att utelämna Auth-nyckeln - ställ in den till tom.

För Webex-appen på iOS: xsp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> lägg till com.cisco.squared

För UC-One-app på iOS: x sp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> lägg till com.cisco.squared

6

Konfigurera följande NPS-webbadresser:

XSP CLI-sammanhang

Parameter

Värde

xsp_CLI/Program/NotificationPushServer/FCM>

AuthURL

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

PushUrl

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

omfattning

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

xsp_CLI/Program/NotificationPushServer/APNS/Produktion>

webbadress

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

7

Konfigurera följande NPS-anslutningsparametrar till de rekommenderade värden som visas:

XSP CLI-sammanhang

Parameter

Värde

xsp_CLI/Program/NotificationPushServer/FCM>

TokenTimeOliveinSeconds

3600

AnslutningPoolstorlek

10

AnslutningTimeoutInmillisekunder

3000

AnslutningIdleTimeoutInSeconds

600

xsp_CLI/Program/NotificationPushServer/APNS/Produktion>

AnslutningTimeout

3000

AnslutningPoolstorlek

2

AnslutningIdleTimeoutInSeconds

600

8

Kontrollera om programservern granskar program-ID:n, eftersom du kan behöva lägga till Webex-apparna i tillåtlistan:

  1. Kör as_CLI/System/PushNotification> get och kontrollera värdet på EnforceAllowedApplicationList. Om det är sant måste du slutföra den här underuppgiften. Annars hoppar du över resten av underuppgiften.

  2. as_cli/System/Push Notification/AllowedApplications> lägg till com.cisco.wx2.android ”Webex Android”

  3. as_cli/System/Push Notification/AllowedApplications> lägg till com.cisco.squared ”Webex iOS”

Starta om NPS och testa push-meddelanden

1

Starta om XSP:

bwrestart
2

Testa samtalsmeddelanden till Android genom att ringa samtal från en BroadWorks-abonnent till den samtalsklienten på Android. Kontrollera att samtalsmeddelandet visas på Android-enheten.

Obs! Om push-meddelanden börjar misslyckas för UC-One Android-applikationen är det möjligt att det finns en felkonfiguration. Om detta är din situation kan du återgå till den äldre FCM på följande sätt:

  1. Inaktivera FCMv1: XSP _CLI/Programs/NotificationPushServer/FCM> ställ in V1Enabled false

  2. Starta om XSP: bwrestart

  3. Kontrollera din konfiguration.

  4. Återaktivera FCMv1 och starta om XSP.

  5. Upprepa testet.

3

Testa samtalsmeddelanden till iOS genom att ringa samtal från en BroadWorks-abonnent till den uppringande klienten på iOS. Kontrollera att samtalsmeddelandet visas på iOS-enheten.

Obs! Om push-meddelanden börjar misslyckas för UC-One iOS-applikationen är det möjligt att det finns en felkonfiguration. Om detta är din situation kan du återgå till det äldre binära gränssnittet med inställningen http 2enabled false

Var den här artikeln användbar?
Var den här artikeln användbar?
PrissättningWebex-appenMötenCallingMeddelandenSkärmdelning
Webex SuiteCallingMötenMeddelandenSlidoWebbseminarierEventsContact CenterCPaaSSäkerhetControl Hub
HeadsetKamerorSkrivbordsserieRoom-serienBoard-serienTelefonserienTillbehör
UtbildningHälso- och sjukvårdStatliga myndigheterEkonomiSport och nöjeFrontlinjeIdeella organisationerNystartade företagHybridarbete
HämtningarDelta i ett testmöteOnlinekurserIntegreringarHjälpmedelInklusivitetWebbseminarier live och på begäranWebex CommunityWebex för utvecklareNyheter och innovationer
CiscoKontakta supportKontakta försäljningsavdelningenWebex BlogWebex tankeledarskapWebex Merch StoreJobba hos oss
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
VillkorSekretesspolicyCookiesVarumärken
©2026 Cisco och/eller dess dotterbolag. Med ensamrätt.
VillkorSekretesspolicyCookiesVarumärken