05. júna 2025 | 25 zobrazenia | 0 ľudia to považujú za užitočné

Konfigurácia push notifikácií o hovoroch pre Webex BroadWorks

list-menuSpätná väzba?
Zistite, ako nastaviť push notifikácie o hovoroch pre Webex pre BroadWorks pomocou NPS pre Android a iOS.

V tomto dokumente používame termín server na odosielanie upozornení na volania (CNPS) na opis aplikácie hostovanej na XSP alebo ADP, ktorá beží vo vašom prostredí. Váš CNPS spolupracuje so systémom BroadWorks, aby bol informovaný o prichádzajúcich hovoroch od vašich používateľov a odosiela upozornenia na ne do notifikačných služieb Google Firebase Cloud Messaging (FCM) alebo Apple Push Notification service (APN).

Tieto služby upozorňujú mobilné zariadenia predplatiteľov služby Webex pre Cisco BroadWorks, že majú prichádzajúce hovory na platforme Webex.

Viac informácií o NPS nájdete v Popis funkcie Notification Push Server.

Podobný mechanizmus vo Webexe funguje so službami na zasielanie správ a zisťovanie prítomnosti Webex na odosielanie oznámení do notifikačných služieb Google (FCM) alebo Apple (APNS). Tieto služby následne upozorňujú používateľov mobilného Webexu na prichádzajúce správy alebo zmeny prítomnosti.

Táto časť popisuje, ako nakonfigurovať NPS na overovanie proxy, keď NPS ešte nepodporuje iné aplikácie. Ak potrebujete migrovať zdieľaný NPS na používanie proxy NPS, pozrite si časť Aktualizácia Cisco BroadWorks NPS na používanie proxy NPS.

Prehľad proxy NPS

Pre kompatibilitu s Webex pre Cisco BroadWorks musí byť váš CNPS opravený tak, aby podporoval funkciu NPS Proxy, Push Server pre VoIP v UCaaS.

Táto funkcia implementuje nový dizajn servera Notification Push Server, ktorý rieši bezpečnostnú zraniteľnosť spočívajúcu v zdieľaní súkromných kľúčov certifikátov push notifikácií s poskytovateľmi služieb pre mobilných klientov. Namiesto zdieľania certifikátov a kľúčov pre push notifikácie s poskytovateľom služieb používa NPS nové API na získanie krátkodobého tokenu pre push notifikácie od spoločnosti Webex pre backend Cisco BroadWorks a tento token používa na autentifikáciu pomocou Apple APN a služieb Google FCM.

Táto funkcia tiež vylepšuje schopnosť Notification Push Servera odosielať oznámenia na zariadenia so systémom Android prostredníctvom nového rozhrania HTTPv1 API od spoločnosti Google Firebase Cloud Messaging (FCM).

Úvahy o APNS

Apple už nebude podporovať HTTP/1-based binárny protokol v službe Apple Push Notification po 31. marci 2021. Odporúčame vám nakonfigurovať váš XSP|ADP tak, aby používal HTTP/2-based rozhranie pre APN. Táto aktualizácia vyžaduje, aby váš XSP|ADP hostujúci NPS používal verziu R22 alebo novšiu.

Pripravte si NPS na Webex pre Cisco BroadWorks

1

Nainštalujte a nakonfigurujte vyhradený XSP (minimálna verzia R22) alebo platformu na doručovanie aplikácií (ADP).

2

Nainštalujte opravy proxy servera overovania NPS:

Záplaty XSP R22:

Záplaty XSP R23:

3

Aktivujte aplikáciu Notification Push Server.

4

(Pre upozornenia systému Android) Povoľte rozhranie FCM v1 API na serveri NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Pre upozornenia Apple iOS) Povoliť HTTP/2 na NPS.

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

Toto je exkluzívne pre verziu 22 a staršie verzie; nie je to dostupné vo verzii 23 a vyšších, ktoré podporujú iba HTTP/2.

6

Pripojte technickú podporu z NPS XSP/ADP.

7

Na každom AS serveri musí byť súbor namedefs v /usr/local/broadworks/bw_base/conf nakonfigurovaný so záznamami SRV a A pre Notification Push Server. (XSP/ADP) vyhľadávanie, ak je ich viacero XSP/ADP potom podľa potreby pridajte pre každý záznam.

Príklad: _pushnotification-klient._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com V A 10.193.78.149

Po nastavení je na prevzatie zmien potrebný jeden z nasledujúcich krokov:

  1. Reštart bw sa vykoná v rámci údržbového okna.

  2. Prostredníctvom rozhrania Cisco BroadWorks CLI:

    R24 a staršie

    AS_CLI/ASDiagnostic/DNS> znovu načítať

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> znovu načítať

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> znovu načítať

Čo robiť ďalej

V prípade nových inštalácií NPS prejdite na Konfigurácia NPS na používanie overovacieho proxy servera

Ak chcete migrovať existujúce nasadenie systému Android do FCMv1, prejdite na Migrácia NPS do FCMv1

Konfigurácia NPS na používanie overovacieho proxy servera

Táto úloha sa vzťahuje na novú inštaláciu NPS, vyhradenú pre Webex pre Cisco BroadWorks.

Ak chcete nakonfigurovať overovací proxy server na NPS, ktorý je zdieľaný s inými mobilnými aplikáciami, pozrite si časť Aktualizácia Cisco BroadWorks NPS na používanie proxy servera NPS.

1

Získanie prihlasovacích údajov OAuth pre váš Webex pre Cisco BroadWorks.

2

Vytvorte klientsky účet na 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

Ak chcete overiť, či sa zadané hodnoty zhodujú s tým, čo ste dostali, spustite XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

Adresa issuerUrl od CiscoCI by VŽDY mala byť klaster US CI bez ohľadu na vašu polohu a predvolená hodnota by mala byť: 

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

3

Zadajte URL adresu proxy NPS a nastavte interval obnovovania tokenu (odporúča sa 30 minút):

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

Pre zvýšenie rýchlosti prekladu DNS odporúčame namiesto aktuálneho FQDN nps.uc-one.broadsoft.com použiť vhodné FQDN na základe vášho regiónu.

Regiónové FQDN:

Východ USA:

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

Západ USA:

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

Európa:

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Ak push notifikácie vypršia z dôvodu oneskorenia v preklade DNS, zvýšte hodnotu časového limitu v "/etc/resolv.conf" súbor na serveri BroadWorks.

4

(Pre upozornenia systému Android) Pridajte ID aplikácie pre Android do kontextu aplikácií FCM na serveri NPS.

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

5

(Pre upozornenia Apple iOS) Pridajte ID aplikácie do kontextu aplikácií APNS a nezabudnite vynechať autorizačný kľúč – nastavte ho na prázdnu hodnotu.

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

6

Nakonfigurujte nasledujúce adresy URL servera NPS:

Kontext rozhrania príkazového riadka XSP|ADP

Parameter

Hodnota

  • 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

Nakonfigurujte nasledujúce parametre pripojenia NPS na zobrazené odporúčané hodnoty:

Kontext rozhrania príkazového riadka XSP|ADP

Parameter

Hodnota

  • 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

Skontrolujte, či aplikačný server kontroluje ID aplikácií, pretože možno budete musieť pridať aplikácie Webex do zoznamu povolených aplikácií:

  1. Spustite AS_CLI/System/PushNotification> get a skontrolujte hodnotu enforceAllowedApplicationList. Ak je to true, musíte dokončiť túto podúlohu. V opačnom prípade preskočte zvyšok podúlohy.

  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

Reštartujte XSP|ADP: bwrestart

10

Otestujte upozornenia na hovory uskutočnením hovorov z predplatiteľa BroadWorks dvom používateľom mobilnej aplikácie Webex. Overte, či sa upozornenie na hovor zobrazuje na zariadeniach so systémom iOS a Android.

Migrácia NPS do FCMv1

Táto téma obsahuje voliteľné postupy, ktoré môžete použiť v konzole Google FCM, keď máte existujúce nasadenie NPS, ktoré potrebujete migrovať na FCMv1. Existujú tri postupy:

Migrácia klientov UC-One do FCMv1

Na migráciu klientov UC-One do služby Google FCM HTTPv1 použite v konzole Google FCM nasledujúce kroky.

Ak sa na klienta aplikuje branding, klient musí mať ID odosielateľa. V konzole FCM pozrite Nastavenia projektu > Cloudové správy. Nastavenie sa zobrazí v tabuľke poverení projektu.

Podrobnosti nájdete v príručke Connect Mobile Branding Guide na adrese 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?. Pozrite si parameter gcm_defaultSenderId, ktorý sa nachádza v súprave Branding Kit, v priečinku Resource, v súbore branding.xml s nasledujúcou syntaxou:

xxxxxxxxxxxxx

  1. Prihláste sa do FCM Admin SDK na adrese http://console.firebase.google.com.

  2. Vyberte príslušnú aplikáciu pre Android.

  3. Na karte Všeobecné si zaznamenajte ID projektu

  4. Prejdite na kartu servisných účtov a nakonfigurujte servisný účet. Môžete si vytvoriť nový servisný účet alebo nakonfigurovať existujúci.

    Vytvorenie nového servisného účtu:

    1. Kliknite na modré tlačidlo pre vytvorenie nového servisného účtu

    2. Kliknite na modré tlačidlo pre vygenerovanie nového súkromného kľúča

    3. Stiahnite si kľúč na bezpečné miesto

    Ak chcete znova použiť existujúci servisný účet:

    1. Kliknite na modrý text pre zobrazenie existujúcich servisných účtov.

    2. Identifikujte servisný účet, ktorý chcete použiť. Servisný účet vyžaduje povolenie firebaseadmin-sdk.

    3. Úplne vpravo kliknite na ponuku hamburger a vytvorte nový súkromný kľúč.

    4. Stiahnite si súbor JSON, ktorý obsahuje kľúč, a uložte ho na bezpečné miesto.

  5. Skopírujte súbor JSON do XSP|ADP.

  6. Nakonfigurujte ID projektu a :

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

  7. Nakonfigurujte aplikáciu:

    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. Povoliť FCMv1:

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

  9. Spustením príkazu bwrestart reštartujete XSP|ADP.

Migrácia SaaS klientov do FCMv1

Ak chcete migrovať klientov SaaS na FCMv1, postupujte podľa krokov uvedených nižšie v konzole Google FCM.

Uistite sa, že ste už dokončili postup „Konfigurácia NPS na používanie overovacieho proxy servera“.

  1. Zakázať FCM:

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

  2. Spustením príkazu bwrestart reštartujete XSP|ADP.

  3. Povoliť FCM:

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

  4. Spustením príkazu bwrestart reštartujete XSP|ADP.

Aktualizácia ADP servera

Ak migrujete NPS na použitie servera ADP, postupujte podľa krokov uvedených nižšie v konzole Google FCM.

  1. Získajte súbor JSON z konzoly Google Cloud:

    1. V konzole Google Cloud prejdite na stránku Účty služieb.

    2. Kliknite na Vybrať projekt, vyberte svoj projekt a kliknite na Otvoriť.

    3. Nájdite riadok servisného účtu, pre ktorý chcete vytvoriť kľúč, kliknite na zvislé tlačidlo Viac a potom kliknite na Vytvoriť kľúč.

    4. Vyberte typ kľúča a kliknite na Vytvoriť

      Súbor sa stiahne.

  2. Pridajte FCM na ADP server:

    1. Importujte súbor JSON na ADP server pomocou príkazu /bw/install.

    2. Prihláste sa do rozhrania príkazového riadka ADP a pridajte kľúč projektu a API:

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

    3. Ďalej pridajte aplikáciu a kľúč:

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

    4. Overte konfiguráciu:

      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
Bol tento článok užitočný?
Bol tento článok užitočný?
CenyAplikácia WebexMeetingsCallingOdosielanie správZdieľanie obrazovky
Webex SuiteCallingMeetingsOdosielanie správSlidoWebinarsEventsContact CenterCPaaSZabezpečenieControl Hub
Náhlavné súpravyKamerySéria DeskSéria RoomSéria BoardSéria PhonePríslušenstvo
Vzdelávacie inštitúcieZdravotnícke organizácieŠtátne orgányFinancieŠport a zábavaPrvá líniaNeziskové organizácieStartupyHybridná práca
Na stiahnutiePripojiť sa k testovacej schôdziOnline lekcieIntegráciePrístupnosťInkluzívnosťWebináre naživo a na vyžiadanieKomunita WebexVývojári služby WebexNovinky a inovácie
CiscoKontaktovať podporuKontakt na predajWebex BlogOdborné kapacity na WebexeObchod s tovarom spoločnosti WebexKariéra
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Zmluvné podmienkyVyhlásenie o ochrane osobných údajovSúbory cookieOchranné známky
©2026 Spoločnosť Cisco a jej pridružené spoločnosti. Všetky práva vyhradené.
Zmluvné podmienkyVyhlásenie o ochrane osobných údajovSúbory cookieOchranné známky