05 czerwca 2025 | 19 — liczba wyświetleń | 0 — liczba osób, które uznały to za pomocne

Konfigurowanie powiadomień push o połączeniach dla Webex BroadWorks

list-menuOpinia?
Dowiedz się, jak skonfigurować powiadomienia push o połączeniach dla Webex for BroadWorks przy użyciu NPS dla systemów Android i iOS.

W tym dokumencie używamy terminu Call Notifications Push Server (CNPS) do opisania aplikacji hostowanej przez XSP lub hostowanej przez ADP, która działa w Danym środowisku. CNPS współpracuje z systemem BroadWorks, aby być świadomym połączeń przychodzących do użytkowników i przesyła powiadomienia o nich do usług powiadomień Google Firebase Cloud Messaging (FCM) lub Apple Push Notification Service (APNs).

Usługi te powiadamiają urządzenia mobilne Webex dla abonentów Cisco BroadWorks, że mają połączenia przychodzące na Webex.

Aby uzyskać więcej informacji na temat serwera NPS, zobacz Opis funkcji serwera wypychania powiadomień.

Podobny mechanizm w Webex współpracuje z usługami przesyłania wiadomości i obecności Webex w celu wysyłania powiadomień do usług powiadomień Google (FCM) lub Apple (APNS). Usługi te z kolei powiadamiają użytkowników mobilnego Webex o przychodzących wiadomościach lub zmianach obecności.

W tej sekcji opisano sposób konfiguracji serwera NPS dla serwera proxy uwierzytelniania w sytuacji, gdy serwer NPS nie obsługuje innych aplikacji. Jeśli konieczna jest migracja współdzielonego serwera NPS w celu użycia serwera proxy NPS, zapoznaj się z tematem Aktualizacja serwera NPS Cisco BroadWorks w celu użycia serwera proxy NPS.

Omówienie serwera proxy serwera NPS

Aby zapewnić zgodność z Webex dla Cisco BroadWorks, CNPS musi być załatany w celu obsługi funkcji SERWERA proxy NPS, Push Server for VoIP w UCaaS.

Ta funkcja implementuje nowy projekt na serwerze wypychania powiadomień, aby rozwiązać lukę w zabezpieczeniach polegającą na udostępnianiu kluczy prywatnych certyfikatu powiadomień wypychanych dostawcom usług dla klientów mobilnych. Zamiast udostępniać certyfikaty i klucze powiadomień wypychanych usługodawcy, serwer NPS używa nowego interfejsu API do uzyskania krótkotrwałego tokenu powiadomień wypychanych z Webex dla zaplecza Cisco BroadWorks i używa tego tokenu do uwierzytelniania za pomocą usług Apple APNs i Google FCM.

Ta funkcja zwiększa również możliwości serwera powiadomień push do wysyłania powiadomień do urządzeń z systemem Android za pośrednictwem nowego interfejsu API Google Firebase Cloud Messaging (FCM) HTTPv1.

Zagadnienia dotyczące usługi APNS

Firma Apple nie będzie już obsługiwać protokołu binarnego opartego na protokole HTTP/1 w usłudze Apple Push Notification po 31 marca 2021 r. Zalecamy skonfigurowanie XSP|ADP w celu użycia HTTP/2-based interfejs dla APN-ów. Ta aktualizacja wymaga, aby na Twoim serwerze ADP XSP|hostującym serwer NPS działała wersja R22 lub nowsza.

Przygotuj serwer NPS dla Webex dla Cisco BroadWorks

1

Zainstaluj i skonfiguruj dedykowany XSP (minimalna wersja R22) lub Application Delivery Platform (ADP).

2

Zainstaluj poprawki serwera proxy uwierzytelniania serwera proxy serwera NPS:

Łatki XSP R22:

Plastry XSP R23:

3

Aktywuj aplikację Notification Push Server.

4

(W przypadku powiadomień na Androida) Włącz interfejs API FCM v1 na serwerze NPS.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(W przypadku powiadomień Apple iOS) Włącz protokół HTTP/2 na serwerze NPS.

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

Funkcja ta jest dostępna wyłącznie w wersji Release 22 i wcześniejszych. Nie jest dostępna w wersjach Release 23 i nowszych, które obsługują wyłącznie HTTP/2.

6

Dołącz pomoc techniczną z SERWERA NPS XSP/ADP.

7

Na każdym serwerze AS plik namedefs w /usr/local/broadworks/bw_base/conf musi być skonfigurowany z rekordami SRV i A dla serwera powiadomień push (XSP/ADP) wyszukiwanie, jeśli wielokrotne XSP/ADP Następnie dodaj wpis dla każdego z nich, jeśli to konieczne.

Przykład: _pushnotification-klient._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com W 10.193.78.149

Po ustawieniu, aby zmiany zostały uwzględnione, wymagane jest wykonanie jednej z poniższych czynności:

  1. Ponowne uruchomienie może zostać wykonane w oknie konserwacyjnym.

  2. Za pomocą interfejsu wiersza poleceń Cisco BroadWorks:

    R24 i starsze

    AS_CLI/ASDiagnostic/DNS> ponownie załaduj

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> ponownie załaduj

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> ponownie załaduj

Co zrobić dalej

W przypadku nowych instalacji serwera NPS przejdź do Konfigurowanie serwera NPS w celu użycia serwera proxy uwierzytelniania

Aby przeprowadzić migrację istniejącego wdrożenia systemu Android do FCMv1, przejdź do Migracja NPS do FCMv1

Konfigurowanie serwera NPS w celu użycia serwera proxy uwierzytelniania

To zadanie dotyczy nowej instalacji NPS, dedykowanej Webex dla Cisco BroadWorks.

Jeśli chcesz skonfigurować serwer proxy uwierzytelniania na serwerze NPS współdzielonym z innymi aplikacjami mobilnymi, zapoznaj się z tematem Aktualizowanie serwera NPS Cisco BroadWorks w celu używania serwera proxy NPS.

1

Uzyskiwanie danych uwierzytelniających OAuth dla Webex dla Cisco BroadWorks.

2

Utwórz konto klienta na serwerze 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

Aby sprawdzić, czy wprowadzone wartości są zgodne z podanymi wartościami, uruchom XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

Adres URL wystawcy CiscoCI powinien ZAWSZE wskazywać klaster CI w USA, niezależnie od Twojej lokalizacji, a wartość domyślna powinna być następująca: 

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

3

Wprowadź adres URL serwera proxy serwera NPS i ustaw interwał odświeżania tokenu (zalecane 30 minut):

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

Aby zwiększyć szybkość rozpoznawania nazw DNS, zamiast obecnej nazwy FQDN nps.uc-one.broadsoft.com, zalecamy użycie odpowiedniej nazwy FQDN w oparciu o Twój region.

Nazwy FQDN oparte na regionach:

Wschodnie stany USA:

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

Zachód 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

Jeśli powiadomienia push przekroczą limit czasu z powodu opóźnienia w rozwiązywaniu nazw domen (DNS), zwiększ wartość limitu czasu w "/etc/resolv.conf" plik na serwerze BroadWorks.

4

(W przypadku powiadomień na Androida) Dodaj identyfikator aplikacji systemu Android do kontekstu aplikacji FCM na serwerze NPS.

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

5

(W przypadku powiadomień Apple iOS) Dodaj identyfikator aplikacji do kontekstu aplikacji APNS, pomijając klucz Auth – ustaw go na pusty.

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

6

Skonfiguruj następujące adresy URL serwera NPS:

XSP|Kontekst ADP CLI

Parametr

Wartość

  • 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

Skonfiguruj następujące parametry połączenia serwera NPS zgodnie z wyświetlanymi zalecanymi wartościami:

XSP|Kontekst ADP CLI

Parametr

Wartość

  • 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

Sprawdź, czy serwer aplikacji sprawdza identyfikatory aplikacji, ponieważ może być konieczne dodanie aplikacji Webex do listy dozwolonych:

  1. Uruchom AS_CLI/System/PushNotification> get i sprawdź wartość enforceAllowedApplicationList. Jeśli to jest true, musisz wykonać to podzadanie. W przeciwnym razie pomiń resztę zadania podrzędnego.

  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

Uruchom ponownie XSP|ADP: bwrestart

10

Testuj powiadomienia o połączeniach, wykonując połączenia od abonenta BroadWorks do dwóch użytkowników mobilnych Webex. Sprawdź, czy powiadomienie o połączeniu pojawia się na urządzeniach z systemem iOS i Android.

Migracja serwera NPS do fcMv1

Ten temat zawiera opcjonalne procedury, których możesz używać w Konsoli FCM Google, gdy masz już wdrożenie serwera NPS, które musisz przenieść do FCMv1. Istnieją trzy procedury:

Migracja klientów UC-One do FCMv1

Aby przeprowadzić migrację klientów UC-One do Google FCM HTTPv1, wykonaj poniższe czynności w konsoli Google FCM.

Jeśli do klienta zostanie zastosowana marka, klient musi mieć identyfikator nadawcy. W konsoli FCM zobacz Ustawienia projektu > Cloud Messaging. To ustawienie pojawi się w tabeli poświadczenia projektu.

Więcej szczegółów znajdziesz w Przewodniku po brandingu mobilnym Connect pod adresem 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?. Odnieś się do parametru gcm_defaultSenderId znajdującego się w pliku branding.xml w folderze Resource pakietu Branding Kit, stosując poniższą składnię:

xxxxxxxxxxxxx

  1. Zaloguj się do FCM Admin SDK pod adresem http://console.firebase.google.com.

  2. Wybierz odpowiednią aplikację na Androida.

  3. Na karcie Ogólne zapisz identyfikator projektu

  4. Przejdź do karty konta usług, aby skonfigurować konto usługi. Można utworzyć nowe konto usługi lub skonfigurować istniejące.

    Aby utworzyć nowe konto usługi:

    1. Kliknij niebieski przycisk, aby utworzyć nowe konto usługi

    2. Kliknij niebieski przycisk, aby wygenerować nowy klucz prywatny

    3. Pobierz klucz do bezpiecznej lokalizacji

    Aby ponownie użyć istniejącego konta usługi:

    1. Kliknij niebieski tekst, aby wyświetlić istniejące konta usług.

    2. Zidentyfikuj konto usługi, które ma być używane. Konto usługi wymaga uprawnienia firebaseadmin-sdk.

    3. Po prawej stronie kliknij menu hamburgera i utwórz nowy klucz prywatny.

    4. Pobierz plik json zawierający klucz i zapisz go w bezpiecznej lokalizacji.

  5. Skopiuj plik json do XSP|ADP.

  6. Skonfiguruj identyfikator projektu i:

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

  7. Skonfiguruj aplikację:

    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. Włącz FCMv1:

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

  9. Uruchom polecenie bwrestart, aby ponownie uruchomić XSP|ADP.

Migracja klientów SaaS do FCMv1

Wykonaj poniższe czynności w konsoli Google FCM, jeśli chcesz przeprowadzić migrację klientów SaaS do FCMv1.

Upewnij się, że procedura "Konfigurowanie serwera NPS do korzystania z serwera proxy uwierzytelniania" została już zakończona.

  1. Wyłącz FCM:

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

  2. Uruchom polecenie bwrestart, aby ponownie uruchomić XSP|ADP.

  3. Włącz FCM:

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

  4. Uruchom polecenie bwrestart, aby ponownie uruchomić XSP|ADP.

Aktualizowanie serwera ADP

Wykonaj poniższe czynności w Konsoli Google FCM, jeśli migrujesz serwer NPS w celu korzystania z serwera ADP.

  1. Pobierz plik JSON z konsoli Google Cloud:

    1. W konsoli Google Cloud otwórz stronę Konta usług.

    2. Kliknij wybierz projekt , wybierz projekt i kliknij Otwórz .

    3. Znajdź wiersz konta usługi, dla którego chcesz utworzyć klucz, kliknij pionowy przycisk Więcej, a następnie kliknij Utwórz klucz.

    4. Wybierz typ kluczai kliknij Utwórz

      Plik zostanie pobrany.

  2. Dodaj FCM do serwera ADP:

    1. Zaimportuj plik JSON do serwera ADP za pomocą polecenia /bw/install.

    2. Zaloguj się do interfejsu wiersza polecenia ADP i dodaj klucz projektu i API:

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

    3. Następnie dodaj aplikację i klucz:

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

    4. Sprawdź konfigurację:

      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
Czy ten artykuł był pomocny?
Czy ten artykuł był pomocny?
CennikAplikacja WebexMeetingsCallingWiadomościUdostępnianie ekranu
Webex SuiteCallingMeetingsWiadomościSlidoWebinariaWydarzeniaCentrum kontaktuCPaaSZabezpieczeniaControl Hub
Zestawy słuchawkoweAparatySeria DeskSeria RoomSeria BoardSeria telefonówAkcesoria
EdukacjaOpieka zdrowotnaAdministracja państwowaFinanseSport i rozrywkaPracownicy pierwszego kontaktuOrganizacje non profitStart-upyPraca hybrydowa
Pliki do pobraniaDołącz do spotkania testowegoKursy onlineIntegracjeDostępnośćInkluzywnośćWebinaria na żywo i na żądanieSpołeczność WebexDeweloperzy WebexNowości i innowacje
CiscoKontakt z pomocąKontakt z działem sprzedażyWebex BlogŚwiadome przywództwo WebexWebex Merch StoreKariera
  • X
  • LinkedIn
  • Facebook
  • Youtube
  • Instagram
Warunki korzystaniaZasady ochrony prywatnościPliki cookieZnaki towarowe
©2026 Cisco lub podmioty zależne. Wszelkie prawa zastrzeżone.
Warunki korzystaniaZasady ochrony prywatnościPliki cookieZnaki towarowe