05. června 2025 | 21 zobrazení | 0 osob/y, podle nichž byl obsah užitečný

Konfigurace push notifikací o hovorech pro Webex BroadWorks

list-menuZpětná vazba?
Naučte se, jak nastavit push notifikace o hovorech pro Webex pro BroadWorks pomocí NPS pro Android a iOS.

V tomto dokumentu používáme termín Call Notifications Push Server (CNPS) k popisu aplikace hostované XSP nebo ADP, která běží ve vašem prostředí. Váš CNPS spolupracuje s vaším systémem BroadWorks, aby byl informován o příchozích hovorech s vašimi uživateli, a odesílá oznámení o těchto hovorech do služeb Google Firebase Cloud Messaging (FCM) nebo Apple Push Notification Service (APNs).

Tyto služby upozorňují mobilní zařízení Webex pro předplatitele Cisco BroadWorks, že mají příchozí hovory na Webexu.

Další informace o serveru NPS naleznete v tématu Popis funkce serveru push NotificationPush .

Podobný mechanismus ve Webexu pracuje se službami zasílání zpráv a přítomnosti Webex pro nabízená oznámení do oznamovacích služeb Google (FCM) nebo Apple (APNS). Tyto služby zase upozorňují uživatele mobilního Webexu na příchozí zprávy nebo změny stavu.

Tato část popisuje, jak nakonfigurovat NPS pro ověřovací proxy, pokud NPS ještě nepodporuje jiné aplikace. Pokud potřebujete migrovat sdílený NPS pro použití proxy NPS, přečtěte si Aktualizace Cisco BroadWorks NPS pro použití proxy NPS.

Proxy server NPS – přehled

Pro kompatibilitu s Webexem pro Cisco BroadWorks musí být váš CNPS opraven tak, aby podporoval funkci proxy serveru NPS, Push Server pro VoIP v UCaaS.

Tato funkce implementuje nový návrh serveru Notification Push Server, který řeší chybu zabezpečení sdílení soukromých klíčů certifikátu nabízených oznámení s poskytovateli služeb pro mobilní klienty. Namísto sdílení certifikátů a klíčů nabízených oznámení s poskytovatelem služeb používá server NPS nové rozhraní API k získání tokenu nabízených oznámení s krátkou životností z Webexu pro back-end Cisco BroadWorks a používá tento token k ověřování pomocí služeb Apple APNs a Google FCM.

Tato funkce také vylepšuje schopnost serveru Notification Push Server nabízet oznámení do zařízení Android prostřednictvím nového rozhraní Google Firebase Cloud Messaging (FCM) HTTPv1 API.

Důležité informace o APNS

Apple již nebude podporovat binární protokol založený na HTTP / 1 ve službě Apple Push Notification po 31. březnu 2021. Doporučujeme nakonfigurovat váš XSP|ADP tak, aby používal HTTP/2-based rozhraní pro APN. Tato aktualizace vyžaduje, aby váš XSP|ADP hostující NPS používal verzi R22 nebo novější.

Příprava serveru NPS pro Webex pro Cisco BroadWorks

1

Nainstalujte a nakonfigurujte vyhrazený XSP (minimální verze R22) nebo Application Delivery Platform (ADP).

2

Nainstalujte opravy proxy serveru NPS authentication:

Opravy XSP R22:

Opravy XSP R23:

3

Aktivujte aplikaci Notification Push Server.

4

(Pro oznámení systému Android) Povolte rozhraní API FCM v1 na serveru NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Pro oznámení Apple iOS) Povolte protokol HTTP/2 na serveru NPS.

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

Toto je exkluzivní pro verzi 22 a starší; není k dispozici ve verzích 23 a vyšších, které podporují pouze HTTP/2.

6

Připojte technickou podporu z serveru NPS XSP/ADP.

7

Na každém AS serveru musí být soubor namedefs v /usr/local/broadworks/bw_base/conf nakonfigurován se záznamy SRV a A pro Notification Push Server. (XSP/ADP) vyhledávání, pokud je jich více XSP/ADP pak pro každý z nich dle potřeby přidejte položku.

Pří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 pro uložení změn vyžadován jeden z následujících kroků:

  1. Restart bw by měl být proveden v údržbovém okně.

  2. Prostřednictvím rozhraní příkazového řádku Cisco BroadWorks:

    R24 a starší

    AS_CLI/ASDiagnostic/DNS> znovu načíst

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> znovu načíst

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> znovu načíst

Co dělat dál

Pro nové instalace NPS přejděte na Konfigurace NPS pro použití ověřovacího proxy serveru

Chcete-li migrovat stávající nasazení systému Android do FCMv1, přejděte na Migrace NPS do FCMv1

Konfigurace NPS pro použití ověřovacího proxy serveru

Tato úloha se týká nové instalace serveru NPS vyhrazeného pro Webex pro Cisco BroadWorks.

Pokud chcete nakonfigurovat ověřovací proxy na NPS sdíleném s jinými mobilními aplikacemi, přečtěte si Aktualizace Cisco BroadWorks NPS pro použití proxy NPS.

1

Získání přihlašovacích údajů OAuth pro váš Webex pro Cisco BroadWorks.

2

Vytvořte klientský účet na serveru 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

Chcete-li ověřit, zda se zadané hodnoty shodují s tím, co jste zadali, spusťte příkaz XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

Adresa issuerUrl CiscoCI by VŽDY měla být cluster US CI bez ohledu na vaši polohu a výchozí hodnota by měla být: 

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

3

Zadejte adresu URL proxy serveru NPS a nastavte interval aktualizace tokenu (doporučuje se 30 minut):

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

Pro zvýšení rychlosti překladu DNS doporučujeme místo aktuálního FQDN nps.uc-one.broadsoft.com použít vhodné FQDN podle vašeho regionu.

FQDN založené na regionu:

USA – východ:

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/

Evropa:

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Pokud push notifikace vyprší kvůli zpoždění v překladu DNS, zvyšte hodnotu časového limitu v "/etc/resolv.conf" soubor na serveru BroadWorks.

4

(Pro oznámení systému Android) Přidejte ID aplikace pro Android do kontextu aplikací FCM na serveru NPS.

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

5

(Pro oznámení Apple iOS) Přidejte ID aplikace do kontextu aplikací APNS a nezapomeňte vynechat ověřovací klíč – nastavte jej na prázdný.

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

6

Nakonfigurujte následující adresy URL serveru NPS:

Kontext příkazového řádku XSP|ADP

Parametr

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 následující parametry připojení serveru NPS na zobrazené doporučené hodnoty:

Kontext příkazového řádku XSP|ADP

Parametr

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

Zkontrolujte, zda aplikační server kontroluje ID aplikací, protože možná budete muset přidat aplikace Webex do seznamu povolených aplikací:

  1. Spusťte AS_CLI/System/PushNotification> get a zkontrolujte hodnotu enforceAllowedApplicationList. Pokud je to true, musíte dokončit tento dílčí úkol. V opačném případě přeskočte zbytek dílčí ú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

Restartujte XSP|ADP: bwrestart

10

Otestujte oznámení o volání uskutečněním hovorů od předplatitele BroadWorks dvěma mobilním uživatelům Webex. Ověřte, zda se oznámení o hovoru zobrazuje na zařízeních iOS a Android.

Migrace serveru NPS na FCMv1

Toto téma obsahuje volitelné postupy, které můžete použít v konzole Google FCM Console, pokud máte existující nasazení serveru NPS, které potřebujete migrovat na FCMv1. Existují tři postupy:

Migrace klientů UC-One do FCMv1

Pomocí níže uvedených kroků v konzoli Google FCM migrujte klienty UC-One na Google FCM HTTPv1.

Pokud je branding aplikován na klienta, musí mít klient ID odesílatele. V konzole FCM si přečtěte téma Nastavení projektu > Cloud Messaging . Nastavení se zobrazí v tabulce přihlašovacích údajů projektu.

Podrobnosti naleznete v průvodci brandingem Connect Mobile 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?. Viz parametr gcm_defaultSenderId, který se nachází v souboru branding.xml ve složce Resource sady Branding Kit s následující syntaxí:

xxxxxxxxxxxxx

  1. Přihlaste se k sadě FCM Admin SDK na adrese http://console.firebase.google.com.

  2. Vyberte příslušnou aplikaci pro Android.

  3. Na kartě Obecné si poznamenejte ID projektu

  4. Přejděte na kartu účty služeb a nakonfigurujte účet služby. Můžete vytvořit nový účet služby nebo nakonfigurovat existující.

    Vytvoření nového účtu služby:

    1. Kliknutím na modré tlačítko vytvoříte nový účet služby.

    2. Kliknutím na modré tlačítko vygenerujete nový soukromý klíč

    3. Stáhnout klíč na bezpečné místo

    Opětovné použití existujícího účtu služby:

    1. Kliknutím na modrý text zobrazíte existující účty služeb.

    2. Identifikujte účet služby, který se má použít. Účet služby potřebuje oprávnění firebaseadmin-sdk.

    3. Úplně vpravo klikněte na hamburgerovou nabídku a vytvořte nový soukromý klíč.

    4. Stáhněte si soubor JSON, který obsahuje klíč, a uložte jej do zabezpečeného umístění.

  5. Zkopírujte soubor JSON do XSP|ADP.

  6. Nakonfigurujte ID projektu a :

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

  7. Nakonfigurujte aplikaci:

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

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

  9. Spuštěním příkazu bwrestart restartujte XSP|ADP.

Migrace klientů SaaS na FCMv1

Pokud chcete migrovat klienty SaaS na FCMv1, použijte níže uvedené kroky v konzole Google FCM Console.

Ujistěte se, že jste již dokončili postup Konfigurace serveru NPS pro použití ověřovacího proxy serveru.

  1. Zakázat FCM:

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

  2. Spuštěním příkazu bwrestart restartujte XSP|ADP.

  3. Povolit FCM:

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

  4. Spuštěním příkazu bwrestart restartujte XSP|ADP.

Aktualizace serveru ADP

Pokud migrujete server NPS na server ADP, použijte níže uvedené kroky v konzole Google FCM Console.

  1. Získejte soubor JSON z Google Cloud Console:

    1. V konzoli Google Cloud Console přejděte na stránku Účty služeb.

    2. Klikněte na Vybrat projekt, vyberte projekt a klikněte na Otevřít.

    3. Vyhledejte řádek servisního účtu, pro který chcete vytvořit klíč, klikněte na svislé tlačítko Více a poté klikněte na Vytvořit klíč.

    4. Vyberte typ klíče a klikněte na Vytvořit

      Soubor se stáhne.

  2. Přidejte FCM na server ADP:

    1. Importujte soubor JSON na ADP server pomocí příkazu /bw/install.

    2. Přihlaste se do rozhraní příkazového řádku ADP a přidejte klíč projektu a rozhraní API:

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

    3. Dále přidejte aplikaci a klíč:

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

    4. Ověřte konfiguraci:

      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
Byl tento článek užitečný?
Byl tento článek užitečný?
CenyAplikace WebexSchůzkyCallingZasílání zprávSdílení obrazovky
Webex SuiteCallingSchůzkyZasílání zprávSlidoWebinářeEventsKontaktní centrumCPaaSZabezpečeníControl Hub
Náhlavní soupravyKameryŘada stolůŘada RoomŘada BoardŘada PhonePříslušenství
VzděláváníZdravotní péčeVládaFinanceSport a zábavaFrontlineNeziskové aktivityStart-upyHybridní práce
Stažené souboryPřipojit se k testovací schůzceOnline lekceIntegraceUsnadnění přístupuInkluzivitaWebináře naživo a na vyžádáníKomunita WebexVývojáři WebexNovinky a inovace
CiscoKontaktovat podporuKontaktovat obchodní odděleníWebex BlogMyšlenkový leadership WebexObchod Webex MerchKariéra
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Smluvní podmínkyProhlášení o ochraně osobních údajůSoubory cookieOchranné známky
©2026 Společnost Cisco a/nebo její pobočky. Všechna práva vyhrazena.
Smluvní podmínkyProhlášení o ochraně osobních údajůSoubory cookieOchranné známky