Konfigurirajte push obavijesti o pozivima za Webex BroadWorks

list-menuŽelite li poslati povratne informacije?
Saznajte kako postaviti push obavijesti o pozivima za Webex za BroadWorks pomoću NPS-a za Android i iOS.

U ovom dokumentu koristimo pojam Push Server obavijesti o pozivima (CNPS) za opisivanje aplikacije smještene na XSP-u ili aplikacije smještene na ADP-u koja se pokreće u vašem okruženju. Vaš CNPS surađuje s vašim BroadWorks sustavom kako bi bio svjestan dolaznih poziva vašim korisnicima i potiskuje obavijesti o njima na usluge obavijesti Google Firebase Cloud Messaging (FCM) ili Apple Push Notification Service (APN-ove).

Te usluge obavještavaju mobilne uređaje Webexa za pretplatnike Cisco BroadWorksa da imaju dolazne pozive na Webexu.

Dodatne informacije o NPS-u potražite u opisu značajke push poslužitelja obavijesti.

Sličan mehanizam u Webexu surađuje s webex uslugama razmjene poruka i prisutnosti za proslijeđene obavijesti Google (FCM) ili Apple (APNS) uslugama obavještavanja. Te usluge zauzvrat obavještavaju korisnike mobilnog Webexa o dolaznim porukama ili promjenama prisutnosti.

Ovaj odjeljak opisuje kako konfigurirati NPS za proxy za autentifikaciju kada NPS već ne podržava druge aplikacije. Ako trebate migrirati dijeljeni NPS za korištenje NPS proxyja, pogledajte Ažuriranje Cisco BroadWorks NPS-a za korištenje NPS proxyja.

Pregled NPS proxy poslužitelja

Za kompatibilnost s Webexom za Cisco BroadWorks, vaš CNPS mora biti zakrpan kako bi podržao značajku NPS proxyja, Push Server za VoIP u UCaaS-u.

Značajka implementira novi dizajn u push poslužitelju obavijesti kako bi se riješila sigurnosna ranjivost dijeljenja privatnih ključeva certifikata push obavijesti s davateljima usluga za mobilne klijente. Umjesto dijeljenja push certifikata i ključeva s davateljem usluga, NPS koristi novi API za dobivanje kratkotrajnog tokena push obavijesti od Webexa za cisco BroadWorks pozadinski sustav i koristi ovaj token za provjeru autentičnosti s Apple APN-ovima i Google FCM uslugama.

Značajka također poboljšava mogućnost push poslužitelja obavijesti da gura obavijesti na Android uređaje putem novog Google Firebase Cloud Messaging (FCM) HTTPv1 API-ja.

Razmatranja APNS-a

Apple više neće podržavati binarni protokol temeljen na HTTP/1 na usluzi Apple Push Notification nakon 31. ožujka 2021. Preporučujemo da konfigurirate svoj XSP|ADP za korištenje HTTP/2-based sučelje za APN-ove. Za ovo ažuriranje potrebno je da vaš XSP|ADP koji hostira NPS bude s verzijom R22 ili novijom.

Pripremite svoj NPS za Webex za Cisco BroadWorks

1

Instalirajte i konfigurirajte namjenski XSP (minimalna verzija R22) ili platformu za isporuku aplikacija (ADP).

2

Instalirajte zakrpe NPS proxy poslužitelja za provjeru autentičnosti:

3

Aktivirajte aplikaciju Push Server obavijesti.

4

(Za obavijesti o Androidu) Omogućite FCM v1 API na NPS-u.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Za Obavijesti o Apple iOS-u) Omogućite HTTP/2 na NPS-u.

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

Ovo je isključivo za izdanje 22 i starije verzije; nije dostupno u izdanju 23 i novijim verzijama, koje podržavaju samo HTTP/2.

6

Priložite tehničku podršku iz NPS XSP/ADP-a.

7

Na svakom AS poslužitelju, datoteka namedefs u /usr/local/broadworks/bw_base/conf mora biti konfigurirana sa SRV i A zapisima za poslužitelj za slanje obavijesti (XSP/ADP) pretraga, ako ih je više XSP/ADP zatim dodajte unos za svaki prema potrebi.

Primjer: _pushnotification-klijent._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com U A 10.193.78.149

Nakon postavljanja, za preuzimanje promjena potrebno je jedno od sljedećeg:

  1. Ponovno pokretanje bw se može izvršiti u prozoru za održavanje.

  2. Putem Cisco BroadWorks CLI-ja:

    R24 i stariji

    AS_CLI/ASDiagnostic/DNS> ponovno učitaj

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> ponovno učitaj

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> ponovno učitaj

Što učiniti sljedeće

Za nove instalacije NPS-a, idite na Konfiguriranje NPS-a za korištenje proxyja za autentifikaciju

Za migraciju postojećeg Android sustava na FCMv1, idite na Migracija NPS-a na FCMv1

Konfigurirajte NPS za korištenje proxyja za autentifikaciju

Ovaj se zadatak odnosi na novu instalaciju NPS-a, posvećenu Webexu za Cisco BroadWorks.

Ako želite konfigurirati proxy za autentifikaciju na NPS-u koji se dijeli s drugim mobilnim aplikacijama, pogledajte Ažuriranje Cisco BroadWorks NPS-a za korištenje NPS proxyja.

1

Dobivanje OAuth vjerodajnica za vaš Webex za Cisco BroadWorks.

2

Stvorite klijentski račun na NPS-u:

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

Da biste provjerili podudaranje vrijednosti koje ste unijeli s onima koje ste dobili, pokrenite XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI issuerUrl bi UVIJEK trebao biti US CI klaster bez obzira na vašu lokaciju, a zadana vrijednost bi trebala biti:

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

3

Unesite URL proxy poslužitelja NPS i postavite interval osvježavanja tokena (preporučeno je 30 minuta):

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

Kako bismo poboljšali brzinu DNS razrješenja, umjesto trenutnog FQDN-a nps.uc-one.broadsoft.com preporučujemo korištenje odgovarajućeg FQDN-a ovisno o vašoj regiji.

FQDN-ovi temeljeni na regiji:

Istok SAD-a:

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

Zapad SAD-a:

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

Ako push obavijesti isteknu zbog kašnjenja u DNS razrješavanju, povećajte vrijednost isteka u "/etc/resolv.conf" datoteku na BroadWorks poslužitelju.

4

(Za obavijesti o Androidu) Dodajte ID Android aplikacije u kontekst FCM aplikacija na NPS-u.

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

5

(Za Obavijesti o sustavu Apple iOS) Dodajte ID aplikacije u kontekst APNS aplikacija, pazeći da izostavite tipku Auth - postavite ga na prazno.

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

6

Konfigurirajte sljedeće NPS URL-ove:

XSP|ADP CLI kontekst

Parametar

Vrijednost

  • 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

Konfigurirajte sljedeće parametre NPS veze s preporučenim prikazanim vrijednostima:

XSP|ADP CLI kontekst

Parametar

Vrijednost

  • 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

Provjerite prikazuje li aplikacijski poslužitelj ID-ove aplikacija jer ćete možda morati dodati webex aplikacije na popis dopuštenih:

  1. Pokrenite AS_CLI/System/PushNotification> get i provjerite vrijednost enforceAllowedApplicationList. Ako je true, morate dovršiti ovaj podzadatak. U suprotnom preskočite ostatak pod zadatka.

  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

Ponovno pokrenite XSP|ADP: bwrestart

10

Testirajte obavijesti o pozivima upućivanjem poziva pretplatnika na BroadWorks dvama mobilnim korisnicima Webexa. Provjerite prikazuje li se obavijest o pozivu na iOS i Android uređajima.

Migracija NPS-a na FCMv1

Ova tema sadrži neobavezne postupke koje možete koristiti na Google FCM konzoli kada imate postojeću NPS implementaciju koju trebate migrirati na FCMv1. Postoje tri postupka:

Migrirajte UC-One klijente na FCMv1

Pomoću dolje navedenih koraka u Google FCM konzoli migrirajte UC-One klijente na Google FCM HTTPv1.

Ako se branding primjenjuje na klijenta, klijent mora imati ID pošiljatelja. U konzoli FCM pogledajte Postavke projekta > Razmjena poruka u oblaku. Postavka se pojavljuje u tablici vjerodajnica projekta.

Za detalje pogledajte Vodič za brendiranje Connect Mobile na 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?. Pogledajte parametar gcm_defaultSenderId koji se nalazi u Branding Kitu, mapi Resource, datoteci branding.xml sa sljedećom sintaksom:

xxxxxxxxxxxxx

  1. Prijavite se u FCM Admin SDK na .http://console.firebase.google.com

  2. Odaberite odgovarajuću Android aplikaciju.

  3. Na kartici Općenito zabilježite ID projekta

  4. Idite na karticu računi servisa da biste konfigurirali račun servisa. Možete stvoriti novi račun servisa ili konfigurirati postojeći.

    Da biste stvorili novi račun servisa:

    1. Kliknite plavi gumb da biste stvorili novi račun servisa

    2. Kliknite na plavi gumb za generiranje novog privatnog ključa

    3. Preuzimanje ključa na sigurno mjesto

    Da biste ponovno koristio postojeći račun servisa:

    1. Kliknite plavi tekst da biste vidjeli postojeće račune servisa.

    2. Identificirajte račun servisa koji želite koristiti. Servisni račun treba dozvolu firebaseadmin- sdk.

    3. Na samoj desnoj strani kliknite izbornik hamburgera i stvorite novi privatni ključ.

    4. Preuzmite json datoteku koja sadrži ključ i spremite na sigurno mjesto.

  5. Kopirajte json datoteku na XSP|ADP.

  6. Konfigurirajte ID projekta i :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
  7. Konfiguriranje aplikacije:

    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. Omogući FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Pokrenite naredbu bwrestart za ponovno pokretanje XSP|ADP-a.

Migracija SaaS klijenata na FCMv1

Ako želite migrirati SaaS klijente na FCMv1, upotrijebite korake u nastavku na Google FCM Consoleu.

Provjerite jeste li već dovršili postupak "Konfiguriranje NPS-a za korištenje proxyja za provjeru autentičnosti".

  1. Onemogući FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Pokrenite naredbu bwrestart za ponovno pokretanje XSP|ADP-a.

  3. Omogući FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Pokrenite naredbu bwrestart za ponovno pokretanje XSP|ADP-a.

Ažuriraj ADP poslužitelj

Ako migrirate NPS za korištenje ADP poslužitelja, upotrijebite korake u nastavku u Google FCM konzoli.

  1. Nabavite JSON datoteku s Google Cloud Consolea:

    1. Na Google cloud konzoli otvorite stranicu Računi usluge.

    2. Kliknite Odaberite projekt, odaberite projekt i kliknite Otvori .

    3. Pronađite redak servisnog računa za koji želite stvoriti ključ, kliknite okomiti gumb Više, a zatim kliknite Stvori ključ.

    4. Odaberite vrstu ključa i kliknite Stvori

      Datoteka se preuzima.

  2. DodajTE FCM na ADP poslužitelj:

    1. Uvezite JSON datoteku na ADP poslužitelj pomoću naredbe /bw/install.

    2. Prijavite se na ADP CLI i dodajte project i API ključ:

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

    3. Zatim dodajte aplikaciju i ključ:

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

    4. Provjerite konfiguraciju:

      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
Je li taj članak bio koristan?
Je li taj članak bio koristan?