05 juni 2025 | 28 weergave(n) | 0 personen vonden dit nuttig

Configureer pushmeldingen voor Webex BroadWorks

list-menuFeedback?
Leer hoe u pushmeldingen voor oproepen instelt voor Webex voor BroadWorks met behulp van NPS voor Android en iOS.

In dit document gebruiken we de term Call Notifications Push Server (CNPS) om een door XSP gehoste of door ADP gehoste toepassing te beschrijven die in uw omgeving wordt uitgevoerd. Uw CNPS werkt met uw BroadWorks-systeem om op de hoogte te zijn van inkomende gesprekken naar uw gebruikers en pusht meldingen van gebruikers naar Google Firebase Cloud Messaging (FCM) of Meldingsservices van Apple Push Notification service (APN's).

Deze services melden de mobiele apparaten van Webex voor Cisco BroadWorks-abonnees dat ze inkomende gesprekken hebben op Webex.

Zie de Functiebeschrijving pushserver voor berichten voor meer informatie over NPS.

Een vergelijkbaar mechanisme in Webex werkt met Webex-berichtenservices en -aanwezigheidsservices om meldingen via Google (FCM) of Apple(APNS) te verzenden. Deze services informeren de mobiele Webex-gebruikers op de hoogte van inkomende berichten of aanwezigheidswijzigingen.

In dit gedeelte wordt beschreven hoe u NPS configureert voor een authenticatieproxy wanneer de NPS nog geen andere apps ondersteunt. Als u een gedeelde NPS moet migreren om NPS-proxy te gebruiken, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken.

Overzicht NPS-proxy

Voor de compatibiliteit met Webex voor Cisco BroadWorks moet uw CNPS worden gepatcht om de NPS-proxyfunctie te ondersteunen, pushserver voor VoIP in UCaaS.

De functie implementeert een nieuw ontwerp in de Push-server voor meldingen om het beveiligingsprobleem van het delen van pushmeldingcertificaat privésleutels met serviceproviders voor mobiele clients op te lossen. In plaats van pushmeldingscertificaten en -sleutels te delen met de serviceprovider, gebruikt de NPS een nieuwe API om een pushmelding token voor korte gegevens te verkrijgen van Webex voor Cisco BroadWorks backend en gebruikt deze token voor verificatie met de Apple APN's en Google FCM-services.

De functie biedt ook een verbeterde functionaliteit van de Berichten pushserver om meldingen naar Android-apparaten te pushen via de nieuwe HTPv1-API van Google Firebase Cloud Messaging (FCM).

APNS-overwegingen

Na 31 maart 2021 ondersteunt Apple het binaire http/1-gebaseerde binaire protocol niet meer in de Apple Push Notification-service. Wij raden u aan uw XSP|ADP zo te configureren dat deze de HTTP/2-based interface voor APN's. Voor deze update is het vereist dat uw XSP|ADP die de NPS host, R22 of later gebruikt.

Bereid uw NPS voor op Webex voor Cisco BroadWorks

1

Installeer en configureer een eigen XSP (minimale versie R22) of een toepassingsleveringsplatform (ADP).

2

Installeer de NPS-verificatieproxypatches:

XSP R22-patches:

XSP R23-patches:

3

Activeer de pushservertoepassing voor meldingen.

4

(Voor Android-meldingen) Schakel de FCM v1 API in op de NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Voor Apple iOS-meldingen) Schakel HTTP/2 in op de NPS.

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

Dit is exclusief voor Release 22 en eerdere versies; het is niet beschikbaar in Release 23 en hogere versies, die alleen ondersteuning bieden HTTP/2.

6

Voeg een technische ondersteuning vanuit de NPS XSP/ADP toe.

7

Op elke AS-server moet het namedefs-bestand in /usr/local/broadworks/bw_base/conf worden geconfigureerd met SRV- en A-records voor de Notification Push Server (XSP/ADP) opzoeken, indien meerdere XSP/ADP Voeg vervolgens voor elk item een vermelding toe, indien nodig.

Voorbeeld: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN EEN 10.193.78.149

Nadat u dit hebt ingesteld, moet u een van de volgende handelingen uitvoeren om de wijzigingen op te pikken:

  1. Een restartbw kan worden uitgevoerd in een onderhoudsvenster.

  2. Via de Cisco BroadWorks CLI:

    R24 en ouder

    AS_CLI/ASDiagnostic/DNS> opnieuw laden

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> opnieuw laden

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> opnieuw laden

De volgende stappen

Voor nieuwe installaties van een NPS, ga naar NPS configureren om authenticatieproxy te gebruiken

Om een bestaande Android-implementatie naar FCMv1 te migreren, gaat u naar NPS migreren naar FCMv1

Configureer NPS om authenticatieproxy te gebruiken

Deze taak is van toepassing op een nieuwe installatie van NPS, toegewezen aan Webex voor Cisco BroadWorks.

Als u de authenticatieproxy wilt configureren op een NPS die wordt gedeeld met andere mobiele apps, raadpleegt u Cisco BroadWorks NPS bijwerken om NPS-proxy te gebruiken.

1

OAuth-referenties verkrijgen voor uw Webex voor Cisco BroadWorks.

2

Maak de clientaccount in de 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

Voer uit om te controleren of de waarden die u hebt ingevoerd, overeenkomen met wat u hebt gekregen XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

De CiscoCI issuerUrl moet ALTIJD US CI cluster zijn, ongeacht uw locatie. De standaardwaarde moet zijn: 

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

3

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

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

Om de DNS-resolutiesnelheid te verbeteren, raden wij u aan om in plaats van de huidige FQDN nps.uc-one.broadsoft.com de juiste FQDN voor uw regio te gebruiken.

Regiogebaseerde FQDN's:

Oosten van de Verenigde Staten:

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

VS West:

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

Als pushmeldingen verlopen vanwege een vertraging in de DNS-resolutie, verhoogt u de time-outwaarde in de "/etc/resolv.conf" bestand op de BroadWorks-server.

4

(Voor Android-meldingen) Voeg de Id van de Android-toepassing toe aan de context van FCM-toepassingen op de NPS.

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

5

(Voor Apple iOS-meldingen) Voeg de toepassings-id toe aan de context van APNS-toepassingen, zodat u de Auth-sleutel weglaten en deze leeg laat.

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

6

Configureer de volgende NPS-URL's:

XSP|ADP CLI-context

Parameter

Waarde

  • 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

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

XSP|ADP CLI-context

Parameter

Waarde

  • 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

Controleer of de toepassingsserver een toepassings-id heeft, omdat u de Webex-apps mogelijk aan de lijst met toegestane toepassingen moet toevoegen:

  1. Voer AS_CLI/System/PushNotification> get uit en controleer de waarde van enforceAllowedApplicationList. Als het trueis, moet u deze subtaak voltooien. Anders slaat u de rest van de subtaak 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

Start de XSP|ADP opnieuw: bwrestart

10

Test gespreksmeldingen door een BroadWorks-abonnee te bellen naar twee mobiele Webex-gebruikers. Controleer of de oproepmelding op iOS- en Android-apparaten wordt weergegeven.

NPS migreren naar FCMv1

Dit onderwerp bevat optionele procedures die u kunt gebruiken in de Google FCM-console wanneer u een bestaande NPS-implementatie hebt die u moet migreren naar FCMv1. Er zijn drie procedures:

Migreer UC-One-clients naar FCMv1

Gebruik de onderstaande stappen in Google FCM Console om UC-One-clients te migreren naar Google FCM HTTPv1.

Als branding is toegepast op de client, moet de client de afzender-id hebben. Zie In de FCM-console Projectinstellingen > Cloud Messaging. De instelling wordt weergegeven in de tabel aanmeldgegevens van Project.

Voor meer informatie, zie de Connect Mobile Branding Guide op 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?. Raadpleeg de parameter gcm_defaultSenderId, die zich in de Branding Kit, Resource-map, branding.xml-bestand bevindt met de onderstaande syntaxis:

xxxxxxxxxxxxx

  1. Meld u aan bij FCM Admin SDK op http://console.firebase.google.com.

  2. Selecteer de juiste Android-toepassing.

  3. Neem op het tabblad Algemeen de project-id op

  4. Ga naar het tabblad Service accounts om een service account te configureren. U kunt een nieuw service account maken of een bestaand account configureren.

    Een nieuwe serviceaccount maken:

    1. Klik op de blauwe knop voor het maken van een nieuw serviceaccount

    2. Klik op de blauwe knop om een nieuwe privésleutel te genereren

    3. Sleutel downloaden naar een veilige locatie

    Een bestaand serviceaccount opnieuw gebruiken:

    1. Klik op de blauwe tekst om de bestaande serviceaccounts weer te krijgen.

    2. Identificeer het te gebruiken serviceaccount. Service account heeft toestemming nodig firebaseadmin-sdk.

    3. Aan de rechterkant klikt u op het menu menu van het menu en maakt u een nieuwe privésleutel.

    4. Download het JSON-bestand dat de sleutel bevat en sla het op een veilige locatie op.

  5. Kopieer het JSON-bestand naar de XSP|ADP.

  6. Configureer de project-id en:

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

  7. Configureer de toepassing:

    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. FCMv1 inschakelen:

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

  9. Voer de opdracht bwrestart uit om de XSP|ADP opnieuw te starten.

SaaS-clients migreren naar FCMv1

Gebruik de onderstaande stappen op Google FCM Console als u SaaS-clients wilt migreren naar FCMv1.

Zorg ervoor dat u de procedure 'NPS configureren voor het gebruik van de verificatieproxy' al hebt voltooid.

  1. FCM uitschakelen:

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

  2. Voer de opdracht bwrestart uit om de XSP|ADP opnieuw te starten.

  3. FCM inschakelen:

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

  4. Voer de opdracht bwrestart uit om de XSP|ADP opnieuw te starten.

ADP-server bijwerken

Gebruik de onderstaande stappen in Google FCM Console als u de NPS migreert om een ADP-server te gebruiken.

  1. Haal het JSON-bestand op via de Google Cloud Console:

    1. Ga op de Google Cloud Console naar de pagina Serviceaccounts.

    2. Klik op Een projectselecteren, kies uw project en klik op Openen.

    3. Zoek de rij van het serviceaccount waarvoor u een sleutel wilt maken, klik op de verticale knop Meer en klik vervolgens op Sleutel maken.

    4. Selecteer een Sleutel type en klik op Maken

      De bestandsdownloads.

  2. FCM toevoegen aan de ADP-server:

    1. Importeer het JSON-bestand naar de ADP-server met behulp van de opdracht /bw/install.

    2. Meld u aan bij de ADP CLI en voeg project- en API-sleutel toe:

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

    3. Voeg daarna de toepassing en het sleutel toe:

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

    4. Controleer de configuratie:

      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
Vond u dit artikel nuttig?
Vond u dit artikel nuttig?
PrijzenWebex-appMeetingsCallingBerichtenScherm delen
Webex SuiteCallingMeetingsBerichtenSlidoWebinarsEventsContact CenterCPaaSBeveiligingControl Hub
HeadsetsCamera'sBureauserieRoom-serieBoard-serieTelefoonserieAccessoires
OnderwijsGezondheidszorgOverheidFinanciënEntertainment en volwassenFrontlineNon-profitorganisatiesStartupsHybride werken
DownloadsDeelnemen aan een testvergaderingOnline cursussenIntegratiesToegankelijkheidInclusiviteitLive webinars en webinars op aanvraagWebex-communityWebex DevelopersNieuws en innovaties
CiscoNeem contact op met ondersteuningNeem contact op met de verkoopafdelingWebex BlogWebex Thought LeadershipWebex Merch StoreCarrière
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
VoorwaardenPrivacyverklaringCookiesHandelsmerken
©2026 Cisco en/of de dochterondernemingen. Alle rechten voorbehouden.
VoorwaardenPrivacyverklaringCookiesHandelsmerken