Ažuriranje Cisco BroadVorks NPS-a za korišćenje NPS Proki-a: Vodič za konfiguraciju

list-menuPovratne informacije?
Naučite kako da ažurirate Cisco BroadVorks NPS da biste koristili NPS Proki sa ovim vodičem za konfiguraciju . Otkrijte korak-po-korak uputstva, razmatranja i najbolje prakse za besprekornu integraciju i poboljšane performanse mreže.

Ovaj članak opisuje kako konfigurisati zajednički NPS da koristi NPS proki za autentifikaciju, tako da se može koristiti i za slanje obaveštenja o pozivima u Vebek aplikacije. Ako vaš NPS ne podržava druge aplikacije, možete pratiti pojednostavljenu proceduru u Vodiču za rešenja Vebek za BroadVorks.

Pregled NPS Proksi

Za kompatibilnost sa Vebeksom za BroadVorks, vaš NPS mora biti zakrpljen da bi podržao funkciju NPS Proki, Push Server za VoIP u UCaaS-u.

Ova funkcija implementira novi dizajn u Notification Push Server za rešavanje bezbednosne ranjivosti deljenja privatnih ključeva sertifikata push obaveštenja sa pružaocima usluga za mobilne klijente. Umesto deljenja sertifikata i ključeva push obaveštenja sa provajderom usluga, NPS koristi novi API za dobijanje kratkotrajnog tokena za push obaveštenje iz UCaaS pozadine, i koristi ovaj token za autentifikaciju sa Apple APN-ovima i Google FCM uslugama.

Ova funkcija takođe poboljšava mogućnost Notification Push Server-a da pošalje obaveštenja na Android uređaje putem novog Google Firebase Cloud Messaging (FCM) HTTPvKSNUMKS API-ja.

KSSP (ili Application Delivery Platform ADP) koji hostuje NPS mora ispunjavati sledeće uslove:

Minimalne verzije i ograničenja zajedničkog boravka

  • NPS mora biti aktiviran na namenskom KSSP / ADP-u, a NPS mora biti jedina hostovana aplikacija na serveru. Ovo je da se eliminiše smetnje u isporuci Push obaveštenja.

  • Trebalo bi da postoji samo jedna NPS aplikacija u raspoređivanju. Ako koristite mobilni UC-One Collaborate / Connect i ili UC-One SaaS, i implementirate Vebek za BroadVorks, morate podeliti ovaj jedan NPS za sve aplikacije.

  • NPS mora biti na verziji R22 ili novijoj KSSP, ili ADP.

    R22 / R23 KSSP je kompatibilan sa R21 stack ako KSSP radi samo NPS i AS je R21. SP1. Pogledajte Matricu kompatibilnosti BroadVorks za više informacija.

  • Više informacija o ADP serveru možete pronaći na Cisco BroadVorks Application Delivery Platform.

Zajednički NPS

Pročitajte ove napomene pre nego što konfigurišete svoj zajednički NPS da koristite NPS Proki:

  • Ako se vaš NPS koristi sa drugim aplikacijama (ne samo sa aplikacijom Vebek): Prvo konfigurišite NPS proki, a zatim promenite NPS iz korišćenja FCM nasleđenog API-ja na korišćenje FCM HTTP vKSNUMKS API-ja.

  • Nakon što potvrdite da obaveštenja ispravno rade za starije aplikacije sa NPS proki-om, a zatim uklonite FCM API ključ za Android aplikaciju i APN-ov autentifikacijski ključ za iOS aplikaciju.

APNs HTTP/2

  • Ako ste postavili bilo koju iOS aplikaciju koja nije iz Cisco / BroadSoft-a, konfigurišite te aplikacije da koriste HTTP / KSNUMKS APNS protokol pre nego što konfigurišete NPS da koristi NPS proki.

  • KSSP / ADP-ovi koji već podržavaju aplikaciju Collaborate ili SaaS BroadVorks moraju biti prebačeni na HTTP / KSNUMKS. Za detaljne informacije o konfigurisanju HTTP / 2, pogledajte HTTP / 2 Podrška za Notification Push Server za APNS (migracija NPS-a za podršku ovim iOS aplikacijama je sažeta u ovom članku).

Android FCMv1

  • Ako ste postavili bilo koju Android aplikaciju koja nije iz Cisco / BroadSoft-a, konfigurišite te aplikacije da koriste FCMvKSNUMKS ključeve pre nego što konfigurišete NPS da koristi NPS proki.

  • Ako KSSP / ADP trenutno podržava Connect ili UC-One SaaS aplikaciju, onda omogućite FCMvKSNUMKS ključeve nakon što konfigurišete NPS proki. Preporučujemo da migrirate sve dodatne aplikacije na FCMvKSNUMKS ključeve, omogućite i testirate, a zatim onemogućite dok ne budete spremni da završite uputstva za podešavanje (tok migracije je dokumentovan u ovom članku).

Vizuelni rezime migracije na NPS autentifikaciju proki
Tabela 1. Rezime zadataka za migraciju na NPS Proki

Sekvenca

Naslov zadatka

Kada / zašto je zadatak potreban?

1

Migrirajte NPS na HTTP / KSNUMKS za UC-One SaaS (ili Connect) iOS aplikacije.

Ako NPS podržava te aplikacije, a one još nisu konfigurisane za HTTP / 2.

2

Migrirajte NPS na FCMvKSNUMKS za UC-One SaaS (ili Connect) Android aplikacije.

Ako NPS podržava te aplikacije, a one još nisu konfigurisane za FCMv1.

3

Omogućite FCMvKSNUMKS režim i testirajte push obaveštenja.

Ako NPS podržava UC-One Connect i / ili druge (ne-Cisco) Android aplikacije.

4

Ponovo omogućite FCM nasleđe režim.

Ako NPS podržava UC-One SaaS. Ako ostavite FCMvKSNUMKS omogućen, pre nego što konfigurišete NPS proki, onda push obaveštenja na UC-One SaaS počinju da propadaju.

5

Instalirajte NPS autentifikaciju proki zakrpe.

Ako je NPS na KSSP R22 ili KSSP R23.

6

Konfigurišite NPS da koristi NPS proki za autentifikaciju:

  • Priložite tehničku podršku iz NPS-a

  • Zahtev za CI OAuth nalog

  • Kreirajte CI nalog na NPS-u i konfigurišite vremensko ograničenje tokena za osvežavanje

  • Dodajte ID aplikacije za Android

  • Dodajte ID aplikacije za iOS

  • Provera / podešavanje URL-ova i vremenskih ograničenja veze

  • Dodajte aplikacije u AS listu dozvola

  • (Re-)Omogućite FCMv1

  • Ponovo pokrenite KSSP / ADP

  • Testirajte PN-ove za iOS i Android aplikacije

Uvek potreban.

7

Uklonite FCM nasleđe tastera režima.

Za aplikacije koje su uspešno podržane od strane NPS-a na FCMvKSNUMKS.

Ovaj zadatak je obavezan za push obaveštenja na UC-One SaaS i Vebek aplikacije na iOS platformama.

Pre nego što počnete

Ako vaš KSSP koristi R22, potrebno je da primenite ap354313 pre nego što možete da konfigurišete NPS aplikaciju da koristi HTTP / 2 za APNS.

1

Podesite URL proizvodnje i parametre veze na XSP_CLI/Applications/NotificationPushServer/APNS/Production>

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

set connectionPoolSize 2

set connectionTimeout 3000

set connectionIdleTimeoutInSeconds 600

Napomena: Ne postavljajte vremensko ograničenje veze ispod KSNUMKS-a.

2

Dodajte ID-ove aplikacija u kontekst APNS aplikacija, pazeći da izostavite Auth ključ – podesite ga na prazan.

Za UC-One SaaS:XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.broadsoft.uc-one

Za Vebek aplikaciju: XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

3

Proverite ključeve za autentifikaciju pomoću XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> get

4

Ako taster auth nije prazan za com.broadsoft.uc-one, možete ga obrisati sa XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> clear the-authkey

5

Omogućite HTTP / 2:

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

6

Samo za UC-One SaaS aplikacije: Prijavite se na portal prodavca i idite na Konfiguracija > BroadVorks > .

7

Pomerite se nadole do odeljka Obaveštenje Push Server i izaberite svoje izdanje (npr. Izdanje 22), a zatim sledite uputstva koja se nalaze na portalu.

  • Ovaj zadatak se odnosi na NPS na KSSP-u. Ignorišite ga ako je vaš NPS na ADP-u.

  • Ovu proceduru možete koristiti za migraciju na FCMvKSNUMKS obaveštenja za UC-One Connect ili UC-One SaaS Android aplikacije.

  • Morate koristiti FCMvKSNUMKS ako želite da koristite NPS proki za autentifikaciju push obaveštenja na UC-One ili Vebek Android aplikacije.

  • Ovaj zadatak priprema NPS za FCMv1 tako da ga možete omogućiti kao deo konfiguracije NPS autentifikacije proki. Ne omogućavajte FCMvKSNUMKS dok ne budete spremni da konfigurišete NPS proki za autentifikaciju, ili obaveštenja SaaS klijentima neće uspeti.

1

Nabavite ID projekta iz Firebase konzole:

  1. Prijavite se na console.firebase.google.com.

  2. Izaberite projekat aplikacije UC-One (Connect ili SaaS), otvorite podešavanja projekta.

  3. Otvorite karticu Opšte i snimite ID projekta.

2

Nabavite privatni ključ vašeg servisnog računa iz Firebase-a:

  1. Idite na karticu Servisni računi u podešavanjima projekta.

  2. Ili kreirajte novi nalog usluge i dobiti svoj privatni ključ.

  3. Ili otvorite postojeći račun usluge i generišite novi privatni ključ za njega.

    Napomena: Račun usluge mora imati dozvolu firebaseadmin-sdk .

  4. Preuzmite ključ na sigurnu lokaciju.

3

Kopirajte ključ na KSSP hosting vaš NPS.

4

Dodajte ID projekta i pridruženi privatni ključ u kontekst FCM projekata:

XSP_CLI/Applications/NotificationPushServer/FCM/Projects> add project-id path/to/keyfile

5

Dodajte UC-One (Connect ili SaaS) aplikaciju i pridruženi ID projekta u kontekst FCM aplikacija:

XSP_CLI/Applications/NotificationPushServer/FCM/Applications> add applicationId com.broadsoft.connect projectId project-id

6

Proverite konfiguraciju za FCM u odnosu na atribute i preporučene vrednosti prikazane ovde. Koristite set verziju komande da promenite vrednosti ako je potrebno:

Pokreni XSP_CLI/Applications/NotificationPushServer/FCM> get

Parametar

Preporučena vrednost

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

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3000

connectionIdleTimeoutInSeconds

600

  • Ovaj zadatak se odnosi na NPS na ADP-u. Ignorišite ga ako je vaš NPS na KSSP-u.

  • Ovu proceduru možete koristiti za migraciju na FCMvKSNUMKS obaveštenja za UC-One Connect ili UC-One SaaS Android aplikacije.

  • Morate koristiti FCMvKSNUMKS ako želite da koristite NPS proki za autentifikaciju push obaveštenja na UC-One ili Vebek Android aplikacije.

  • Ovaj zadatak priprema NPS za FCMv1 tako da ga možete omogućiti kao deo konfiguracije NPS autentifikacije proki. Ne omogućavajte FCMvKSNUMKS dok ne budete spremni da konfigurišete NPS proki za autentifikaciju, ili obaveštenja SaaS klijentima neće uspeti.

1

Nabavite ID projekta iz Firebase konzole:

  1. Prijavite se na console.firebase.google.com.

  2. Izaberite projekat aplikacije UC-One (Connect ili SaaS), otvorite podešavanja projekta.

  3. Otvorite karticu Opšte i snimite ID projekta.

2

Nabavite privatni ključ vašeg servisnog računa iz Firebase-a:

  1. Idite na karticu Servisni računi u podešavanjima projekta.

  2. Ili kreirajte novi nalog usluge i dobiti svoj privatni ključ.

  3. Ili otvorite postojeći račun usluge i generišite novi privatni ključ za njega.

    Napomena: Račun usluge mora imati dozvolu firebaseadmin-sdk .

  4. Preuzmite ključ (.json datoteku) na sigurnu lokaciju.

3

Uvezite .json datoteku na ADP server /bw/install.

4

Prijavite se na ADP CLI i dodajte projekat i API ključ u kontekst FCM projekata:

ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect-ucaas /bw/install/filename.json

5

Dodajte ID aplikacije i projekta u kontekst FCM aplikacija:

ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add applicationId com.broadsoft.ucaas.connect projectId project-id

6

Proverite svoju konfiguraciju:

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

To treba da uradite (kao deo migracije) samo ako:

  • Vaš NPS se koristi za UC-One SaaS ili BroadVorks Connect Android aplikacije.

  • Već ste testirali da obaveštenja o pozivima drugim aplikacijama rade sa FCMv1 API-jem.

Privremeno onemogućavate FCMv1 jer FCMv1 ključevi za ove aplikacije moraju biti omogućeni samo tokom procesa konfiguracije NPS autentifikacije proki.

1

Prijavite se na KSSP koji hostuje vaš zajednički NPS.

2

Dođite do FCM konteksta i onemogućite FCM vKSNUMKS: XSP_CLI/Applications/NotificationPushServer/FCM> set V1enabled false da se vratite na korišćenje FCM nasleđenog API ključa.

1

Kreirajte zahtev za uslugu sa svojim kontaktom za uključivanje ili sa TAC-om da biste obezbedili svoj (Vebek Common Identiti) OAuth klijentski nalog. Naslovite svoj zahtev za uslugu NPS konfiguracija za podešavanje auth proki-ja.

Dajemo vam OAuth ID klijenta, tajnu klijenta i token za osvežavanje koji važi 60 dana. Ako token istekne pre nego što ga koristite sa svojim NPS-om, možete podići još jedan zahtev.
2

Kreirajte nalog klijenta na NPS-u:

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientId client-Id-From-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

Pokrenite komandu da biste proverili da li vrednosti koje ste uneli odgovaraju onima koje ste dobili. XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

3

Unesite NPS Proki URL adresu i podesite interval osvežavanja tokena (preporučuje se KSNUMKS minuta):

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

Da biste poboljšali brzinu rezolucije DNS-a, umesto trenutnog FKDN nps.uc-one.broadsoft.com preporučujemo vam da koristite odgovarajući FKDN zasnovan na vašem regionu.

FKDN-ovi zasnovani na regionu:

SAD Istok:

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

SAD Zapad:

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

Saudijska Arabija:

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

Ako push obaveštenja isteknu zbog kašnjenja u rezoluciji DNS-a, povećajte vrednost vremenskog ograničenja u datoteci "/etc/resolv.conf" na serveru BroadVorks.

4

(Za Android obaveštenja) Dodajte ID-ove Android aplikacija u kontekst FCM aplikacija na NPS-u.

Za Vebek aplikaciju na Androidu: XSP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.cisco.wx2.android

Za UC-One aplikaciju na Androidu: XSP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.connect

5

(Za Apple iOS obaveštenja) Dodajte ID aplikacije u kontekst APNS aplikacija, pazeći da izostavite Auth ključ – podesite ga na prazan.

Za Vebek aplikaciju na iOS-u: XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

Za UC-One aplikaciju na iOS-u: XSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> add com.cisco.squared

6

Konfigurišite sledeće NPS URL-ove:

KSSP CLI kontekst

Parametar

Vrednost

XSP_CLI/Applications/NotificationPushServer/FCM>

authURL

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

pushURL

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

scope

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

XSP_CLI/Applications/NotificationPushServer/APNS/Production>

url

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

7

Konfigurišite sledeće parametre NPS veze sa prikazanim preporučenim vrednostima:

KSSP CLI kontekst

Parametar

Vrednost

XSP_CLI/Applications/NotificationPushServer/FCM>

tokenTimeToLiveInSeconds

3600

connectionPoolSize

10

connectionTimeoutInMilliseconds

3000

connectionIdleTimeoutInSeconds

600

XSP_CLI/Applications/NotificationPushServer/APNS/Production>

connectionTimeout

3000

connectionPoolSize

2

connectionIdleTimeoutInSeconds

600

8

Proverite da li aplikativni server pregledava ID-ove aplikacija, jer ćete možda morati da dodate Vebek aplikacije na listu dozvoljenih:

  1. Pokrenite AS_CLI/System/PushNotification> get i proverite vrednost enforceAllowedApplicationList. Ako je true, morate da završite ovaj pod-zadatak. U suprotnom, preskočite ostatak podzadatka.

  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”

1

Ponovo pokrenite KSSP:

bwrestart
2

Testirajte obaveštenja o pozivima na Android tako što ćete uputiti pozive od pretplatnika BroadVorks-a na klijenta koji poziva na Androidu. Proverite da li se obaveštenje o pozivu pojavljuje na Android uređaju.

Napomena: Ako push obaveštenja počnu da ne uspevaju za UC-One Android aplikaciju, moguće je da postoji pogrešna konfiguracija. Ako je ovo vaša situacija, možete se vratiti na nasleđeni FCM na sledeći način:

  1. Onemogućavanje FCMv1: XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false

  2. Ponovo pokrenite KSSP: bwrestart

  3. Proverite svoju konfiguraciju.

  4. Ponovo omogućite FCMv1 i ponovo pokrenite KSSP.

  5. Ponovite test.

3

Testirajte obaveštenja o pozivima na iOS tako što ćete uputiti pozive od pretplatnika BroadVorks-a na klijenta koji poziva na iOS-u. Proverite da li se obaveštenje o pozivu pojavljuje na iOS uređaju.

Napomena: Ako push obaveštenja počnu da propadaju za UC-One iOS aplikaciju, moguće je da postoji pogrešna konfiguracija. Ako je ovo vaša situacija, možete se vratiti na nasleđeni binarni interfejs sa set HTTP2Enabled false

Da li je ovaj članak bio koristan?
Da li je ovaj članak bio koristan?