V tomto článku
Přehled protokolu NPS Authentication Proxy
dropdown icon
Požadavky NPS Authentication Proxy
    Minimální verze a omezení společného pobytu
    Sdílené NPS
    APN HTTP/2
    Android FCMv1
Souhrn migrace proxy serveru NPS
Migrace aplikací BroadWorks Collaborate pro iOS na HTTP/2
Migrace aplikací BroadWorks UC-One Connect/SaaS pro Android na FCMv1
Migrace aplikací BroadWorks UC-One Connect/SaaS pro Android na FCMv1 (na ADP)
Znovu povolte režim FCM Legacy
dropdown icon
Instalace oprav proxy ověřování NPS
    R22 nášivky
    R23 nášivky
Konfigurace služby NPS tak, aby používala ověřovací proxy
Restartujte systém NPS a otestujte oznámení push
Aktualizujte Cisco BroadWorks NPS tak, aby používal NPS Proxy: Průvodce konfigurací
list-menuV tomto článku
list-menuZpětná vazba?

V této konfigurační příručce se dozvíte, jak aktualizovat Cisco BroadWorks NPS tak, aby využíval NPS Proxy. Objevte podrobné pokyny, úvahy a osvědčené postupy pro bezproblémovou integraci a vylepšený výkon sítě.

Přehled protokolu NPS Authentication Proxy

Tento článek popisuje, jak nakonfigurovat sdílený server NPS tak, aby používal ověřovací proxy server NPS, aby jej bylo možné použít také k odesílání oznámení o volání do aplikací Webex. Pokud NPS nepodporuje jiné aplikace, postupujte podle zjednodušeného postupu v Průvodci řešením Webex pro BroadWorks.

Přehled NPS Proxy

Pro kompatibilitu s Webex pro BroadWorks musí být váš server NPS opraven, aby podporoval funkci NPS Proxy, P ush Server for VoIP v UCaaS.

Tato funkce implementuje nový design v serveru Notification Push Server, který vyřeší bezpečnostní chybu sdílení soukromých klíčů certifikátů oznámení push s poskytovateli služeb pro mobilní klienty. Namísto sdílení certifikátů a klíčů oznámení push s poskytovatelem služeb používá NPS nové rozhraní API k získání tokenu oznámení push s krátkou životností z backendu UCaaS a používá tento token pro ověřování pomocí Apple APN a služeb Google FCM.

Tato funkce také zvyšuje schopnost Notification Push serveru odesílat oznámení na zařízení Android prostřednictvím nového rozhraní API HTTPv1 Google Firebase Cloud Messaging (FCM).

Požadavky NPS Authentication Proxy

XSP (nebo Application Delivery Platform ADP), který hostuje NPS, musí splňovat následující požadavky:

Minimální verze a omezení společného pobytu

  • NPS musí být aktivován na vyhrazeném XSP/ADP a NPS musí být jedinou hostovanou aplikací na serveru. Tím se eliminuje rušení doručování oznámení push.

  • V nasazení by měla být pouze jedna aplikace NPS. Pokud používáte mobilní UC-One Collaborate/Connect nebo UC-One SaaS a implementujete Webex pro BroadWorks, musíte tento jediný NPS sdílet pro všechny aplikace.

  • NPS musí být ve verzi R22 nebo novější XSP nebo ADP.

    R22/R23 XSP je kompatibilní se zásobníkem R21, pokud XSP běží pouze NPS a AS je R21.SP1. Další informace naleznete v matici kompatibility BroadWorks.

  • Více informací o serveru ADP naleznete na platformě Cisco BroadWorks Application Deli very Platform.

Sdílené NPS

Než nakonfigurujete sdílený server NPS tak, aby používal proxy server NPS, přečtěte si tyto poznámky:

  • Pokud se NPS používá s jinými aplikacemi (nejen s aplikací Webex): Nejprve nakonfigur ujte proxy server NPS a poté změňte NPS z používání starších rozhraní API FCM na rozhraní API protokolu FCM HTTP v1.

  • Poté, co ověříte, že oznámení fungují správně pro starší aplikace s proxy serverem NPS, odeberte klíč rozhraní API FCM pro aplikaci Android a klíč autentizace APN pro aplikaci iOS.

APN HTTP/2

  • Pokud jste nasadili aplikace pro iOS, které nepocházejí z Cisco/BroadSoft, nakonfigurujte tyto aplikace tak, aby používaly protokol HTTP/2 APNS před konfigurací serveru NPS pro použití serveru NPS proxy.

  • XSP/ADP, které již podporují aplikaci Collaborate nebo SaaS BroadWorks, je třeba migrovat na HTTP/2. Podrobné informace o konfiguraci protokolu HTTP/2 naleznete v tématu Podpora protokol u HTTP/2 pro oznamovací Push Server pro APNS (migrace NPS na podporu těchto aplikací pro iOS je shrnuta v tomto článku).

Android FCMv1

  • Pokud jste nasadili aplikace pro Android, které nepocházejí z Cisco/BroadSoft, nakonfigurujte tyto aplikace tak, aby používaly klíče FCMv1 před konfigurací serveru NPS pro používání proxy serveru NPS.

  • Pokud XSP/ADP aktuálně podporuje aplikaci Connect nebo UC-One SaaS, povolte klíče FCMv1 po konfiguraci proxy serveru NPS. Doporučujeme migrovat všechny další aplikace na klíče FCMv1, povolit a otestovat a poté deaktivovat, dokud nebudete připraveni dokončit pokyny k instalaci (postup migrace je popsán v tomto článku).

Souhrn migrace proxy serveru NPS

Vizuální shrnutí migrace na NPS Authentication Proxy
Tabulka 1. Souhrn úkolů k migraci na proxy server NPS

Sekvence

Název úkolu

Kdy a proč je úkol vyžadován?

1

Migrujte protokol NPS na HTTP/2 pro aplikace UC-One SaaS (nebo Connect) pro iOS.

Pokud NPS tyto aplikace podporuje a ještě nejsou nakonfigurovány pro HTTP/2.

2

Migrujte NPS na FCMv1 pro aplikace UC-One SaaS (nebo Connect) pro Android.

Pokud NPS tyto aplikace podporuje a ještě nejsou nakonfigurovány pro FCMv1.

3

Povolte režim FCMv1 a otestujte oznámení push.

Pokud NPS podporuje UC-One Connect a/nebo jiné aplikace pro Android (jiné než Cisco).

4

Znovu povolte starší režim FCM.

Pokud NPS podporuje UC-One SaaS. Pokud necháte funkci FCMv1 zapnutou, než nakonfigurujete proxy server NPS, začnou selhat odesílání oznámení do UC-One SaaS.

5

Nainstalujte opravy proxy ověřování NPS.

Pokud je NPS na XSP R22 nebo XSP R23.

6

Nakonfigurujte službu NPS tak, aby používala ověřovací proxy server NPS:

  • Připojte technickou podporu z NPS

  • Vyžádejte si CI OAuth účet

  • Vytvořte účet CI na NPS a nakonfigurujte časový limit obnovovacího tokenu

  • Přidání ID aplikací pro Android

  • Přidání ID aplikací pro iOS

  • Kontrola/nastavení adres URL a časových limitů připojení

  • Přidání aplikací do seznamu povolených AS

  • (Znovu) Povolit FCMv1

  • Restartujte XSP/ADP

  • Testování PN pro aplikace pro iOS a Android

Vždy vyžadováno.

7

Odstraňte klávesy starších režimů FCM.

Pro aplikace, které jsou úspěšně podporovány NPS na FCMv1.

Migrace aplikací BroadWorks Collaborate pro iOS na HTTP/2

Tento úkol je povinný pro oznámení push do aplikací UC-One SaaS a Webex na platformách iOS.

Než začnete

Pokud je v XSP spuštěna verze R22, musíte před konfigurací aplikace NPS použít protokol AP354313 tak, aby používala protokol HTTP/2 pro APNS.

1

Nastavte produkční URL a parametry připojení na X SP_CLI/Applications/NotificationPushServer/APNS/Production>

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

sada připojeníPoolsize 2

nastavte připojeníTimeout 3000

nastavit připojeníIdleTimeoutInSeconds 600

Poznámka: Nenastavujte časový limit připojení pod 1000.

2

Přidejte ID aplikace do kontextu aplikací APNS a ujistěte se, že vynecháte klíč Auth - nastavte jej na prázdný.

Pro UC-One SaaS: X SP_CLI/Aplikace/NotificationPushServer/APNS/Production/Tokeny> přidat com.broadsoft.uc-one

Pro aplikaci Webex: XSP _CLI/Applications/NotificationPushServer/APNS/Production/Tokens> přidat com.cisco.squared

3

Zkontrolujte autentizační klíče pomocí xsp_cli/Applications/NotificationPushServer/APNS/Production/Tokens> get

4

Pokud klíč autentizace není prázdný pro com.broadsoft.uc-one, můžete jej vymazat pomocí xsp_cli/Applications/NotificationPushServer/APNS/Production/Tokens> vymazat authkey

5

Povolit HTTP/2:

xsp_CLI /Aplikace/NotificationPushServer/APNS/GeneralSettings> nastavit HTTP2Enabled true

6

Pouze pro aplikace SaaS UC-One: Přihlaste se na portál prodejce a přejděte na Konfigurace > BroadWorks >.

7

Přejděte dolů do sekce Notification Push Server a vyberte verzi (např. Release 22) a postupujte podle pokynů uvedených na portálu.

Migrace aplikací BroadWorks UC-One Connect/SaaS pro Android na FCMv1

  • Tato úloha platí pro NPS na XSP. Ignorujte to, pokud je váš NPS na ADP.

  • Tento postup můžete použít pro migraci na oznámení FCMv1 pro aplikace UC-One Connect nebo UC-One SaaS pro Android.

  • Pokud chcete použít proxy server NPS k ověřování oznámení push pro aplikace UC-One nebo Webex pro Android, musíte použít FCMv1.

  • Tato úloha připraví NPS pro FCMv1, abyste jej mohli povolit jako součást konfigurace proxy ověřování NPS. Nepovolujte protokol FCMv1, dokud nebudete připraveni nakonfigurovat ověřovací proxy serveru NPS, jinak se oznámení klientům SaaS nezdaří.

1

Získejte ID projektu z konzoly Firebase:

  1. Přihlaste se na console.firebase.google.com.

  2. Vyberte projekt aplikace UC-One (Connect nebo SaaS) a otevřete jeho nastavení projektu.

  3. Otevřete kartu Obec né a zaznamenejte ID projektu.

2

Získejte soukromý klíč svého servisního účtu z Firebase:

  1. Přejděte na kartu Účty služeb v nastavení projektu.

  2. Buď si vytvořte nový účet služby a získejte jeho soukromý klíč.

  3. Nebo otevřete existující účet služby a vygenerujte pro něj nový soukromý klíč.

    Poznámka: Ú čet služby musí mít oprávnění firebasead min-sdk.

  4. Stáhněte si klíč na bezpečné místo.

3

Zkopírujte klíč do XSP hostujícího NPS.

4

Přidejte ID projektu a přidružený soukromý klíč do kontextu projektů FCM:

xsp_CLI /Applications/NotificationPushServer/FCM/Projects> přidat cestu ID projektu/do/klíčového souboru

5

Přidejte aplikaci UC-One (Connect nebo SaaS) a přidružené ID projektu do kontextu aplikací FCM:

xsp_CLI/Aplikace/NotificationPushServer/FCM/Aplik ace> přidat ID aplikace com.broadsoft.connect ProjectID projektuID projektu-id

6

Zkontrolujte konfiguraci pro FCM podle atributů a doporučených hodnot uvedených zde. Pokud je to nutné, použijte nastavenou verzi příkazu ke změně hodnot:

Spusťte xsp _CLI/Applications/NotificationPushServer/FCM> get

Parametr

Doporučená hodnota

Autorská adresa URL

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

PushUrl

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

Rozsah

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

TokenTimeLive v sekundách

3600

PřipojeníVelikost bazénu

10

Timeout připojenív milisekundách

3000

PřipojeníIdleTimeOutInSeconds

600

Migrace aplikací BroadWorks UC-One Connect/SaaS pro Android na FCMv1 (na ADP)

  • Tato úloha se vztahuje na NPS na ADP. Ignorujte to, pokud je váš NPS na XSP.

  • Tento postup můžete použít pro migraci na oznámení FCMv1 pro aplikace UC-One Connect nebo UC-One SaaS pro Android.

  • Pokud chcete použít proxy server NPS k ověřování oznámení push pro aplikace UC-One nebo Webex pro Android, musíte použít FCMv1.

  • Tato úloha připraví NPS pro FCMv1, abyste jej mohli povolit jako součást konfigurace proxy ověřování NPS. Nepovolujte protokol FCMv1, dokud nebudete připraveni nakonfigurovat ověřovací proxy serveru NPS, jinak se oznámení klientům SaaS nezdaří.

1

Získejte ID projektu z konzoly Firebase:

  1. Přihlaste se na console.firebase.google.com.

  2. Vyberte projekt aplikace UC-One (Connect nebo SaaS) a otevřete jeho nastavení projektu.

  3. Otevřete kartu Obec né a zaznamenejte ID projektu.

2

Získejte soukromý klíč svého servisního účtu z Firebase:

  1. Přejděte na kartu Účty služeb v nastavení projektu.

  2. Buď si vytvořte nový účet služby a získejte jeho soukromý klíč.

  3. Nebo otevřete existující účet služby a vygenerujte pro něj nový soukromý klíč.

    Poznámka: Ú čet služby musí mít oprávnění firebasead min-sdk.

  4. Stáhněte klíč (soubor.json) do zabezpečeného umístění.

3

Importujte soubor.json na ADP server /bw/install.

4

Přihlaste se do ADP CLI a přidejte projekt a klíč API do kontextu projektů FCM:

adp_cli/Aplikace/NotificationPushServer/FCM/Projects> přidat connect-ucaas /bw/install/název.json

5

Přidejte ID aplikace a projektu do kontextu aplikací FCM:

adp_cli/Aplikace/NotificationPushServer/FCM/Aplik ace> přidat ID aplikace com.broadsoft.ucaas.connect ProjectID projektuID projektu-id

6

Ověřte konfiguraci:

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

Znovu povolte režim FCM Legacy

Musíte to provést pouze (jako součást migrace), pokud:

  • Váš NPS se používá pro aplikace UC-One SaaS nebo BroadWorks Connect pro Android.

  • Už jste testovali, že oznámení push volání do jiných aplikací pracují s FCMv1 API.

FCMv1 dočasně zakážete, protože klíče FCMv1 pro tyto aplikace musí být povoleny pouze během procesu konfigurace proxy ověřování NPS.

1

Přihlaste se k XSP, který hostuje váš sdílený NPS.

2

Přejděte do kontextu FCM a deaktivujte FCM v1: xsp_CLI/Applications/NotificationPushServer/fcm> set V1Enabled false, abyste se vrátili k používání staršího klíče rozhraní API FCM.

Konfigurace služby NPS tak, aby používala ověřovací proxy

1

Vytvořte požadavek na službu se svým kontaktem pro přihlášení nebo pomocí TAC, abyste mohli zřídit svůj klientský účet OAuth (Webex Common Identity). Název požadavku na službu Konfigurace NPS pro nastavení proxy serveru Auth.

Dáme vám ID klienta OAuth, klientské tajemství a obnovovací token, který je platný po dobu 60 dnů. Pokud platnost tokenu vyprší dříve, než jej použijete se svým NPS, můžete vznést další požadavek.
2

Vytvořte klientský účet na NPS:

xsp_CLI/Aplikace/NotificationPushServer/Ciscoci/Client> nastavit ID klienta ClientID zkrom1

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

Spusťte příkaz a ověřte, zda zadané hodnoty odpovídají hodnotám, které vám byly poskytnuty. xsp_CLI/Aplikace/NotificationPushServer/Ciscoci/Client> get

3

Zadejte adresu NPS Proxy URL a nastavte interval obnovení tokenu (doporučeno 30 minut):

Regionální FQDNS:

Východ USA:

xsp_CLI /Aplikace/NotificationPushServer/CloudNPSService> nastavit url https://broadworks-idp-proxy-a.wbx2.com/nps/

Západ USA:

xsp_CLI /Aplikace/NotificationPushServer/CloudNPSService> nastavit url https://broadworks-idp-proxy-r.wbx2.com/nps/

Evropa:

xsp_CLI /Aplikace/NotificationPushServer/CloudNPSService> nastavit url https://broadworks-idp-proxy-k.wbx2.com/nps/

xsp_CLI /Aplikace/NotificationPushServer/CloudNPSService> nastavit VoipTokenRefreshInterval 1800

Saúdská Arábie:

xsp_CLI /Aplikace/NotificationPushServer/CloudNPSService> nastavit url https://broadworks-idp-proxy-d.wbx2.com/nps/

Austrálie:

xsp_CLI /Aplikace/NotificationPushServer/CloudNPSService> nastavit url https://broadworks-idp-proxy-m.wbx2.com/nps/

Pokud vyprší časový limit oznámení push kvůli zpoždění v rozlišení DNS, zvyšte hodnotu časového limitu v souboru „/etc/resolv.conf“ na serveru BroadWorks.

4

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

Pro aplikaci Webex v systému Android: XSP _CLI/Aplikace/NotificationPushServer/FCM/Aplikace> přidat com.cisco.wx2.android

Pro aplikaci UC-One pro Android: X SP_CLI/Aplikace/NotificationPushServer/FCM/Aplikace> přidat com.broadsoft.connect

5

(Pro Apple iOS oznámení) Přidejte ID aplikace do kontextu aplikací APNS a ujistěte se, že vynecháte klíč Auth - nastavte jej na prázdný.

Pro aplikaci Webex v systému iOS: xsp _CLI/Applications/NotificationPushServer/APNS/Production/Tokens> přidat com.cisco.squared

Pro aplikaci UC-One pro iOS: x sp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> přidat com.cisco.squared

6

Nakonfigurujte následující adresy URL NPS:

Kontext rozhraní příkazového řádku XSP

Parametr

Hodnota

xsp_CLI/Aplikace/NotificationPushServer/FCM>

Autorská 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/Aplikace/NotificationPushServer/APNS/Produkce>

adresa URL

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

7

Nakonfigurujte následující parametry připojení NPS na zobrazené doporučené hodnoty:

Kontext rozhraní příkazového řádku XSP

Parametr

Hodnota

xsp_CLI/Aplikace/NotificationPushServer/FCM>

TokenTimeLive v sekundách

3600

PřipojeníVelikost bazénu

10

Timeout připojenív milisekundách

3000

PřipojeníIdleTimeOutInSeconds

600

xsp_CLI/Aplikace/NotificationPushServer/APNS/Produkce>

PřipojeníTimeout

3000

PřipojeníVelikost bazénu

2

PřipojeníIdleTimeOutInSeconds

600

8

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

  1. Spusťte as_CLI/System/PushNotification> get a zkontrolujte hodnotu EnforceAllowedApplicationList. Pokud je to pravda, musíte dokončit tento dílčí úkol. V opačném případě přeskočte zbytek dílčího úkolu.

  2. as_cli/system/push notification/AllowedApplications> přidat com.cisco.wx2.android „Webex Android“

  3. as_cli/system/push notification/AllowedApplications> přidat com.cisco.squared „Webex iOS“

Restartujte systém NPS a otestujte oznámení push

1

Restartujte XSP:

restartovat
2

Otestujte oznámení o hovoru do systému Android uskutečněním hovorů od předplatitele BroadWorks na volajícího klienta v systému Android. Ověřte, zda se na zařízení Android zobrazuje oznámení o hovoru.

Poznámka: Pokud push oznámení začnou selhat pro aplikaci UC-One pro Android, je možné, že došlo k nesprávné konfiguraci. Pokud je to vaše situace, můžete se vrátit ke starému modulu FCM následujícím způsobem:

  1. Zakázat FCMv1: XSP _CLI/Aplikace/NotificationPushServer/FCM> nastavit V1Enabled false

  2. Restartujte XSP: bwrestart

  3. Zkontrolujte konfiguraci.

  4. Znovu povolte FCMv1 a restartujte XSP.

  5. Opakujte test.

3

Otestujte oznámení o hovorech do iOS uskutečněním hovorů od předplatitele BroadWorks na volajícího klienta v systému iOS. Ověřte, zda se na zařízení iOS zobrazuje oznámení o hovoru.

Poznámka: Pokud push oznámení začnou selhat pro aplikaci UC-One iOS, je možné, že došlo k nesprávné konfiguraci. Pokud je to vaše situace, můžete se vrátit ke staršímu binárnímu rozhraní se sadou http2Enabled false

Byl tento článek užitečný?
Byl tento článek užitečný?