05. juni 2025 | 28 visning(er) | 0 personer fandt dette nyttigt

Konfigurer push-meddelelser om opkald til Webex BroadWorks

list-menuHar du feedback?
Lær, hvordan du konfigurerer push-notifikationer om opkald til Webex til BroadWorks ved hjælp af NPS til Android og iOS.

I dette dokument bruger vi termen Call Notifications Push Server (CNPS) til at beskrive en XSP-hostet eller ADP-hostet applikation, der kører i dit miljø. Din CNPS fungerer sammen med dit BroadWorks-system for at være opmærksom på indgående opkald til dine brugere og sender underretninger til brugere til Google Firebase Cloud Messaging (FCM) eller Apple Push Notification Service (APN'er) underretningstjenester.

Disse tjenester underretter cisco BroadWorks-abonnenters mobile enheder om, at de har indgående opkald på Webex.

For yderligere oplysninger om NPS, se Beskrivelse af funktionen Meddelelse push-server.

En lignende mekanisme i Webex fungerer med Webex meddelelses- og tilstedeværelsestjenester til push-underretninger til Google (FCM) eller Apple (APNS) meddelelsestjenester. Disse tjenester underretter til gengæld de mobile Webex-brugere om ændringer i indgående meddelelser eller tilstedeværelse.

Dette afsnit beskriver, hvordan du konfigurerer NPS til godkendelsesproxy, når NPS'en ikke allerede understøtter andre apps. Hvis du har brug for at migrere en delt NPS for at bruge NPS-proxy, skal du se Opdatering af Cisco BroadWorks NPS til at bruge NPS-proxy.

OVERSIGT OVER NPS-proxy

For kompatibilitet med Webex til Cisco BroadWorks skal din CNPS programrettelse være programrettelse for at understøtte funktionen NPS-proxy, Push-server til VoIP i UCaaS.

Funktionen implementerer et nyt design i Meddelelses-pushserveren for at løse sikkerhedsrisikoen ved deling af push-meddelelsescertifikat private nøgler med tjenesteudbydere til mobilklienter. I stedet for at dele push-meddelelsescertifikater og -nøgler med serviceudbyderen bruger NPS en ny API til at opnå et push-meddelelsestoken med kort varsel fra Webex til Cisco BroadWorks-backend og bruger denne token til godkendelse med Apple API'er og Google FCM-tjenester.

Funktionen forbedrer også muligheden for push-beskeder til push-beskeder til Android-enheder via den nye Google Firebase Cloud Messaging (FCM) HTTPv1 API.

OVERVEJELSER I FORBINDELSE med APNS

Apple vil ikke længere understøtte den HTTP/1-baserede binære protokol på Apple Push-meddelelsestjenesten efter den 31. marts 2021. Vi anbefaler, at du konfigurerer din XSP|ADP til at bruge HTTP/2-based grænseflade til APN'er. Denne opdatering kræver, at din XSP|ADP, der hoster NPS'en, kører R22 eller nyere.

Forbered dine NPS til Webex til Cisco BroadWorks

1

Installer og konfigurer en dedikeret XSP (mindste version R22) eller applikationsleveringsplatform (ADP).

2

Installer programrettelser til NPS-bekræftelsesproxy:

XSP R22-programrettelser:

XSP R23-programrettelser:

3

Aktivér meddelelse push-server-applikationen.

4

(Til Android-underretninger) Aktiver FCM v1 API på NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

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

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

Dette er eksklusivt for version 22 og tidligere versioner; det er ikke tilgængeligt i version 23 og nyere versioner, som kun understøtter HTTP/2.

6

Vedhæft en teknisksupport fra NPS XSP/ADP.

7

På hver AS-server skal namedefs-filen i /usr/local/broadworks/bw_base/conf konfigureres med SRV- og A-poster til Notification Push Server (XSP/ADP) opslag, hvis flere XSP/ADP tilføj derefter en post for hver efter 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 den er indstillet, kræves en af følgende for at gemme ændringerne:

  1. En genstart vil blive udført i et vedligeholdelsesvindue.

  2. Via Cisco BroadWorks CLI:

    R24 og ældre

    AS_CLI/ASDiagnostic/DNS> genindlæs

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> genindlæs

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> genindlæs

Næste trin

For nye installationer af en NPS, gå til Konfigurer NPS til at bruge godkendelsesproxy

For at migrere en eksisterende Android-implementering til FCMv1 skal du gå til Migrer NPS til FCMv1

Konfigurer NPS til at bruge godkendelsesproxy

Denne opgave gælder for en ny installation af NPS, der er dedikeret til Webex til Cisco BroadWorks.

Hvis du vil konfigurere godkendelsesproxyen på en NPS, der deles med andre mobilapps, skal du se Opdatering af Cisco BroadWorks NPS til at bruge NPS-proxy.

1

Indhentning af OAuth-legitimationsoplysninger til dit Webex til Cisco BroadWorks.

2

Opret 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 at bekræfte de værdier, du indtastede, svarer til de værdier, du har fået, skal du køre XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI issuerUrl'en skal ALTID være en amerikansk CI-klynge uanset din placering, og standardværdien skal være: 

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

3

Indtast URL-adressen for NPS-proxy, og indstil token-opdateringsintervallet (30 minutter anbefales):

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

For at forbedre DNS-opløsningshastigheden anbefaler vi, at du bruger den relevante FQDN baseret på din region i stedet for den nuværende FQDN nps.uc-one.broadsoft.com.

Regionsbaserede FQDN'er:

Det østlige USA:

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

Det vestlige USA:

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-notifikationer udløber på grund af en forsinkelse i DNS-opløsningen, skal du øge timeout-værdien i "/etc/resolv.conf" filen på BroadWorks-serveren.

4

(Til Android-underretninger) Tilføj Android applikations-id til FCM-applikationer kontekst på NPS.

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

5

(For Apple iOS-underretninger) Føj applikations-id'et til APNS-applikationerne, og sørg for at udelade auth-tasten – sæt den til tom.

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

6

Konfigurer følgende NPS-URL-adresser:

XSP|ADP CLI-kontekst

Parameter

Værdi

  • 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-forbindelsesparametre til de anbefalede værdier vist:

XSP|ADP CLI-kontekst

Parameter

Værdi

  • 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

Kontroller, om applikationsserveren er program-jeg-websteder, da du muligvis skal tilføje Webex-apps til listen over tilladte programmer:

  1. Kør AS_CLI/System/PushNotification> get og tjek værdien af enforceAllowedApplicationList. Hvis det er true, skal du fuldføre denne delopgave. Ellers kan du springe resten af underopgaven over.

  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

Genstart XSP|ADP'en: bwrestart

10

Test opkaldsmeddelelser ved at foretage opkald fra en BroadWorks-abonnent til to Webex-mobilbrugere. Bekræft, at opkaldsnotifikationen vises på iOS- og Android-enheder.

Migrer NPS til FCMv1

Dette emne indeholder valgfrie procedurer, som du kan bruge i Google FCM-konsol, når du har en eksisterende NPS-udrulning, som du skal migrere til FCMv1. Der findes tre procedurer:

Migrer UC-One-klienter til FCMv1

Brug nedenstående trin i Google FCM-konsollen til at migrere UC-One-klienter til Google FCM HTTPv1.

Hvis branding anvendes på klienten, skal klienten have afsender-id. Se Projektindstillinger i FCM-konsollen > Cloud-meddelelser. Indstillingen vises i tabellen Projektlegitimationsoplysninger.

For yderligere oplysninger, 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 er placeret i Branding Kit, Resource-mappen, branding.xml-filen med nedenstående syntaks:

xxxxxxxxxxxxx

  1. Log ind på FCM Admin SDK på http://console.firebase.google.com.

  2. Vælg den relevante Android-applikation.

  3. I fanen Generelt skal du optage projekt-id'et

  4. Naviger til fanen Tjenestekonti for at konfigurere en tjenestekonto. Du kan oprette en ny servicekonto eller konfigurere en eksisterende.

    Sådan opretter du en ny tjenestekonto:

    1. Klik på den blå knap for at oprette ny servicekonto

    2. Klik på den blå knap for at generere en ny privat nøgle

    3. Download-nøgle til en sikker placering

    Sådan genbruges en eksisterende tjenestekonto:

    1. Klik på den blå tekst for at se eksisterende tjenestekonti.

    2. Identificer den tjenestekonto, der skal bruges. Servicekonto skal have tilladelse firebaseadmin-sdk.

    3. Klik på hamburgermenuen yderst til højre, og opret en ny privat nøgle.

    4. Download json-filen, der indeholder nøglen, og gem på en sikker placering.

  5. Kopier json-filen til XSP|ADP.

  6. Konfigurer projekt-id og :

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

  7. Konfigurer applikationen:

    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. Kør kommandoen bwrestart for at genstarte XSP|ADP'en.

Migrer SaaS-klienter til FCMv1

Brug nedenstående trin på Google FCM-konsol, hvis du vil migrere SaaS-klienter til FCMv1.

Sørg for, at du allerede har fuldført proceduren "Konfigurer NPS til at bruge godkendelsesproxy".

  1. Deaktiver FCM:

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

  2. Kør kommandoen bwrestart for at genstarte XSP|ADP'en.

  3. Aktiver FCM:

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

  4. Kør kommandoen bwrestart for at genstarte XSP|ADP'en.

Opdater ADP-server

Brug nedenstående trin i Google FCM-konsol, hvis du migrerer NPS for at bruge en ADP-server.

  1. Få JSON-filen fra Google Cloud-konsollen:

    1. Gå til siden Tjenestekonti på Google Cloud-konsollen.

    2. Klik på Vælg etprojekt, vælg dit projekt, og klik på Åbn.

    3. Find rækken for den servicekonto, du vil oprette en nøgle til, klik på den lodrette knap Mere, og klik derefter på Opret nøgle

    4. Vælg en Nøgletype og klik på Opret

      Filen downloades.

  2. Tilføj FCM til ADP-serveren:

    1. Importer JSON-filen til ADP-serveren ved hjælp af kommandoen /bw/install.

    2. Log ind på ADP CLI, og tilføj projekt- og API-nøgle:

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

    3. Tilføj derefter applikationen og nøglen:

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

    4. Bekræft konfigurationen:

      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 artikel nyttig?
Var denne artikel nyttig?
PriserWebex-appMeetingsCallingMeddelelserSkærmdeling
Webex SuiteCallingMeetingsMeddelelserSlidoWebinarerEventsContact CenterCPaaSSikkerhedControl Hub
headsetsKameraerSkrivebordsserierRumserienBoard-serienTelefonserienTilbehør
UddannelseSundhedsplejeStatFinansSport og underholdningFrontlineNonprofitsNystartede virksomhederHybridarbejde
OverførslerDeltag i et testmødeOnlinekurserIntegrationerTilgængelighedInklusionLive- og on-demand-webinarerWebex-fællesskabetWebex til udviklereNyheder og innovationer
CiscoKontakt supportKontakt salgWebex BlogWebex tankelederskabWebex Merch-butikKarrierer
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Vilkår og betingelserDatabeskyttelseserklæringCookiesVaremærker
©2026 Cisco og/eller dennes partnere. Alle rettigheder forbeholdes.
Vilkår og betingelserDatabeskyttelseserklæringCookiesVaremærker