05 iunie 2025 | 25 vizualizare(ări) | 0 persoane au considerat că este util

Configurați notificările push pentru apeluri pentru Webex BroadWorks

list-menuFeedback?
Aflați cum să configurați notificările push pentru apeluri pentru Webex for BroadWorks folosind NPS pentru Android și iOS.

În acest document folosim termenul Call Notifications Push Server (CNPS) pentru a descrie o aplicație găzduită de XSP sau găzduită de ADP care rulează în mediul dvs. CNPS-ul funcționează cu sistemul BroadWorks pentru a fi la curent cu apelurile primite către utilizatori și transmite notificări ale acestora către serviciile de notificare Google Firebase Cloud Messaging (FCM) sau Apple Push Notification service (APNs).

Aceste servicii notifică dispozitivele mobile ale Webex pentru abonații Cisco BroadWorks că au apeluri primite pe Webex.

Pentru mai multe informații despre NPS, consultați Notificarea Push Server Feature Description.

Un mecanism similar din Webex funcționează cu serviciile de mesagerie și prezență Webex pentru a transmite notificări către serviciile de notificare Google (FCM) sau Apple (APNS). Aceste servicii, la rândul lor, notifică utilizatorii Webex mobili cu privire la mesajele primite sau la modificările de prezență.

Această secțiune descrie cum se configurează NPS pentru proxy de autentificare atunci când NPS nu acceptă deja alte aplicații. Dacă trebuie să migrați un NPS partajat pentru a utiliza proxy-ul NPS, consultați Actualizarea Cisco BroadWorks NPS pentru a utiliza proxy-ul NPS.

Prezentare generală a proxy-ului NPS

Pentru compatibilitatea cu Webex pentru Cisco BroadWorks, CNPS trebuie să fie patch-uri pentru a accepta caracteristica NPS Proxy, Push Server pentru VoIP în UCaaS.

Caracteristica implementează un nou design în serverul Push de notificare pentru a rezolva vulnerabilitatea de securitate a partajării cheilor private certificate de notificare push cu furnizorii de servicii pentru clienții mobili. În loc să partajeze certificatele și cheile de notificare push cu furnizorul de servicii, NPS utilizează un nou API pentru a obține un token de notificare push de scurtă durată de la Webex pentru cisco BroadWorks backend și utilizează acest token pentru autentificarea cu APK-urile Apple și serviciile Google FCM.

Funcția îmbunătățește, de asemenea, capacitatea serverului push de notificare de a împinge notificările către dispozitivele Android prin intermediul noului API HTTPv1 de mesagerie în cloud Google Firebase (FCM).

Considerații APNS

Apple nu va mai accepta protocolul binar bazat pe HTTP/1 pe serviciul Apple Push Notification după 31 martie 2021. Vă recomandăm să configurați XSP|ADP pentru a utiliza HTTP/2-based interfață pentru APN-uri. Această actualizare necesită ca XSP-ul|ADP-ul care găzduiește NPS să ruleze versiunea 22 sau o versiune ulterioară.

Pregătiți-vă NPS pentru Webex pentru Cisco BroadWorks

1

Instalați și configurați un XSP dedicat (versiunea minimă R22) sau Platforma de livrare a aplicațiilor (ADP).

2

Instalați patch-urile PROXY de autentificare NPS:

Patch-uri XSP R22:

Plasturi XSP R23:

3

Activați aplicația Notification Push Server.

4

(Pentru notificări Android) Activați API-ul FCM v1 pe NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Pentru notificările Apple iOS) Activați HTTP/2 pe NPS.

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

Acest lucru este exclusiv pentru versiunea 22 și versiunile anterioare; nu este disponibil în versiunea 23 și versiunile ulterioare, care acceptă doar HTTP/2.

6

Atașați un suport tehnic de la NPS XSP/ADP.

7

Pe fiecare server AS, fișierul namedefs din /usr/local/broadworks/bw_base/conf trebuie configurat cu înregistrări SRV și A pentru serverul Notification Push. (XSP/ADP) căutare, dacă sunt mai multe XSP/ADP apoi adăugați câte o intrare pentru fiecare, după cum este necesar.

Exemplu: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com ÎNTR-UN 10.193.78.149

Odată setate, este necesară una dintre următoarele acțiuni pentru a prelua modificările:

  1. O repornire trebuie efectuată într-o fereastră de întreținere.

  2. Prin intermediul interfeței CLI Cisco BroadWorks:

    R24 și mai vechi

    AS_CLI/ASDiagnostic/DNS> reîncărcați

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> reîncărcați

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> reîncărcați

Ce este de făcut în continuare

Pentru instalări noi ale unui NPS, accesați Configurați NPS pentru a utiliza proxy-ul de autentificare

Pentru a migra o implementare Android existentă la FCMv1, accesați Migrare NPS la FCMv1

Configurați NPS pentru a utiliza proxy-ul de autentificare

Această sarcină se aplică unei noi instalări de NPS, dedicată Webex pentru Cisco BroadWorks.

Dacă doriți să configurați proxy-ul de autentificare pe un NPS partajat cu alte aplicații mobile, consultați Actualizarea Cisco BroadWorks NPS pentru a utiliza proxy-ul NPS.

1

Obținerea acreditărilor OAuth pentru Webex for Cisco BroadWorks.

2

Creați contul de client pe 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

Pentru a verifica dacă valorile pe care le-ați introdus se potrivesc cu ceea ce vi s-a dat, rulați XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

URL-ul CiscoCI issuerUrl ar trebui să fie ÎNTOTDEAUNA US CI cluster, indiferent de locația dvs., iar valoarea implicită ar trebui să fie: 

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

3

Introduceți ADRESA URL proxy NPS și setați intervalul de reîmprospătare a tokenului (30 de minute recomandate):

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

Pentru a îmbunătăți viteza de rezoluție DNS, în loc de FQDN-ul actual nps.uc-one.broadsoft.com, vă recomandăm să utilizați FQDN-ul corespunzător regiunii dvs.

FQDN-uri bazate pe regiune:

Sua de Est:

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

Vestul SUA:

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

Dacă notificările push expiră din cauza unei întârzieri în rezoluția DNS, creșteți valoarea de expirare în "/etc/resolv.conf" fișier pe serverul BroadWorks.

4

(Pentru notificări Android) Adăugați ID-ul aplicației Android la contextul aplicațiilor FCM pe NPS.

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

5

(Pentru notificările Apple iOS) Adăugați ID-ul aplicației în contextul aplicațiilor APNS, asigurându-vă că omiteți cheia Auth - setați-o la gol.

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

6

Configurați următoarele ADRESE URL NPS:

Contextul CLI XSP|ADP

Parametru

Valoare

  • 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

Configurați următorii parametri de conexiune NPS la valorile recomandate afișate:

Contextul CLI XSP|ADP

Parametru

Valoare

  • 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

Verificați dacă serverul de aplicații examinează ID-urile de aplicație, deoarece poate fi necesar să adăugați aplicațiile Webex la lista de permisiuni:

  1. Executați AS_CLI/System/PushNotification> get și verificați valoarea lui enforceAllowedApplicationList. Dacă este true, trebuie să finalizați această subsarcină. În caz contrar, săriți peste restul subactivității.

  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

Reporniți XSP|ADP: bwrestart

10

Testați notificările de apeluri prin efectuarea de apeluri de la un abonat BroadWorks către doi utilizatori de telefonie mobilă Webex. Verificați dacă notificarea de apel apare pe dispozitivele iOS și Android.

Migrarea NPS la FCMv1

Acest subiect conține proceduri opționale pe care le puteți utiliza în Google FCM Console atunci când aveți o implementare NPS existentă de care aveți nevoie pentru a migra la FCMv1. Există trei proceduri:

Migrarea clienților UC-One la FCMv1

Urmați pașii de mai jos din Consola Google FCM pentru a migra clienții UC-One la Google FCM HTTPv1.

Dacă brandingul este aplicat clientului, clientul trebuie să aibă ID-ul expeditorului. În consola FCM, consultați Setări proiect > Mesagerie în cloud. Setarea apare în tabelul de acreditări Project.

Pentru detalii, consultați Ghidul de branding Connect Mobile la 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?. Consultați parametrul gcm_defaultSenderId, care se află în fișierul branding.xml din folderul Resource din Branding Kit, cu sintaxa următoare:

xxxxxxxxxxxxx

  1. Conectați-vă la FCM Admin SDK la http://console.firebase.google.com.

  2. Selectați aplicația Android corespunzătoare.

  3. În fila General, înregistrați ID-ul de proiect

  4. Navigați la fila Conturi de serviciu pentru a configura un cont de serviciu. Puteți să creați un cont de serviciu nou sau să configurați unul existent.

    Pentru a crea un cont de serviciu nou:

    1. Faceți clic pe butonul albastru pentru a crea un nou cont de serviciu

    2. Faceți clic pe butonul albastru pentru a genera o nouă cheie privată

    3. Descărcați cheia într-o locație securizată

    Pentru a reutiliza un cont de serviciu existent:

    1. Faceți clic pe textul albastru pentru a vizualiza conturile de servicii existente.

    2. Identificați contul de serviciu de utilizat. Contul de serviciu are nevoie de permisiunea firebaseadmin-sdk.

    3. În dreapta, faceți clic pe meniul hamburger și creați o nouă cheie privată.

    4. Descărcați fișierul json care conține cheia și salvați într-o locație sigură.

  5. Copiați fișierul json pe ADP-ul XSP|.

  6. Configurați ID-ul de proiect și :

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

  7. Configurați aplicația:

    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. Activați FCMv1:

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

  9. Executați comanda bwrestart pentru a reporni XSP|ADP.

Migrarea clienților SaaS la FCMv1

Utilizați pașii de mai jos din Google FCM Console dacă doriți să migrați clienții SaaS la FCMv1.

Asigurați-vă că ați finalizat deja procedura "Configurați NPS pentru a utiliza proxy de autentificare".

  1. Dezactivați FCM:

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

  2. Executați comanda bwrestart pentru a reporni XSP|ADP.

  3. Activați FCM:

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

  4. Executați comanda bwrestart pentru a reporni XSP|ADP.

Actualizați serverul ADP

Utilizați pașii de mai jos din Google FCM Console dacă migrați NPS pentru a utiliza un server ADP.

  1. Obțineți fișierul JSON din Google Cloud Console:

    1. În Google Cloud Console, accesați pagina Conturi de serviciu.

    2. Faceți clic pe Selectați un proiect , alegeți proiectul și faceți clic pe Deschidere .

    3. Găsiți rândul contului de serviciu pentru care doriți să creați o cheie, faceți clic pe butonul vertical Mai multe, apoi faceți clic pe Creare cheie.

    4. Selectați un tip de cheieși faceți clic pe Creare

      Fișierul se descarcă.

  2. Adăugați FCM la serverul ADP:

    1. Importați fișierul JSON pe serverul ADP folosind comanda /bw/install.

    2. Conectați-vă la CLI ADP și adăugați cheia Project și API:

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

    3. Apoi, adăugați aplicația și cheia:

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

    4. Verificați configurația:

      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
A fost util acest articol?
A fost util acest articol?
PrețuriAplicația WebexMeetingsCallingMesageriePartajare ecran
Webex SuiteCallingMeetingsMesagerieSlidoSeminare webEventsContact CenterCPaaSSecuritateControl Hub
CăștiCamereSeria DeskSeria RoomSeria BoardSeria PhoneAccesorii
EducațieAsistență medicalăGuvernFinanțeSport și divertismentPrima linieNonprofitStart-upuriActivitate hibridă
DescărcăriIntrați într-o întâlnire de probăCursuri onlineIntegrăriAccesibilitateIncluzivitateSeminare web live și la cerereComunitate WebexDezvoltatori WebexNoutăți și inovație
CiscoContactați asistențaContactați departamentul de vânzăriWebex BlogSpirit inovator WebexMagazin produse WebexCariere
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Clauze și condițiiDeclarație de confidențialitateModule cookieMărci comerciale
©2026 Cisco și/sau afiliații săi. Toate drepturile rezervate.
Clauze și condițiiDeclarație de confidențialitateModule cookieMărci comerciale