V tomto článku
Prehľad NPS Authentication Proxy
dropdown icon
Predpoklady NPS Authentication Proxy
    Minimálne verzie a obmedzenia spoločného pobytu
    Zdieľané NPS
    APN HTTP/2
    Android FCMv1
Súhrn migrácie proxy NPS
Migrácia aplikácií BroadWorks Collaborate iOS na HTTP/2
Migrácia aplikácií pre Android BroadWorks UC-One Connect/SaaS na FCMv1
Migrácia aplikácií BroadWorks UC-One Connect/SaaS pre Android do FCMv1 (na ADP)
Opätovne povoľte režim FCM Legacy
dropdown icon
Nainštalujte opravy NPS Authentication Proxy
    Náplasti R22
    Náplasti R23
Nakonfigurujte NPS tak, aby používal autentifikačný proxy
Reštartujte NPS a otestujte upozornenia Push
10. októbra 2026 | 858 zobrazenia | 0 ľudia to považujú za užitočné
Aktualizujte Cisco BroadWorks NPS na používanie NPS Proxy: Sprievodca konfiguráciou
list-menuV tomto článku
list-menuSpätná väzba?

Prečítajte si, ako aktualizovať Cisco BroadWorks NPS na používanie NPS Proxy pomocou tejto konfiguračnej príručky. Objavte podrobné pokyny, úvahy a osvedčené postupy pre bezproblémovú integráciu a zvýšený výkon siete.

Prehľad NPS Authentication Proxy

Tento článok popisuje, ako nakonfigurovať zdieľaný NPS tak, aby používal autentifikačný proxy NPS, aby ho bolo možné použiť aj na presunutie upozornení na hovory do aplikácií Webex. Ak váš NPS nepodporuje iné aplikácie, môžete postupovať podľa zjednodušeného postupu v príručke riešení Webex for BroadWorks.

Prehľad NPS Proxy

Pre kompatibilitu s Webex pre BroadWorks musí byť váš NPS opravený, aby podporoval funkciu NPS Proxy, P ush Server for VoIP v UCAA.

Táto funkcia implementuje nový dizajn v Notification Push Server na vyriešenie bezpečnostnej chyby zdieľania súkromných kľúčov certifikátu push notifikácie s poskytovateľmi služieb pre mobilných klientov. Namiesto zdieľania push notifikačných certifikátov a kľúčov s poskytovateľom služieb používa NPS nové rozhranie API na získanie krátkodobého tokenu upozornení push z backendu UCaaS a používa tento token na autentifikáciu s Apple APN a službami Google FCM.

Táto funkcia tiež zvyšuje schopnosť Notification Push Server presúvať upozornenia na zariadenia s Androidom prostredníctvom nového rozhrania Google Firebase Cloud Messaging (FCM) HTTPv1 API.

Predpoklady NPS Authentication Proxy

XSP (alebo platforma na doručovanie aplikácií ADP), na ktorom je hostiteľom NPS, musí spĺňať nasledujúce požiadavky:

Minimálne verzie a obmedzenia spoločného pobytu

  • NPS musí byť aktivovaný na vyhradenom XSP/ADP a NPS musí byť jedinou hosťovanou aplikáciou na serveri. Tým sa eliminuje rušenie doručovania upozornení Push.

  • V nasadení by mala byť iba jedna aplikácia NPS. Ak používate mobilné UC-One Collaborate/Connect alebo UC-One SaaS a implementujete Webex pre BroadWorks, musíte zdieľať tento jediný NPS pre všetky aplikácie.

  • NPS musí byť vo verzii R22 alebo novšej XSP alebo ADP.

    R22/R23 XSP je kompatibilný so stohom R21, ak XSP beží iba NPS a AS je R21.SP1. Ďalšie informácie nájdete v matici kompatibility BroadWor ks.

  • Viac informácií o serveri ADP nájdete na platforme Cisco BroadWorks Application Delivery Platform.

Zdieľané NPS

Prečítajte si tieto poznámky predtým, ako nakonfigurujete zdieľaný NPS NPS Proxy na používanie NPS Proxy:

  • Ak sa váš NPS používa s inými aplikáciami (nielen s aplikáciou Webex): Najprv nakonfigur ujte NPS proxy a potom zmeňte NPS z používania staršieho rozhrania API FCM na použitie rozhrania FCM HTTP v1 API.

  • Po overení, či upozornenia fungujú správne pre staršie aplikácie s proxy NPS, odstráňte kľúč FCM API pre aplikáciu pre Android a kľúč APN pre aplikáciu iOS.

APN HTTP/2

  • Ak ste nasadili nejaké aplikácie pre iOS, ktoré nie sú od spoločnosti Cisco/BroadSoft, nakonfigurujte tieto aplikácie tak, aby používali protokol HTTP/2 APNS predtým, ako nastavíte NPS na používanie proxy NPS.

  • XSP/ADP, ktoré už podporujú aplikáciu Collaborate alebo SaaS BroadWorks, je potrebné migrovať na HTTP/2. Podrobné informácie o konfigurácii HTTP/2 nájdete v téme Pod pora HTTP/2 na Notification Push Server pre APNS (migrácia NPS na podporu týchto aplikácií pre iOS je z hrnutá v tomto článku).

Android FCMv1

  • Ak ste nasadili nejaké aplikácie pre Android, ktoré nie sú od spoločnosti Cisco/BroadSoft, nakonfigurujte tieto aplikácie tak, aby používali klávesy FCMv1 pred konfiguráciou NPS na používanie proxy NPS.

  • Ak XSP/ADP momentálne podporuje aplikáciu Connect alebo UC-One SaaS, povoľte kľúče FCMv1 po konfigurácii proxy NPS. Odporúčame migrovať všetky ďalšie aplikácie na klávesy FCMv1, povoliť a otestovať a potom zakázať, kým nebudete pripravení dokončiť pokyny na nastavenie (tok migrácie je z dokumentovaný v tomto článku).

Súhrn migrácie proxy NPS

Vizuálne zhrnutie migrácie na NPS Authentication Proxy
Tabuľka 1. Zhrnutie úloh na migráciu do NPS Proxy

Sekvencia

Názov úlohy

Kedy a prečo je úloha potrebná?

1

Migrácia NPS na HTTP/2 pre aplikácie UC-One SaaS (alebo Connect) pre iOS.

Ak NPS tieto aplikácie podporuje a ešte nie sú nakonfigurované pre HTTP/2.

2

Migrácia NPS na FCMv1 pre aplikácie UC-One SaaS (alebo Connect) pre Android.

Ak NPS tieto aplikácie podporuje a ešte nie sú nakonfigurované pre FCMv1.

3

Zapnite režim FCMv1 a otestujte upozornenia push.

Ak NPS podporuje UC-One Connect a/alebo iné (iné ako Cisco) aplikácie pre Android.

4

Znovu povoľte starší režim FCM.

Ak NPS podporuje UC-One SaaS. Ak necháte povolený FCMv1, pred nakonfigurovaním proxy NPS začnú zlyhať upozornenia push na UC-One SaaS.

5

Nainštalujte opravy proxy autentifikácie NPS.

Ak je NPS na XSP R22 alebo XSP R23.

6

Nakonfigurujte NPS tak, aby používal autentifikačný proxy NPS:

  • Pripojte technickú podporu od NPS

  • Vyžiadajte si účet CI OAuth

  • Vytvorte účet CI na NPS a nakonfigurujte časový limit obnovovacieho tokenu

  • Pridajte identifikátory aplikácií pre Android

  • Pridajte identifikátory aplikácií pre iOS

  • Začiarknuté/nastavenie adries URL a časových limitov pripojenia

  • Pridanie aplikácií do zoznamu povolení AS

  • (Re-) Povoliť FCMv1

  • Reštartujte XSP/ADP

  • Testujte PN pre aplikácie pre iOS a Android

Vždy sa vyžaduje.

7

Odstráňte klávesy staršieho režimu FCM.

Pre aplikácie, ktoré sú úspešne podporované NPS na FCMv1.

Migrácia aplikácií BroadWorks Collaborate iOS na HTTP/2

Táto úloha je povinná pre upozornenia push do aplikácií UC-One SaaS a Webex na platformách iOS.

Skôr ako začnete

Ak je váš XSP spustený R22, musíte použiť ap354313 predtým, ako budete môcť nakonfigurovať aplikáciu NPS tak, aby používala HTTP/2 pre APNS.

1

Nastavte produkčnú URL a parametre pripojenia na X SP_CLI/Applications/NotificationPushServer/APNS/Production>

nastaviť adresu URL https://api.push.apple.com/3/device

nastaviť pripojeniePoolVeľkosť 2

nastaviť pripojenieTimeout 3000

nastaviť pripojenieIdleTimeOutInSeconds 600

Poznámka: Nenastavujte časový limit pripojenia pod 1000.

2

Pridajte ID aplikácií do kontextu aplikácií APNS a nezabudnite vynechať kľúč Auth — nastavte ho na prázdny.

Pre UC-One SaaS: X SP_CLI/Aplikácie/NotificationPushServer/APNS/Production/Tokens> pridať com.broadsoft.uc-one

Pre aplikáciu Webex: X SP_CLI/Aplikácie/NotificationPushServer/APNS/Production/Tokens> pridať com.cisco.squared

3

Skontrolujte klávesy auth pomocou X SP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> získať

4

Ak kľúč auth nie je prázdny pre com.broadsoft.uc-one, môžete ho vymazať pomocou XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> vymazať autentifikačný kľúč

5

Povoliť HTTP/2:

XSP_CLI /Aplikácie/NotificationPushServer/APNS/Všeobecné nastavenia> nastaviť hodnotu HTTP2Enabled true

6

Iba pre aplikácie UC-One SaaS: Prihláste sa na portál predajcov a prejdite na Konfigurácia > BroadWorks >.

7

Prejdite nadol do sekcie Notification Push Server a vyberte vydanie (napr. R elease 22) a postupujte podľa pokynov uvedených na portáli.

Migrácia aplikácií pre Android BroadWorks UC-One Connect/SaaS na FCMv1

  • Táto úloha sa vzťahuje na NPS na XSP. Ignorujte ho, ak je váš NPS na ADP.

  • Tento postup môžete použiť na migráciu upozornení na FCMv1 pre aplikácie UC-One Connect alebo UC-One SaaS pre Android.

  • Ak chcete použiť proxy NPS na overenie push upozornení v aplikáciách UC-One alebo Webex pre Android, musíte použiť FCMv1.

  • Táto úloha pripraví NPS pre FCMv1, aby ste ho mohli povoliť ako súčasť konfigurácie autentifikačného proxy NPS. Nepoužívajte FCMv1, kým nie ste pripravení nakonfigurovať servera proxy autentifikácie NPS, inak upozornenia klientom SaaS zlyhajú.

1

Získajte ID projektu z konzoly Firebase:

  1. Prihláste sa na console.firebase.google.com.

  2. Vyberte projekt aplikácie UC-One (Connect alebo SaaS) a otvorte jeho nastavenia projektu.

  3. Otvorte kartu V šeobecné a zaznamenajte ID projektu.

2

Získajte súkromný kľúč svojho servisného účtu od Firebase:

  1. Prejdite na kartu Kontá služieb v nastaveniach projektu.

  2. Buď si vytvorte nový účet služby a získajte jeho súkromný kľúč.

  3. Alebo otvorte existujúci servisný účet a vygenerujte pre neho nový súkromný kľúč.

    Poznámka: Konto služby musí mať povolenie firebaseadmin -sdk.

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

3

Skopírujte kľúč na XSP, ktorý hosťuje váš NPS.

4

Pridajte ID projektu a priradený súkromný kľúč do kontextu projektov FCM:

XSP_CLI /Aplikácie/NotificationPushServer/FCM/Projekty> pridať cestu projektového id/do/súboru kľúčov

5

Pridajte aplikáciu UC-One (Connect alebo SaaS) a pridružené ID projektu do kontextu aplikácií FCM:

XSP_CLI/Aplikácie/NotificationPushServer/FCM/Aplik ácie> pridať ID aplikácie com.broadsoft.connect ProjectID projekt-id

6

Skontrolujte konfiguráciu FCM podľa atribútov a odporúčaných hodnôt uvedených tu. Ak je to potrebné, použite nastav enú verziu príkazu na zmenu hodnôt:

Spustite XSP _CLI/Applications/NotificationPushServer/FCM> získať

Parameter

Odporúčaná hodnota

Autorizačná adresa URL

https://www.googleapis.com/oauth2/v4/token

PushUrl

https://fcm.googleapis.com/v1/projects/ ID PROJEKTU /správy:odoslať

rozsah

https://www.googleapis.com/auth/firebase.messaging

TokentimetoliveinSeconds

3600

PripojenieVeľkosť bazénu

10

Čas pripojenieOutInmilisekundy

3000

ConnectionIdleTimeOutInSeconds

600

Migrácia aplikácií BroadWorks UC-One Connect/SaaS pre Android do FCMv1 (na ADP)

  • Táto úloha sa vzťahuje na NPS na ADP. Ignorujte ho, ak je váš NPS na XSP.

  • Tento postup môžete použiť na migráciu upozornení na FCMv1 pre aplikácie UC-One Connect alebo UC-One SaaS pre Android.

  • Ak chcete použiť proxy NPS na overenie push upozornení v aplikáciách UC-One alebo Webex pre Android, musíte použiť FCMv1.

  • Táto úloha pripraví NPS pre FCMv1, aby ste ho mohli povoliť ako súčasť konfigurácie autentifikačného proxy NPS. Nepoužívajte FCMv1, kým nie ste pripravení nakonfigurovať servera proxy autentifikácie NPS, inak upozornenia klientom SaaS zlyhajú.

1

Získajte ID projektu z konzoly Firebase:

  1. Prihláste sa na console.firebase.google.com.

  2. Vyberte projekt aplikácie UC-One (Connect alebo SaaS) a otvorte jeho nastavenia projektu.

  3. Otvorte kartu V šeobecné a zaznamenajte ID projektu.

2

Získajte súkromný kľúč svojho servisného účtu od Firebase:

  1. Prejdite na kartu Kontá služieb v nastaveniach projektu.

  2. Buď si vytvorte nový účet služby a získajte jeho súkromný kľúč.

  3. Alebo otvorte existujúci servisný účet a vygenerujte pre neho nový súkromný kľúč.

    Poznámka: Konto služby musí mať povolenie firebaseadmin -sdk.

  4. Stiahnite si kľúč (súbor.json) na zabezpečené miesto.

3

Importujte súbor.json na server ADP /bw/install.

4

Prihláste sa do ADP CLI a pridajte kľúč projektu a API do kontextu projektov FCM:

ADP_CLI/Aplikácie/NotificationPushServer/FCM/Projekty> pridať connect-ucaas /bw/install/ názov súboru.json

5

Pridajte ID aplikácie a projektu do kontextu aplikácií FCM:

ADP_CLI/Aplikácie/NotificationPushServer/FCM/Aplik ácie> pridať ID aplikácie com.broadsoft.ucaas.connect ProjectID projekt-id

6

Overte svoju konfiguráciu:

ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get
Project ID Accountkey
========================
connect-ucaas ********
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get
Application ID Project ID
===================================
com.broadsoft.ucaas.connect connect-ucaas

Opätovne povoľte režim FCM Legacy

Musíte to urobiť iba (ako súčasť migrácie), ak:

  • Váš NPS sa používa pre aplikácie UC-One SaaS alebo BroadWorks Connect pre Android.

  • Už ste testovali, že upozornenia na hovory push do iných aplikácií fungujú s rozhraním API FCmv1.

FCMv1 dočasne deaktivujete, pretože kľúče FCMv1 pre tieto aplikácie musia byť povolené iba počas procesu konfigurácie proxy autentifikácie NPS.

1

Prihláste sa do XSP, ktorý hosťuje vaše zdieľané NPS.

2

Prejdite do kontextu FCM a vypnite FCM v1: XSP_CLI/Applications/NotificationPushServer/ FCM> set V1enabled false, aby ste sa vrátili k použitiu staršieho kľúča API FCM.

Nakonfigurujte NPS tak, aby používal autentifikačný proxy

1

Vytvorte žiadosť o službu so svojím vstupným kontaktom alebo pomocou TAC, aby ste zabezpečili svoj klientsky účet (Webex Common Identity) OAuth. Názov svojej žiadosti o služ bu NPS Configuration for Auth Proxy Setup.

Poskytneme vám ID klienta OAuth, tajomstvo klienta a obnovovací token, ktorý je platný 60 dní. Ak platnosť tokenu vyprší skôr, ako ho použijete so svojím NPS, môžete podať ďalšiu žiadosť.
2

Vytvorte si klientský účet na NPS:

XSP_CLI/Aplikácie/NotificationPushServer/Ciscoci/Client> nastaviť ID klienta od-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Spustite príkaz a overte, či sa zadané hodnoty zhodujú s hodnotami, ktoré ste vám boli poskytnuté. XSP_CLI/Aplikácie/NotificationPushServer/Ciscoci/Client> získať

3

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

FqDNS založené na regióne:

Východ USA:

XSP_CLI /Aplikácie/NotificationPushServer/CloudnpsService> nastaviť adresu URL https://broadworks-idp-proxy-a.wbx2.com/nps/

Západ USA:

XSP_CLI /Aplikácie/NotificationPushServer/CloudnpsService> nastaviť adresu URL https://broadworks-idp-proxy-r.wbx2.com/nps/

Európa:

XSP_CLI /Aplikácie/NotificationPushServer/CloudnpsService> nastaviť adresu URL https://broadworks-idp-proxy-k.wbx2.com/nps/

XSP_CLI /Aplikácie/NotificationPushServer/CloudnpsService> nastaviť VoipTokenRefreshInterval 1800

Saudská Arábia:

XSP_CLI /Aplikácie/NotificationPushServer/CloudnpsService> nastaviť adresu URL https://broadworks-idp-proxy-d.wbx2.com/nps/

Austrália:

XSP_CLI /Aplikácie/NotificationPushServer/CloudnpsService> nastaviť adresu URL https://broadworks-idp-proxy-m.wbx2.com/nps/

Ak vyprší čas upozornení z dôvodu oneskorenia rozlíšenia DNS, zvýšte hodnotu časového limitu v súbore „/etc/resolv.conf“ na serveri BroadWorks.

4

(Pre upozornenia pre Android) Pridajte ID aplikácií pre Android do kontextu aplikácií FCM na NPS.

Pre aplikáciu Webex pre Android: XSP_CLI/Applications/NotificationPushServer/FCM/Applications> pridať com.cisco.wx2. android

Pre aplikáciu UC-One pre Android: X SP_CLI/Applications/NotificationPushServer/FCM/Applications> pridať com.broadsoft.connect

5

(Pre Apple iOS upozornenia) Pridajte ID aplikácie do kontextu aplikácií APNS a nezabudnite vynechať kľúč Auth — nastavte ho na prázdny.

Pre aplikáciu Webex v systéme iOS: X SP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> pridať com.cisco.squared

Pre aplikáciu UC-One v systéme iOS: X SP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> pridať com.cisco.squared

6

Nakonfigurujte nasledujúce adresy URL NPS:

Kontext XSP CLI

Parameter

Hodnota

XSP_CLI/Aplikácie/NotifikáciePushServer/FCM>

Autorizačná adresa URL

https://www.googleapis.com/oauth2/v4/token

PushUrl

https://fcm.googleapis.com/v1/projects//messages:send

rozsah

https://www.googleapis.com/auth/firebase.messaging

XSP_CLI/Aplikácie/NotificationPushServer/APNS/Produkcia>

URL

https://api.push.apple.com/3/device

7

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

Kontext XSP CLI

Parameter

Hodnota

XSP_CLI/Aplikácie/NotifikáciePushServer/FCM>

TokentimetoliveinSeconds

3600

PripojenieVeľkosť bazénu

10

Čas pripojenieOutInmilisekundy

3000

ConnectionIdleTimeOutInSeconds

600

XSP_CLI/Aplikácie/NotificationPushServer/APNS/Produkcia>

Konekcia pripojenieČasový limit

3000

PripojenieVeľkosť bazénu

2

ConnectionIdleTimeOutInSeconds

600

8

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

  1. Spustite AS_CLI/System/PushNotification> získajte a skontrolujte hodnotu Enforcement AllowedApplicationList. Ak je to prav da, musíte túto čiastkovú úlohu splniť. V opačnom prípade preskočte zvyšok čiastkovej úlohy.

  2. AS_CLI/System/Pushnoti fication/AllowedApplications> pridať com.cisco.wx2.android „Webex Android“

  3. AS_CLI/System/Pushnoti fication/AllowedApplications> pridať com.cisco.square „Webex iOS“

Reštartujte NPS a otestujte upozornenia Push

1

Reštartujte XSP:

bwrestart
2

Otestujte upozornenia na hovory do systému Android uskutočňovaním hovorov od predplatiteľa BroadWorks k volajúcemu klientovi v systéme Android. Skontrolujte, či sa v zariadení so systémom Android zobrazuje upozornenie na hovor.

Poznámka: Ak upozornenia push začnú zlyhať pre aplikáciu UC-One pre Android, je možné, že došlo k nesprávnej konfigurácii. Ak je to vaša situácia, môžete sa vrátiť k starému FCM nasledovne:

  1. Zakázať FCMv1: XSP _CLI/Applications/NotificationPushServer/FCM> nastaviť V1Enabled false

  2. Reštartujte XSP: bwrestart

  3. Skontrolujte svoju konfiguráciu.

  4. Znovu povoľte FCMv1 a reštartujte XSP.

  5. Opakujte test.

3

Otestujte upozornenia na hovory do systému iOS uskutočňovaním hovorov od predplatiteľa BroadWorks k volajúcemu klientovi v systéme iOS. Skontrolujte, či sa v zariadení so systémom iOS zobrazuje upozornenie na hovor.

Poznámka: Ak upozornenia push začnú zlyhať pre aplikáciu UC-One iOS, je možné, že došlo k nesprávnej konfigurácii. Ak je to vaša situácia, môžete sa vrátiť k starému binárnemu rozhraniu so setom HTTP2enabled false

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