Ažurirajte Cisco BroadVorks NPS da biste koristili NPS proki: Vodič za konfiguraciju

Pregled NPS proksija za autentifikaciju

Ovaj članak opisuje kako da konfigurišete deljeni NPS da koristi NPS proksi 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 da sledite pojednostavljeni postupak u Vodiču za rešenje Vebek za BroadVorks.

Pregled NPS proksija

Za kompatibilnost sa Vebek za BroadVorks, vaš NPS mora biti zakrpljen kako bi podržao funkciju NPS Proksi, P ush Server za VoIP u UCAA-ima.

Ova funkcija implementira novi dizajn u Notification Push serveru za rešavanje bezbednosne ranjivosti deljenja privatnih ključeva sertifikata push obaveštenja sa dobavljačima usluga za mobilne klijente. Umesto da deli sertifikate i ključeve push obaveštenja sa dobavljačem usluga, NPS koristi novi API za dobijanje kratkotrajnog tokena push obaveštenja iz pozadine UCAAS i koristi ovaj token za autentifikaciju sa Apple APN-ovima i Google FCM uslugama.

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

Za više informacija pogledajte Opis funkcije P ush Server za VoIP u UCaaS- u.
BroadVorks zakrpe za ovu funkciju dostupne su na: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
Više informacija o ADP serveru možete pronaći na platformi za ispor uku aplikacija Cisco BroadVorks.

Preduslovi za proksija za autentifikaciju NPS

KSSP (ili platforma za isporuku aplikacija ADP) koja ugošćuje NPS mora da ispunjava sledeće zahteve:

Minimalne verzije i ograničenja zajedničkog boravka

NPS mora biti aktiviran na namenskom KSSP/ADP, a NPS mora biti jedina hostovana aplikacija na serveru. Ovo je da bi se eliminisale smetnje u isporuci Push obaveštenja.
U primeni bi trebalo da postoji samo jedna NPS aplikacija. Ako koristite mobilne UC-One Collaborate/Connect i/ili UC-One SaaS i implementirate Vebek za BroadVorks, morate da delite ovaj jedinstveni NPS za sve aplikacije.
NPS mora biti na verziji R22 ili novijoj KSSP ili ADP.

R22/R23 KSSP je kompatibilan sa R21 steckom ako KSSP pokreće samo NPS, a AS je R21.SP1. Pogledajte Matricu kompatibilnosti BroadVorks za više informacija.
Više informacija o ADP serveru možete pronaći na platformi za ispor uku aplikacija Cisco BroadVorks.

Deljeni NPS

Pročitajte ove beleške pre nego što konfigurišete deljeni NPS da koristi NPS proksi:

Ako se vaš NPS koristi sa drugim aplikacijama (ne samo aplikacijom Vebek): Prvo konfiguri šite NPS proksi, a zatim promenite NPS sa korišćenja FCM nasleđenog API-ja na korišćenje FCM HTTP v1 API-ja.
Nakon što potvrdite da obaveštenja ispravno rade za starije aplikacije sa NPS proksijem, uklonite FCM API ključ za Android aplikaciju i taster za autentifikaciju APN-a za iOS aplikaciju.

APN-ovi HTTP/2

Ako ste postavili bilo koju iOS aplikaciju koja nije iz programa Cisco/BroadSoft, konfigurišite te aplikacije da koriste HTTP/2 APNS protokol pre nego što konfigurišete NPS da koristi NPS proksi.
KSSP/ADP-ovi koji već podržavaju aplikaciju Collaborate ili SaaS BroadVorks potrebno je migrirati na HTTP/2. Za detaljne informacije o konfigurisanju HTTP/2 pogledajte HTT P/2 Podrška za Notification Push Server za APNS (migracija NPS-a za podršku ovih iOS aplikacija sažeta je u ovom članku).

Android FCMv1

Ako ste postavili bilo koju Android aplikaciju koja nije iz CISCO/BroadSoft, konfigurišite te aplikacije da koriste FCMv1 tastere pre nego što konfigurišete NPS da koristi NPS proksi.
Ako KSSP/ADP trenutno podržava aplikaciju Connect ili UC-One SaaS, omogućite FCMv1 ključeve nakon što konfigurišete NPS proki. Preporučujemo da sve dodatne aplikacije migrirate na tastere FCMv1, omogućite i testirate, a zatim onemogućite dok ne budete spremni da ispunite uputstva za podešavanje (tok migracije je dokumentovan u ovom članku).

Rezime migracije NPS proksija

***Vizuelni sažetak migracije na NPS proksi za autentifikaciju***

Tabela 1. Rezime zadataka za migraciju na NPS proki
Sekvenca	Naslov zadatka	Kada i zašto je zadatak potreban?
1	Migrirajte NPS na HTTP/2 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 FCMv1 za UC-One SaaS (ili Connect) Android aplikacije.	Ako NPS podržava te aplikacije, a one još nisu konfigurisane za FCMv1.
3	Omogućite režim FCMv1 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đeni režim.	Ako NPS podržava UC-One SaaS. Ako ostavite omogućenim FCMv1, pre nego što konfigurišete NPS proki, push obaveštenja na UC-One SaaS počinju da ne uspevaju.
5	Instalirajte proki zakrpe za autentifikaciju NPS.	Ako je NPS na KSP R22 ili KSP R23.
6	Konfigurišite NPS da koristi NPS proksi za autentifikaciju: Priložite tehničku podršku iz NPS-a Zatražite 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 Proverite/podesite URL adrese i vremenska ograničenja veze Dodavanje aplikacija na AS listu dozvola (Ponovo) Omogući FCMv1 Ponovo pokrenite KSP/ADP Testirajte PN-ove za iOS i Android aplikacije	Uvek obavezno.
7	Uklonite FCM tastere za nasleđe režima.	Za aplikacije koje NPS uspešno podržava na FCMv1.

Migrirajte BroadVorks Collaborate iOS aplikacije na HTTP/2

Ovaj zadatak je obavezan za push obaveštenja UC-One SaaS i Vebek aplikacijama 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 `KS` SP_CLI/Applications/NotificationPushServer/APNS/Production> `set url https://api.push.apple.com/3/device` `podesite vezuPoolSize 2` `podesite konekcijuTimeout 3000` `podesite konekcijuIdleTimeOutInSeconds 600` Napomena: Ne postavljajte vremensko ograničenje veze ispod 1000.
2	Dodajte ID-ove aplikacija u kontekst APNS aplikacija, pazeći da izostavite taster Auth - podesite ga na prazan. Za UC-One SaaS: `KS` SP_CLI/Aplikacije/ObaveštenjaPushServer/APNS/Proizvodnja/Tokeni> dodajte com.broadsoft.uc-one Za aplikaciju Vebek: `KSSP_CLI/Aplikacije/NotificationPushServer/APNS/Proizvodnja/Tokeni> dodajte com.cisco.skuared`
3	`Proverite tastere za autorizaciju pomoću KSSP_CLI/Applications/NotificationPushServer/APNS/Production/Token s> dobiti`
4	`Ako taster za autorizaciju nije prazan za com.broadsoft.uc-one, možete ga obrisati pomoću KSSP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> obrišite autentifikacioni ključ`
5	Omogući HTTP/2: `KSSP_CLI` `/Aplikacije/NotificationPushServer/APNS/Opšta podešavanja> podesite HTTP2omogućeno tačno`
6	Samo za UC-One SaaS aplikacije: Prijavite se na portal preprodavača i idite na Konfiguracija> BroadVorks >.
7	Pomerite se nadole do odeljka Notification Push Server i izaberite svoje izdanje (npr. Izdanje 22), a zatim sledite uputstva data na portalu.

Migrirajte BroadVorks UC-One Connect/SaaS Android aplikacije na FCMv1

Ovaj zadatak se odnosi na NPS na KSSP. Zanemarite ga ako je vaš NPS na ADP-u.
Ovu proceduru možete koristiti za migraciju na FCMv1 obaveštenja za UC-One Connect ili UC-One SaaS Android aplikacije.
Morate da koristite FCMv1 ako želite da koristite NPS proksi za autentifikaciju push obaveštenja u UC-One ili Vebek Android aplikacijama.
Ovaj zadatak priprema NPS za FCMv1 tako da ga možete omogućiti kao deo konfiguracije NPS proksija za autentifikaciju. Ne omogućavajte FCMv1 dok ne budete spremni da konfigurišete NPS proki za autentifikaciju ili obaveštenja SaaS klijentima neće uspeti.

Preuzmite ID projekta sa Firebase konzole:

Prijavite se na console.firebase.google.com.
Izaberite projekat aplikacije UC-One (Connect ili SaaS), otvorite postavke projekta.
Otvorite karticu Op šte i zabeležite ID projekta.

Preuzmite privatni ključ svog servisnog naloga od Firebase-a:

Idite na karticu Servisni nalozi u podešavanjima projekta.
Ili napravite novi nalog usluge i nabavite njegov privatni ključ.
Ili otvorite postojeći servisni račun i generišite novi privatni ključ za njega.

Napomena: Ser visni nalog mora imati dozvolu firebaseadmin -sdk.
Preuzmite ključ na sigurnu lokaciju.

Kopirajte ključ KSSP koji hostuje vaš NPS.

Dodajte ID projekta i povezani privatni ključ u kontekst FCM projekata:

KSSP_CLI /Aplikacije/ObaveštenjaPushServer/FCM/Projekti> dodajte putanju projekta-id/do/fajl ključeva

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

KSSP_CLI/Aplikacije/ObaveštenjaPushServer/FCM/Aplikacije> dodajte Applic ationID com.broadsoft.connect ProjectID projekt-id

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

Pokrenite KSSP_CLI/Applications/NotificationPushServer/FCM> dobiti

Parametar	Preporučena vrednost
`AuthURL`	`https://www.googleapis.com/oauth2/v4/token`
`PushUrl`	`https://fcm.googleapis.com/v1/projects/ ID PROJEKTA /poruke:pošalji`
`obim`	`https://www.googleapis.com/auth/firebase.messaging`
`TokentimeToLiveInSeconds`	3600
`VezaVeličina bazena`	10
`Vreme povezivanjaOtinMilisekundi`	3000
`VezaIdleTimeOutInSeconds`	600

Migrirajte BroadVorks UC-One Connect/SaaS Android aplikacije na FCMv1 (na ADP-u)

Ovaj zadatak se odnosi na NPS na ADP-u. Zanemarite ga ako je vaš NPS na KSSP-u.
Ovu proceduru možete koristiti za migraciju na FCMv1 obaveštenja za UC-One Connect ili UC-One SaaS Android aplikacije.
Morate da koristite FCMv1 ako želite da koristite NPS proksi za autentifikaciju push obaveštenja u UC-One ili Vebek Android aplikacijama.
Ovaj zadatak priprema NPS za FCMv1 tako da ga možete omogućiti kao deo konfiguracije NPS proksija za autentifikaciju. Ne omogućavajte FCMv1 dok ne budete spremni da konfigurišete NPS proki za autentifikaciju ili obaveštenja SaaS klijentima neće uspeti.

1	Preuzmite ID projekta sa Firebase konzole: Prijavite se na console.firebase.google.com. Izaberite projekat aplikacije UC-One (Connect ili SaaS), otvorite postavke projekta. Otvorite karticu Op šte i zabeležite ID projekta.
2	Preuzmite privatni ključ svog servisnog naloga od Firebase-a: Idite na karticu Servisni nalozi u podešavanjima projekta. Ili napravite novi nalog usluge i nabavite njegov privatni ključ. Ili otvorite postojeći servisni račun i generišite novi privatni ključ za njega. Napomena: Ser visni nalog mora imati dozvolu firebaseadmin -sdk. Preuzmite ključ (.json datoteku) na sigurnu lokaciju.
3	`Uvezite.json datoteku na ADP server /bv/install.`
4	Prijavite se na ADP CLI i dodajte ključ projekta i API u kontekst FCM projekata: `ADP_CLI/Aplikacije/ObaveštenjaPushServer/FCM/Projekti> dodaj connect-ucaas /bv/install/ ime datoteke.json`
5	Dodajte ID aplikacije i projekta u kontekst FCM aplikacija: `ADP_CLI/Aplikacije/ObaveštenjaPushServer/FCM/Aplikacije> dodajte Applic ationID com.broadsoft.ucaas.connect ProjectID projekt-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`

Ponovo omogućite FCM Legaci režim

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 push 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 proksija za autentifikaciju NPS.

1	Prijavite se na KSSP koji hostuje vaš deljeni NPS.
2	Idite do konteksta FCM i onemogućite FCM v1: `XSP_CLI/Applications/NotificationPushServer/` FCM> postavite V1enabled false da biste se vratili na korišćenje FCM nasleđenog API ključa.

Instalirajte NPS proki zakrpe za autentifikaciju

Instalirajte sledeće zakrpe da biste podržali funkciju NPS proksija za autentifikaciju:

R22 zakrpe

R23 zakrpe

Konfigurišite NPS da koristi proksi za autentifikaciju

Napravite zahtev za uslugu sa svojim kontaktom za uključivanje ili pomoću TAC-a da biste obezbedili svoj (Vebek Common Identity) OAuth klijentski nalog. Naslovite svoj zahtev za uslugu NPS konfiguracija za podešavanje Auth Proksija.

Dajemo vam OAuth ID klijenta, tajnu klijenta i token za osvežavanje koji važi 60 dana. Ako token istekne pre nego što ga upotrebite sa svojim NPS-om, možete pokrenuti drugi zahtev.

Kreirajte nalog klijenta na NPS-u:

KSSP_CLI/Aplikacije/ObaveštenjaPushServer/CISCOCI/klijent> podesite ID klijenta-ID-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

Pokrenite naredbu da biste proverili da li vrednosti koje ste uneli odgovaraju onima koje su vam date. KSSP_CLI/Aplikacije/NotificationPushServer/Ciscoci/Client> dobiti

Unesite URL NPS prokija i podesite interval osvežavanja tokena (preporučuje se 30 minuta):

FkDNS zasnovan na regionu:

Istok SAD:

KSSP_CLI /Aplikacije/ObaveštenjaPushServer/CloudnpsService> podesite url https://broadworks-idp-proxy-a.wbx2.com/nps/

Zapad SAD:

KSSP_CLI /Aplikacije/ObaveštenjaPushServer/CloudnpsService> podesite url https://broadworks-idp-proxy-r.wbx2.com/nps/

Evropa:

KSSP_CLI /Aplikacije/ObaveštenjaPushServer/CloudnpsService> podesite url https://broadworks-idp-proxy-k.wbx2.com/nps/

KSSP_CLI /Aplikacije/ObaveštenjaPushServer/CloudNPSService> podesite VoipTokenRefreshInterval 1800

Saudijska Arabija:

KSSP_CLI /Aplikacije/ObaveštenjaPushServer/CloudnpsService> podesite url https://broadworks-idp-proxy-d.wbx2.com/nps/

Australija:

KSSP_CLI /Aplikacije/ObaveštenjaPushServer/CloudnpsService> podesite url https://broadworks-idp-proxy-m.wbx2.com/nps/

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

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

Za aplikaciju Vebek na Androidu: KSSP_CLI/Aplikacije/NotificationPushServer/FCM/Applications> dodaj com.cisco.vk2. android

Za UC-One aplikaciju na Androidu: KS SP_CLI/Applications/NotificationPushServer/FCM/Applications> dodaj com.broadsoft.connect

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

Za aplikaciju Vebek na iOS-u: KSSP_CLI/Aplikacije/NotificationPushServer/APNS/Production/Tokens> dodaj com.cisco.skuared

Za UC-One aplikaciju na iOS-u: KSSP_CLI/Aplikacije/NotificationPushServer/APNS/Production/Tokens> dodaj com.cisco.skuared

Konfigurišite sledeće NPS URL adrese:

KSSP CLI kontekst	Parametar	Vrednost
`KSSP_CLI/Aplikacije/ObaveštenjaPushServer/FCM>`	`AuthURL`	`https://www.googleapis.com/oauth2/v4/token`
	`PushUrl`	`https://fcm.googleapis.com/v1/projects//messages:send`
	`obim`	`https://www.googleapis.com/auth/firebase.messaging`
`KSSP_CLI/Aplikacije/ObaveštenjaPushServer/APNS/Proizvodna>`	`url`	`https://api.push.apple.com/3/device`

Konfigurišite sledeće parametre NPS veze na prikazane preporučene vrednosti:

KSSP CLI kontekst	Parametar	Vrednost
`KSSP_CLI/Aplikacije/ObaveštenjaPushServer/FCM>`	`TokentimeToLiveInSeconds`	3600
	`VezaVeličina bazena`	10
	`Vreme povezivanjaOtinMilisekundi`	3000
	`VezaIdleTimeOutInSeconds`	600
`KSSP_CLI/Aplikacije/ObaveštenjaPushServer/APNS/Proizvodna>`	`Vreme za povezivanje`	3000
	`VezaVeličina bazena`	2
	`VezaIdleTimeOutInSeconds`	600

Proverite da li Application Server pregledava ID-ove aplikacija, jer ćete možda morati da dodate Vebek aplikacije na listu dozvola:

Pokrenite AS_CLI/Sistem/PushNotification> dobijte i proverite vrednost EmplicalovedApplicationList. Ako je istina, morate da izvršite ovaj podzadatak. U suprotnom, preskočite ostatak podzadatka.
AS_CLI/Sistem/Pushnoti fication/Dopuštene aplikacije> dodajte com.cisco.vk2.android „Vebek Android“
AS_CLI/Sistem/Pushnoti fication/Dopuštene aplikacije> dodajte com.cisco.kvadrat „Vebek iOS“

Ponovo pokrenite NPS i testirajte push obaveštenja

1	Ponovo pokrenite KSSP: `bvrestart`
2	Testirajte obaveštenja o pozivima na Android upućivanjem poziva od pretplatnika BroadVorks 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: `Onemogućite FCMv1: KSSP _CLI/Aplikacije/NotificationPushServer/FCM> set V1Enabled false` `Ponovo pokrenite KSSP: bvrestart` Proverite svoju konfiguraciju. Ponovo omogućite FCMv1 i ponovo pokrenite KSSP. Ponovite test.
3	Testirajte obaveštenja o pozivima na iOS upućivanjem poziva od pretplatnika BroadVorks 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 ne uspevaju 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 `postavljenim HTTP` 2omogućenim lažnim

Cisco AI Assistant

Hvala na povratnim informacijama.