I denne artikkelen
Oversikt over NPS-autentiseringsproxy
dropdown icon
Forutsetninger for NPS-godkjenningsproxy
    Minimumsversjoner og begrensninger for sambosted
    Delt NPS
    APN-er HTTP/2
    Android FCMv1
Sammendrag av NPS Proxy Migrering
Overfør BroadWorks Collaborate iOS-apper til HTTP/2
Overfør BroadWorks UC-One Connect/SaaS Android-apper til FCMv1
Overfør BroadWorks UC-One Connect/SaaS Android-apper til FCMv1 (på ADP)
Aktiver FCM Legacy Mode på nytt
dropdown icon
Installer proxy-oppdateringer for NPS-godkjenning
    R22 Patcher
    R23 Patcher
Konfigurer NPS til å bruke godkjenningsproxy
Start NPS på nytt og test push-varsler
10. oktober 2026 | 1129 visning(er) | 0 personer mente dette var nyttig
Oppdater Cisco BroadWorks NPS for å bruke NPS Proxy: Konfigurasjonsveiledning
list-menuI denne artikkelen
list-menuTilbakemelding?

Finn ut hvordan du oppdaterer Cisco BroadWorks NPS for å bruke NPS Proxy med denne konfigurasjonsveiledningen. Oppdag trinnvise instruksjoner, hensyn og beste fremgangsmåter for sømløs integrasjon og forbedret nettverksytelse.

Oversikt over NPS-autentiseringsproxy

Denne artikkelen beskriver hvordan du konfigurerer en delt NPS til å bruke NPS-godkjenningsproxy, slik at den også kan brukes til å sende anropsvarsler til Webex-apper. Hvis NPS ikke støtter andre apper, kan du følge den forenklede prosedyren i løsningsveiledningen for Webex for BroadWorks.

NPS Proxy Oversikt

For kompatibilitet med Webex for BroadWorks må NPS oppdateres for å støtte NPS Proxy-funksjonen, P ush Server for VoIP i UCaaS.

Funksjonen implementerer et nytt design i Notification Push Server for å løse sikkerhetsproblemet ved å dele private nøkler for push-varslingssertifikater med tjenesteleverandører for mobilklienter. I stedet for å dele push-varslings sertifikater og nøkler med tjenesteleverandøren, bruker NPS et nytt API for å skaffe et kortvarig push-varslingstoken fra UCaaS-backend, og bruker dette tokenet til autentisering med Apples APN-er og Google FCM-tjenester.

Funksjonen forbedrer også muligheten til Notification Push Server til å sende varsler til Android-enheter gjennom den nye Google Firebase Cloud Messaging (FCM) HTTPv1 API.

Forutsetninger for NPS-godkjenningsproxy

XSP (eller Application Delivery Platform ADP) som er vert for NPS, må oppfylle følgende krav:

Minimumsversjoner og begrensninger for sambosted

  • NPS må aktiveres på en dedikert XSP/ADP, og NPS må være den eneste vertsbaserte applikasjonen på serveren. Dette er for å eliminere forstyrrelser i levering av Push-varsler.

  • Det skal bare være én NPS-app i en distribusjon. Hvis du bruker mobil UC-One Collaborate/Connect og/eller UC-One SaaS, og implementerer Webex for BroadWorks, må du dele denne eneste NPS for alle appene.

  • NPS må være på versjon R22 eller nyere XSP, eller ADP.

    R22/R23 XSP er kompatibel med en R21-stabel hvis XSP bare kjører NPS og AS er R21.SP1. Se BroadWorks Compatibility Matrix for mer informasjon.

  • Mer informasjon om ADP-serveren finner du på Cisco BroadWorks Application Deli very Platform.

Delt NPS

Les disse merknadene før du konfigurerer den delte NPS til å bruke NPS-proxyen:

  • Hvis NPS brukes sammen med andre apper (ikke bare Webex-appen): Konfigurer først NPS-proxyen, og endre deretter NPS fra å bruke FCM eldre API til å bruke FCM HTTP v1 API.

  • Når du har bekreftet at varslinger fungerer som de skal for eldre apper med NPS-proxyen, fjerner du FCM API-nøkkelen for Android-appen og APN-autentiseringsnøkkelen for iOS-appen.

APN-er HTTP/2

  • Hvis du har distribuert iOS-apper som ikke er fra Cisco/Broadsoft, konfigurerer du disse appene til å bruke HTTP/2 APNS-protokollen før du konfigurerer NPS til å bruke NPS-proxyen.

  • XSP/ADP-er som allerede støtter Collaborate- eller SaaS BroadWorks-appen, må overføres til HTTP/2. Hvis du vil ha detaljert informasjon om konfigurering av HTTP/2, kan du se HTTP/2-støtte til Notification Push Server for APNS (migrering av NPS for å støtte disse iOS-appene er oppsummert i denne artikkelen).

Android FCMv1

  • Hvis du har distribuert Android-apper som ikke er fra Cisco/Broadsoft, konfigurerer du disse appene til å bruke FCMv1-tastene før du konfigurerer NPS til å bruke NPS-proxyen.

  • Hvis XSP/ADP for øyeblikket støtter Connect- eller UC-One SaaS-appen, aktiverer du FCMv1-nøkler etter at du har konfigurert NPS-proxyen. Vi anbefaler at du overfører alle tilleggsapper til FCMv1-nøkler, aktiverer og tester, og deaktiverer deretter til du er klar til å fullføre installasjonsinstruksjonene (overføringsflyten er dokumentert i denne artikkelen).

Sammendrag av NPS Proxy Migrering

Visuelt sammendrag av migrering til NPS-godkjenningsproxy
Tabell 1. Sammendrag av oppgaver som skal overføres til NPS-proxy

Sekvens

Oppgavetittel

Når/hvorfor er oppgaven nødvendig?

1

Overfør NPS til HTTP/2 for UC-One SaaS (eller Connect) iOS-apper.

Hvis NPS støtter disse appene, og de ennå ikke er konfigurert for HTTP/2.

2

Overfør NPS til FCMv1 for UC-One SaaS (eller Connect) Android-apper.

Hvis NPS støtter disse appene, og de ennå ikke er konfigurert for FCMv1.

3

Aktiver FCMv1-modus, og test push-varsler.

Hvis NPS støtter UC-One Connect og/eller andre (ikke-Cisco) Android-apper.

4

Aktiver FCM-eldre modus på nytt.

Hvis NPS støtter UC-One SaaS. Hvis du lar FCMv1 være aktivert før du konfigurerer NPS-proxyen, begynner push-varsler til UC-One SaaS å mislykkes.

5

Installer proxy-oppdateringer for NPS-godkjenning.

Hvis NPS er på XSP R22 eller XSP R23.

6

Konfigurer NPS til å bruke NPS-godkjenningsproxyen:

  • Legg til teknisk støtte fra NPS

  • Be om CI OAuth-konto

  • Opprett CI-konto på NPS og konfigurer tidsavbrudd for oppdateringstoken

  • Legg til Android-app-ID-er

  • Legg til iOS-app-ID-er

  • Kontroll/angi nettadresser og tilkoblingstidsavbrudd

  • Legg til apper i AS-tillatelseslisten

  • (Re-) Aktiver FCMv1

  • Start XSP/ADP på nytt

  • Test PN-er for iOS- og Android-apper

Alltid påkrevd.

7

Fjern FCM eldre modusnøkler.

For apper som støttes vellykket av NPS på FCMv1.

Overfør BroadWorks Collaborate iOS-apper til HTTP/2

Denne oppgaven er obligatorisk for push-varsler til UC-One SaaS- og Webex-apper på iOS-plattformer.

Før du begynner

Hvis XSP kjører R22, må du bruke ap354313 før du kan konfigurere NPS-programmet til å bruke HTTP/2 for APNS.

1

Angi produksjons-URL og tilkoblingsparametere på X SP_CLI/Applications/NotificationPushServer/APNS/Production>

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

sett tilkoblingPoolstørrelse 2

sett tilkoblingTimeout 3000

angi tilkoblingIdleTimeoutInSeconds 600

Merk: Ikke sett tilkoblingstidsavbruddet under 1000.

2

Legg til applikasjons-ID-ene i APNS-applikasjonskonteksten, og sørg for å utelate Auth-nøkkelen - sett den til tom.

For UC-One SaaS: x sp_CLI/applikasjoner/NotificationPushServer/APNS/Produksjon/Tokens> legg til com.broadsoft.uc-one

For Webex-appen: xsp_CLI/applikasjoner/NotificationPushServer/APNS/Production/Tokens> legg til com.cisco.squared

3

Sjekk autentiseringsnøklene med xsp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> get

4

Hvis autentiseringsnøkkelen ikke er tom for com.broadsoft.uc-one, kan du fjerne den med xsp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> fjern authkey

5

Aktiver HTTP/2:

xsp_CLI /Programmer/NotificationPushServer/APNS/GeneralSettings> sett HTTP2Enabled true

6

Kun for UC-One SaaS-apper: Logg på forhandlerportalen og gå til Konfigurasjon > BroadWorks >.

7

Rull ned til Notification Push Server-delen, og velg utgivelsen din (f.eks. Versjon 22), og følg deretter instruksjonene i portalen.

Overfør BroadWorks UC-One Connect/SaaS Android-apper til FCMv1

  • Denne oppgaven gjelder NPS på XSP. Ignorer det hvis NPS er på ADP.

  • Du kan bruke denne prosedyren for migrering til FCMv1-varsler for UC-One Connect eller UC-One SaaS Android-apper.

  • Du må bruke FCMv1 hvis du vil bruke NPS-proxyen til å godkjenne push-varsler til UC-One eller Webex Android-apper.

  • Denne oppgaven forbereder NPS for FCMv1 slik at du kan aktivere den som en del av konfigurasjonen av NPS-godkjenningsproxy. Ikke aktiver FCMv1 før du er klar til å konfigurere NPS-godkjenningsproxy, ellers mislykkes varsler til SaaS-klienter.

1

Få prosjekt-ID fra Firebase-konsollen:

  1. Logg på console.firebase.google.com.

  2. Velg UC-One (Connect eller SaaS) appprosjekt, åpne prosjektinnstillingene.

  3. Åpne kategorien Generelt og registrer prosjekt-ID-en.

2

Få tjenestekontoens private nøkkel fra Firebase:

  1. Naviger til kategorien Tjenestekontoer i prosjektinnstillingene.

  2. Enten opprett en ny tjenestekonto og få den private nøkkelen.

  3. Eller åpne en eksisterende tjenestekonto og generere en ny privat nøkkel for den.

    Merk: Tjenest ekontoen må ha firebasead min-sdk-tillatelsen.

  4. Last ned nøkkelen til et sikkert sted.

3

Kopier nøkkelen til XSP som er vert for NPS.

4

Legg til prosjekt-ID og tilknyttet privat nøkkel i FCM-prosjektkonteksten:

xsp_CLI /applikasjoner/NotificationPushServer/FCM/Prosjekts> legg til prosjekt-id-bane/til/nøkkelfil

5

Legg til UC-One-programmet (Connect eller SaaS) og tilhørende prosjekt-ID i FCM-applikasjonskonteksten:

xsp_cli/applikasjoner/NotificationPushServer/FCM/Programmer> legg til applik asjons-ID com.broadsoft.connect prosjektID prosjekt-id

6

Kontroller konfigurasjonen for FCM mot attributtene og anbefalte verdiene som vises her. Bruk angitt versjon av kommandoen for å endre verdier om nødvendig:

Kjør xsp _CLI/applikasjoner/NotificationPushServer/FCM> get

Parameter

Anbefalt verdi

AuthURL

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

PushUrl

https://fcm.googleapis.com/v1/projects/ PROSJEK T-ID /meldinger:send

omfang

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

TokenTimeOliveInSeconds

3600

TilkoblingPoolstørrelse

10

TilkoblingTimeouti millisekunder

3000

TilkoblingIdleTimeoutInSeconds

600

Overfør BroadWorks UC-One Connect/SaaS Android-apper til FCMv1 (på ADP)

  • Denne oppgaven gjelder NPS på ADP. Ignorer det hvis NPS er på XSP.

  • Du kan bruke denne prosedyren for migrering til FCMv1-varsler for UC-One Connect eller UC-One SaaS Android-apper.

  • Du må bruke FCMv1 hvis du vil bruke NPS-proxyen til å godkjenne push-varsler til UC-One eller Webex Android-apper.

  • Denne oppgaven forbereder NPS for FCMv1 slik at du kan aktivere den som en del av konfigurasjonen av NPS-godkjenningsproxy. Ikke aktiver FCMv1 før du er klar til å konfigurere NPS-godkjenningsproxy, ellers mislykkes varsler til SaaS-klienter.

1

Få prosjekt-ID fra Firebase-konsollen:

  1. Logg på console.firebase.google.com.

  2. Velg UC-One (Connect eller SaaS) appprosjekt, åpne prosjektinnstillingene.

  3. Åpne kategorien Generelt og registrer prosjekt-ID-en.

2

Få tjenestekontoens private nøkkel fra Firebase:

  1. Naviger til kategorien Tjenestekontoer i prosjektinnstillingene.

  2. Enten opprett en ny tjenestekonto og få den private nøkkelen.

  3. Eller åpne en eksisterende tjenestekonto og generere en ny privat nøkkel for den.

    Merk: Tjenest ekontoen må ha firebasead min-sdk-tillatelsen.

  4. Last ned nøkkelen (.json-fil) til et sikkert sted.

3

Importere.json-filen til ADP-serveren /bw/install.

4

Logg inn på ADP CLI og legg til prosjektet og API-nøkkelen i FCM-prosjektkonteksten:

adp_cli/applikasjoner/notificationpushserver/fcm/prosjekter> legg til connect-ucaas /bw/install/filnavn.json

5

Legg til applikasjons- og prosjekt-ID i FCM-applikasjonskonteksten:

adp_cli/applikasjoner/NotificationPushServer/FCM/Programmer> legg til applik asjons-ID com.broadsoft.ucaas.connect prosjektID prosjekt-id

6

Bekreft konfigurasjonen din:

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

Aktiver FCM Legacy Mode på nytt

Du trenger bare å gjøre dette (som en del av migreringen) hvis:

  • NPS brukes til UC-One SaaS eller BroadWorks Connect Android-apper.

  • Du har allerede testet at push-varsler for anrop til andre apper fungerer med FCMv1 API.

Du deaktiverer FCMv1 midlertidig fordi FCMv1-nøkler for disse appene bare må aktiveres under konfigurasjonsprosessen for proxy for NPS-godkjenning.

1

Logg på XSP-en som er vert for den delte NPS.

2

Naviger til FCM-konteksten og deaktiver FCM v1: XSP_CLI/Applications/NotificationPushServer/ FCM> sett V1Enabled false for å gå tilbake til bruk av FCM eldre API-nøkkel.

Konfigurer NPS til å bruke godkjenningsproxy

1

Opprett en tjenesteforespørsel med onboardingkontakten din, eller med TAC, for å klargjøre din (Webex Common Identity) OAuth-klientkonto. Tittel tjenesteforespørselen din NPS-konfigurasjon for Auth Proxy Setup.

Vi gir deg en OAuth-klient-ID, en klienthemmelighet og et oppdateringstoken som er gyldig i 60 dager. Hvis tokenet utløper før du bruker det med NPS, kan du sende en ny forespørsel.
2

Opprett klientkontoen på NPS:

XSP_CLI/Programmer/NotificationPushServer/Ciscoci/Client> angi ClientID Client-ID fra-Step1

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

Kjør kommandoen for å bekrefte at verdiene du skrev inn samsvarer med de som ble gitt til deg. xsp_CLI/applikasjoner/NotificationPushServer/Ciscoci/Client> få

3

Skriv inn NPS-proxy-URL-adressen, og angi oppdateringsintervallet for token (30 minutter anbefales):

Regionbaserte FQDNer:

USA øst:

xsp_cli /applikasjoner/NotificationPushServer/CloudNPSService> angi url https://broadworks-idp-proxy-a.wbx2.com/nps/

USA vest:

xsp_cli /applikasjoner/NotificationPushServer/CloudNPSService> angi url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

xsp_cli /applikasjoner/NotificationPushServer/CloudNPSService> angi url https://broadworks-idp-proxy-k.wbx2.com/nps/

xsp_CLI /Programmer/NotificationPushServer/CloudNPSService> sett VoipTokenRefreshInterval 1800

Saudi-Arabia:

xsp_cli /applikasjoner/NotificationPushServer/CloudNPSService> angi url https://broadworks-idp-proxy-d.wbx2.com/nps/

Australia:

xsp_cli /applikasjoner/NotificationPushServer/CloudNPSService> angi url https://broadworks-idp-proxy-m.wbx2.com/nps/

Hvis push-varsler går ut på grunn av en forsinkelse i DNS-oppløsningen, øker du timeout-verdien i filen «/etc/resolv.conf» på BroadWorks-serveren.

4

(For Android-varsler) Legg til Android-applikasjons-ID-ene i FCM-applikasjonskonteksten på NPS.

For Webex-appen på Android: XSP _CLI/applikasjoner/NotificationPushServer/FCM/Programmer> legg til com.cisco.wx2.android

For UC-One App på Android: x sp_CLI/applikasjoner/NotificationPushServer/FCM/applikasjoner> legg til com.broadsoft.connect

5

(For Apple iOS varsler) Legg til applikasjons-ID-en i APNS-applikasjonskonteksten, og sørg for å utelate Auth-tasten - sett den til tom.

For Webex-appen på iOS: XSP _CLI/Applications/NotificationPushServer/APNS/Production/Tokens> legg til com.cisco.squared

For UC-One-app på iOS: x sp_CLI/applikasjoner/NotificationPushServer/APNS/Production/Tokens> legg til com.cisco.squared

6

Konfigurer følgende NPS-URL-adresser:

XSP CLI-kontekst

Parameter

Verdi

xsp_CLI/Programmer/NotificationPushServer/FCM>

AuthURL

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

PushUrl

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

omfang

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

xsp_CLI/Programmer/NotificationPushServer/APNS/Produksjon>

nettadresse

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

7

Konfigurer følgende NPS-tilkoblingsparametere til de anbefalte verdiene som vises:

XSP CLI-kontekst

Parameter

Verdi

xsp_CLI/Programmer/NotificationPushServer/FCM>

TokenTimeOliveInSeconds

3600

TilkoblingPoolstørrelse

10

TilkoblingTimeouti millisekunder

3000

TilkoblingIdleTimeoutInSeconds

600

xsp_CLI/Programmer/NotificationPushServer/APNS/Produksjon>

TilkoblingTidsavbrudd

3000

TilkoblingPoolstørrelse

2

TilkoblingIdleTimeoutInSeconds

600

8

Sjekk om applikasjonsserveren screener applikasjons-ID-er, fordi du kanskje må legge til Webex-appene i tillatelseslisten:

  1. Kjør as_CLI/System/PushNotification> get og sjekk verdien av EnforceAllowedApplicationList. Hvis det er sant, må du fullføre denne underoppgaven. Ellers hopper du over resten av underoppgaven.

  2. as_cli/System/Push Notification/AllowedApplications> legg til com.cisco.wx2.android «Webex Android»

  3. as_cli/System/Push Notification/AllowedApplications> legg til com.cisco.squared «Webex iOS»

Start NPS på nytt og test push-varsler

1

Start XSP på nytt:

bwstart
2

Test samtalevarsler til Android ved å ringe fra en BroadWorks-abonnent til den anropende klienten på Android. Kontroller at anropsvarsling vises på Android-enheten.

Merk: Hvis push-varsler begynner å mislykkes for UC-One android-applikasjonen, er det mulig at det er en feilkonfigurasjon. Hvis dette er din situasjon, kan du gå tilbake til eldre FCM på følgende måte:

  1. Deaktiver FCMv1: XSP _CLI/applikasjoner/NotificationPushServer/FCM> sett V1Enabled false

  2. Start XSP på nytt: bwrestart

  3. Sjekk konfigurasjonen din.

  4. Aktiver FCMv1 på nytt og start XSP på nytt.

  5. Gjenta testen.

3

Test samtalevarsler til iOS ved å ringe fra en BroadWorks-abonnent til den anropende klienten på iOS. Kontroller at anropsvarsling vises på iOS-enheten.

Merk: Hvis push-varsler begynner å mislykkes for UC-One iOS-applikasjonen, er det mulig at det er en feilkonfigurasjon. Hvis dette er din situasjon, kan du gå tilbake til det eldre binære grensesnittet med sett http 2enabled false

Var denne artikkelen nyttig?
Var denne artikkelen nyttig?
PriserWebex-appMøterCallingMeldingerSkjermdeling
Webex SuiteCallingMøterMeldingerSlidoNettseminarEventsKontaktsenterCPaaSSikkerhetControl Hub
HodesettKameraerSkrivebord-serienRomserieTavleserieTelefonserieTilbehør
UtdanningHelsetjenesterRegjeringFinansSport og underholdningFrontlineIdeelle organisasjonerOppstartsbedrifterHybridarbeid
NedlastingerBli med på et testmøteNettbaserte timerIntegreringerTilgjengelighetInkluderingDirektesendte og nedlastbare webinarerWebex-fellesskapetWebex-utviklereNyheter og innovasjoner
CiscoKontakt supportKontakt salgWebex BlogWebex-tankelederskapWebex-varebutikkKarrierer
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Vilkår og betingelserPersonvernerklæringInformasjonskapslerVaremerker
©2026 Cisco og/eller tilknyttede selskaper. Med enerett.
Vilkår og betingelserPersonvernerklæringInformasjonskapslerVaremerker