05. juni 2025 | 29 visning(er) | 0 personer mente dette var nyttig

Konfigurer push-varsler for anrop for Webex BroadWorks

list-menuTilbakemelding?
Lær hvordan du konfigurerer push-varsler for anrop for Webex for BroadWorks ved hjelp av NPS for Android og iOS.

I dette dokumentet bruker vi begrepet Call Notifications Push Server (CNPS) for å beskrive en XSP-hostet eller ADP-hostet applikasjon som kjører i miljøet ditt. CNPS-systemet ditt samarbeider med BroadWorks-systemet ditt for å være oppmerksom på innkommende anrop til brukerne dine, og sender varsler om disse til varslingstjenestene Google Firebase Cloud Messaging (FCM) eller Apple Push Notification Service (APNs).

Disse tjenestene varsler mobilenhetene til Webex for Cisco BroadWorks-abonnenter om at de har innkommende anrop på Webex.

Hvis du vil ha mer informasjon om NPS, kan du se Beskrivelse av funksjonen for varslingspushserver.

En lignende mekanisme i Webex fungerer med Webex-meldings- og tilstedeværelsestjenester for å sende varsler til Googles (FCM) eller Apples (APNS) varslingstjenester. Disse tjenestene varsler deretter mobilbrukerne av Webex om innkommende meldinger eller endringer i tilstedeværelse.

Denne delen beskriver hvordan du konfigurerer NPS for autentiseringsproxy når NPS ikke allerede støtter andre apper. Hvis du trenger å migrere en delt NPS for å bruke NPS-proxy, kan du se Oppdatere Cisco BroadWorks NPS for å bruke NPS-proxy.

Oversikt over NPS-proxy

For kompatibilitet med Webex for Cisco BroadWorks må CNPS-en din oppdateres for å støtte NPS Proxy-funksjonen, Push Server for VoIP i UCaaS.

Funksjonen implementerer en ny design i Notification Push Server for å løse sikkerhetsproblemet ved deling av private nøkler for push-varslingssertifikater med tjenesteleverandører for mobilklienter. I stedet for å dele push-varslingssertifikater og nøkler med tjenesteleverandøren, bruker NPS et nytt API for å hente et kortvarig push-varslingstoken fra Webex for Cisco BroadWorks-backend, og bruker dette tokenet for autentisering med Apple APN-er og Google FCM-tjenester.

Funksjonen forbedrer også muligheten til at Notification Push Server kan sende varsler til Android-enheter via det nye Google Firebase Cloud Messaging (FCM) HTTPv1 API-et.

APNS-hensyn

Apple vil ikke lenger støtte HTTP/1-based binærprotokoll på Apple Push Notification-tjenesten etter 31. mars 2021. Vi anbefaler at du konfigurerer XSP|ADP-en din til å bruke HTTP/2-based grensesnitt for APN-er. Denne oppdateringen krever at XSP|ADP-en som er vert for NPS-en kjører R22 eller nyere.

Klargjør NPS-en din for Webex for Cisco BroadWorks

1

Installer og konfigurer en dedikert XSP (minimumsversjon R22) eller Application Delivery Platform (ADP).

2

Installer NPS-autentiseringsproxy-oppdateringene:

XSP R22-oppdateringer:

XSP R23-oppdateringer:

3

Aktiver varslingspushserver-applikasjonen.

4

(For Android-varsler) Aktiver FCM v1 API-et på NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(For Apple iOS-varsler) Aktiver HTTP/2 på NPS.

XSP_CLI/Applications/NotificationPushServer/APNS/GeneralSettings> set HTTP2Enabled true

Dette er eksklusivt for versjon 22 og tidligere versjoner; det er ikke tilgjengelig i versjon 23 og nyere versjoner, som bare støtter HTTP/2.

6

Koble til en teknisk støtte fra NPS XSP/ADP.

7

På hver AS-server må namedefs-filen i /usr/local/broadworks/bw_base/conf konfigureres med SRV- og A-poster for Notification Push Server (XSP/ADP) oppslag, hvis flere XSP/ADP legg deretter til en oppføring for hver etter behov.

Eksempel: _pushnotification-klient._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149

Når det er angitt, kreves ett av følgende for å registrere endringene:

  1. En omstart vil bli utført i et vedlikeholdsvindu.

  2. Via Cisco BroadWorks CLI:

    R24 og eldre

    AS_CLI/ASDiagnostic/DNS> last inn på nytt

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> last inn på nytt

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> last inn på nytt

Hva du skal gjøre nå

For nye installasjoner av en NPS, gå til Konfigurer NPS til å bruke autentiseringsproxy

For å migrere en eksisterende Android-distribusjon til FCMv1, gå til Migrer NPS til FCMv1

Konfigurer NPS til å bruke autentiseringsproxy

Denne oppgaven gjelder for en ny installasjon av NPS, dedikert til Webex for Cisco BroadWorks.

Hvis du vil konfigurere autentiseringsproxyen på en NPS som deles med andre mobilapper, kan du se Oppdatere Cisco BroadWorks NPS for å bruke NPS-proxy.

1

Innhenting av OAuth-legitimasjon for Webex for Cisco BroadWorks.

2

Opprett klientkontoen på NPS:

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-Step1

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

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

For å bekrefte at verdiene du skrev inn samsvarer med det du fikk oppgitt, kjør XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI-issuerUrl-en skal ALLTID være en amerikansk CI-klynge uavhengig av hvor du befinner deg, og standardverdien skal være: 

XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI> get issuerUrl = https://idbroker.webex.com/idb

3

Skriv inn URL-adressen til NPS-proxyen, og angi oppdateringsintervallet for tokenet (anbefalt 30 minutter):

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://nps.uc-one.broadsoft.com/nps/

For å forbedre DNS-oppløsningshastigheten, anbefaler vi at du bruker riktig FQDN basert på din region i stedet for den nåværende FQDN-en nps.uc-one.broadsoft.com.

Regionbaserte FQDN-er:

USA Øst:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-a.wbx2.com/nps/

USAs vestre del:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-r.wbx2.com/nps/

Europa:

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set url https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Hvis push-varsler utløper på grunn av en forsinkelse i DNS-oppløsningen, øk tidsavbruddsverdien i "/etc/resolv.conf" filen på BroadWorks-serveren.

4

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

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

5

(For Apple iOS-varsler) Legg til program-ID-en i APNS-programkonteksten, og sørg for å utelate Auth-nøkkelen – sett den til tom.

XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

6

Konfigurer følgende NPS-URL-er:

XSP|ADP CLI-kontekst

Parameter

Verdi

  • XSP|ADP_CLI/Applications/NotificationPushServer/FCM>

authURL

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

pushURL

https://fcm.googleapis.com/v1/projects/PROJECT-ID/messages:send

scope

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

  • XSP|ADP_CLI/Applications/NotificationPushServer/APNS/Production>

url

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

7

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

XSP|ADP CLI-kontekst

Parameter

Verdi

  • XSP|ADP_CLI/Applications/

    NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3600

connectionIdleTimeoutInSeconds

600

  • XSP|ADP_CLI/Applications/NotificationPushServer/

    APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

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

  1. Kjør AS_CLI/System/PushNotification> get og sjekk verdien av enforceAllowedApplicationList. Hvis det er true, må du fullføre denne deloppgaven. Ellers hopper du over resten av deloppgaven.

  2. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.wx2.android “Webex Android”

  3. AS_CLI/System/PushNotification/AllowedApplications> add com.cisco.squared “Webex iOS”

9

Start XSP|ADP på nytt: bwrestart

10

Test anropsvarsler ved å ringe fra en BroadWorks-abonnent til to Webex-mobilbrukere. Kontroller at anropsvarselet vises på iOS- og Android-enheter.

Migrer NPS til FCMv1

Dette emnet inneholder valgfrie prosedyrer du kan bruke i Google FCM-konsollen når du har en eksisterende NPS-distribusjon som du må migrere til FCMv1. Det er tre prosedyrer:

Migrer UC-One-klienter til FCMv1

Bruk trinnene nedenfor i Google FCM-konsollen for å migrere UC-One-klienter til Google FCM HTTPv1.

Hvis merkevarebygging brukes på klienten, må klienten ha avsender-ID-en. I FCM-konsollen, se Prosjektinnstillinger > Meldinger i skyen. Innstillingen vises i tabellen for prosjektlegitimasjon.

For detaljer, se Connect Mobile Branding Guide på https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/UC-One/UC-One-Collaborate/Connect/Mobile/IandO/ConnectBrandingGuideMobile-R3_8_3.pdf?. Se parameteren gcm_defaultSenderId, som ligger i Branding Kit, Resource-mappen, branding.xml-filen med syntaksen nedenfor:

xxxxxxxxxxxxx

  1. Logg inn på FCM Admin SDK på http://console.firebase.google.com.

  2. Velg riktig Android-applikasjon.

  3. I fanen Generelt registrerer du prosjekt-ID-en

  4. Naviger til fanen Tjenestekontoer for å konfigurere en tjenestekonto. Du kan opprette en ny tjenestekonto eller konfigurere en eksisterende.

    Slik oppretter du en ny tjenestekonto:

    1. Klikk på den blå knappen for å opprette en ny tjenestekonto

    2. Klikk på den blå knappen for å generere en ny privatnøkkel

    3. Last ned nøkkelen til et sikkert sted

    Slik bruker du en eksisterende tjenestekonto på nytt:

    1. Klikk på den blå teksten for å se eksisterende tjenestekontoer.

    2. Identifiser tjenestekontoen som skal brukes. Tjenestekontoen trenger tillatelse firebaseadmin-sdk.

    3. Helt til høyre klikker du på hamburgermenyen og opprett en ny privat nøkkel.

    4. Last ned json-filen som inneholder nøkkelen, og lagre den på et sikkert sted.

  5. Kopier json-filen til XSP|ADP.

  6. Konfigurer prosjekt-ID-en og :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add

  7. Konfigurer applikasjonen:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add  projectId 
...Done

XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
  Application ID    Project ID
==============================
          my_app    my_project

  8. Aktiver FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  9. Kjør kommandoen bwrestart for å starte XSP|ADP på nytt.

Migrer SaaS-klienter til FCMv1

Bruk trinnene nedenfor i Google FCM Console hvis du vil migrere SaaS-klienter til FCMv1.

Sørg for at du allerede har fullført prosedyren «Konfigurer NPS for å bruke autentiseringsproxy».

  1. Deaktiver FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
...Done

  2. Kjør kommandoen bwrestart for å starte XSP|ADP på nytt.

  3. Aktiver FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
...Done

  4. Kjør kommandoen bwrestart for å starte XSP|ADP på nytt.

Oppdater ADP-server

Bruk trinnene nedenfor i Google FCM-konsollen hvis du migrerer NPS-en til å bruke en ADP-server.

  1. Hent JSON-filen fra Google Cloud Console:

    1. Gå til siden Tjenestekontoer i Google Cloud Console.

    2. Klikk på Velg et prosjekt, velg prosjektet ditt og klikk på Åpne.

    3. Finn raden for tjenestekontoen du vil opprette en nøkkel for, klikk på den vertikale knappen Mer og klikk deretter på Opprett nøkkel

    4. Velg en Nøkkeltype og klikk på Opprett

      Filen lastes ned.

  2. Legg til FCM på ADP-serveren:

    1. Importer JSON-filen til ADP-serveren ved hjelp av kommandoen /bw/install.

    2. Logg inn på ADP CLI og legg til prosjekt og API-nøkkel:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON :

    3. Deretter legger du til applikasjonen og nøkkelen:

      ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done

    4. Bekreft konfigurasjonen:

      ADP_CLI/Applications/NotificationPushServer/FCM/Projects> g
Project ID Accountkey
========================
connect-ucaas ********

ADP_CLI/Applications/NotificationPushServer/FCM/Applications> g
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas
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