Конфигуришите push обавештења о позивима за Webex BroadWorks

list-menuPovratne informacije?
Сазнајте како да подесите push обавештења о позивима за Webex за BroadWorks користећи NPS за Android и iOS.

U ovom dokumentu koristimo termin Pozivna obaveštenja Push Server (CNPS) da bismo opisali aplikaciju hostovanu u XSP-u ili aplikaciju hostovanu za ADP koja se pokreće u vašem okruženju. Vaš CNPS radi sa vašim BroadWorks sistemom da bi bio svestan dolaznih poziva vašim korisnicima, i gura obaveštenja o njima u Google Firebase Cloud Messaging (FCM) ili Apple Push Notification servis (APNS) usluge obaveštavanja.

Te usluge obaveštavaju mobilne uređaje Webex-a za pretplatnike Cisco BroadWorks-a da imaju dolazne pozive na Webex-u.

Više informacija o NPS-u potražite u opisu funkcije "Obaveštenje PushServer".

Sličan mehanizam u Webexu funkcioniše sa Webex servisima za razmenu poruka i prisustva kako bi se pogurala obaveštenja na Google (FCM) ili Apple (APNS) servise za obaveštavanje. Te usluge zauzvrat obaveštavaju korisnike mobilnog Webexa o dolaznim porukama ili promenama prisustva.

Овај одељак описује како конфигурисати NPS за прокси за аутентификацију када NPS већ не подржава друге апликације. Ако је потребно да мигрирате дељени NPS да би користио NPS прокси, погледајте Ажурирање Cisco BroadWorks NPS-а за коришћење NPS проксија.

Pregled proxy servera NPS

Da biste bili kompatibilni sa Webex-om za Cisco BroadWorks, vaš CNPS mora biti zakrpljen da bi podržao NPS Proxy funkciju, Push Server za VoIP u UCaaS-u.

Funkcija primenjuje novi dizajn u serveru za guranje obaveštenja da bi rešila bezbednosnu ranjivost deljenja potvrde o guranju privatnih ključeva certifikata sa dobavljačima usluga za mobilne klijente. Umesto deljenja push notification sertifikata i ključeva sa provajderom usluga, NPS koristi novi API za dobijanje kratkotrajnog push notification tokena od Webex-a za Cisco BroadWorks backend, i koristi ovaj token za potvrdu identiteta sa Apple APNS i Google FCM servisima.

Funkcija takođe poboljšava mogućnost Notification Push Servera da gura obaveštenja na Android uređaje putem novog Google Firebase Cloud Messaging (FCM) HTTPv1 API.

Razmatranja APNS-a

Apple više neće podržavati BINARNI protokol zasnovan na HTTP/1 na Apple Push Notification servisu posle 31. marta 2021. godine. Препоручујемо да конфигуришете свој XSP|ADP да користи HTTP/2-based интерфејс за АПН-ове. Ово ажурирање захтева да ваш XSP|ADP који хостује NPS користи R22 или новију верзију.

Pripremite svoj NPS za Webex za Cisco BroadWorks

1

Instalirajte i konfigurišite namenski XSP (minimalna verzija R22) ili Platformu za isporuku aplikacija (ADP).

2

Instalirajte proxy zakrpe za NPS potvrdu identiteta:

3

Aktivirajte aplikaciju Notification Push Server.

4

(Za Android obaveštenja) Omogućite FCM v1 API na NPS- u.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Za Apple iOS obaveštenja) Omogućite HTTP/2 na NPS-u.

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

Ово је ексклузивно за издање 22 и старије верзије; није доступно у издању 23 и новијим верзијама, које подржавају само HTTP/2.

6

Priložite techsupport iz NPS XSP/ADP.

7

На сваком AS серверу, датотека namedefs у /usr/local/broadworks/bw_base/conf мора бити конфигурисана са SRV и A записима за сервер за пусх обавештења (XSP/ADP) претрага, ако их је више XSP/ADP затим додајте унос за сваки по потреби.

Primer: _pushnotification-клијент._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com У А 10.193.78.149

Једном подешено, потребно је једно од следећег да би се промене примениле:

  1. Поновно покретање bw се може извршити у прозору за одржавање.

  2. Преко Cisco BroadWorks CLI-ја:

    R24 и старији

    AS_CLI/ASDiagnostic/DNS> reload

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> reload

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> reload

Šta je sledeće

За нове инсталације NPS-а, идите на Конфигуришите NPS да користи прокси за аутентификацију

Да бисте мигрирали постојеће Андроид имплементирање на FCMv1, идите на Мигрирај NPS на FCMv1

Конфигуришите NPS да користи прокси за аутентификацију

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

Ако желите да конфигуришете прокси за аутентификацију на NPS-у који се дели са другим мобилним апликацијама, погледајте Ажурирање Cisco BroadWorks NPS-а за коришћење NPS проксија.

1

Добијање OAuth акредитива за ваш Webex за Cisco BroadWorks.

2

Kreirajte klijentski nalog u 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 proverili da li se vrednosti koje ste uneli podudaraju sa datim vrednostima, pokrenite XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI issuerUrl треба УВЕК да буде US CI кластер без обзира на вашу локацију, а подразумевана вредност треба да буде:

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

3

Unesite NPS proxy URL adresu i podesite interval osvežavanja simbola (preporučuje se 30 minuta):

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

Да бисте побољшали брзину DNS резолуције, уместо тренутног FQDN-а nps.uc-one.broadsoft.com, препоручујемо вам да користите одговарајући FQDN на основу вашег региона.

FQDN-ови засновани на региону:

US East:

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

Запад САД:

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

Ако време чекања за push обавештења истекне због кашњења у DNS резолуцији, повећајте вредност временског ограничења у "/etc/resolv.conf" датотеку на BroadWorks серверу.

4

(Za Android obaveštenja) 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 Apple iOS obaveštenja) Dodajte ID aplikacije u kontekst APNS aplikacija, obavezno izostavite taster Auth – podesite ga na prazan.

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

6

Konfigurišite sledeće NPS URL adrese:

XSP|ADP CLI контекст

Parametar

Vrednost

  • 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

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

XSP|ADP CLI контекст

Parametar

Vrednost

  • 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

Proverite da li server aplikacije pregleda ID-ove aplikacija zato što ćete možda morati da dodate Webex aplikacije na listu dozvoljenih stavki:

  1. Покрените AS_CLI/System/PushNotification> get и проверите вредност enforceAllowedApplicationList. Ако је true, потребно је да завршите овај подзадатак. U suprotnom, preskočite ostatak potkompjute.

  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

Поново покрените XSP|ADP: bwrestart

10

Testirajte obaveštenja o pozivima tako što ćete pozivati pretplatnika BroadWorks-a na dva Webex mobilna korisnika. Проверите да ли се обавештење о позиву појављује на iOS и Android уређајима.

Preseli NPS u FCMv1

Ova tema sadrži opcionalne procedure koje možete koristiti u Google FCM Konzoli kada imate postojeću NPS primenu koja vam je potrebna za migraciju na FCMv1. Postoje tri procedure:

Мигрирајте UC-One клијенте на FCMv1

Користите доленаведене кораке у Google FCM конзоли да бисте мигрирали UC-One клијенте на Google FCM HTTPv1.

Ako je brendiranje primenjeno na klijenta, klijent mora da ima ID pošiljaoca. U fcM konzoli pogledajte postavke projekta > Cloud Messaging. Postavka se pojavljuje u tabeli Akreditivi projekta.

За детаље погледајте Водич за брендирање Connect Mobile на 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?. Погледајте параметар gcm_defaultSenderId, који се налази у Branding Kit-у, у фолдеру Resource, датотеци branding.xml са следећом синтаксом:

xxxxxxxxxxxxx

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

  2. Izaberite odgovarajuću Android aplikaciju.

  3. Na kartici Opšte postavke zakažete ID projekta

  4. Dođite do kartice "Nalozi usluga" da biste konfigurisali nalog usluge. Možete da kreirate novi nalog usluge ili da konfigurišete postojeći.

    Da biste kreirali novi nalog usluge:

    1. Kliknite na plavo dugme za kreiranje novog naloga usluge

    2. Kliknite na plavo dugme da biste generisali novi privatni ključ

    3. Preuzimanje ključa na bezbednu lokaciju

    Da biste ponovo uradili postojeći nalog usluge:

    1. Kliknite na plavi tekst da biste videli postojeće naloge servisa.

    2. Identifikujte nalog usluge koji ćete koristiti. Nalogu usluge potrebna je dozvola firebaseadmin-sdk.

    3. Sa desne strane, kliknite na meni hamburgera i kreirajte novi privatni ključ.

    4. Preuzmite json datoteku koja sadrži ključ i sačuvajte je na bezbednoj lokaciji.

  5. Копирајте json датотеку на XSP|ADP.

  6. Konfigurišite ID projekta i:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
  7. Konfigurišite aplikaciju:

    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. Покрените команду bwrestart да бисте поново покренули XSP|ADP.

Preseli SaaS klijente u FCMv1

Koristite dole navedene korake na Google FCM Konzoli ako želite da migrirate SaaS klijente u FCMv1.

Uverite se da ste već dovršili proceduru "Konfigurisanje NPS-a za korišćenje proxy servera za potvrdu identiteta".

  1. Onemogući FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Покрените команду bwrestart да бисте поново покренули XSP|ADP.

  3. Omogući FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Покрените команду bwrestart да бисте поново покренули XSP|ADP.

Ažuriraj ADP server

Koristite dole navedene korake u Google FCM Konzoli ako migrirate NPS da biste koristili ADP server.

  1. Nabavite JSON fajl iz Google Cloud Konzole:

    1. Na Google Cloud konzoli idite na stranicu "Nalozi usluga".

    2. Izaberite projekat, odaberite projekat i kliknite na dugme Otvori.

    3. Пронађите ред налога услуге за који желите да креирате кључ, кликните на вертикално дугме [ Више, а затим кликните на Креирај кључ

    4. Изаберите тип кључа и кликните на Креирај

      Datoteka preuzima.

  2. Dodaj FCM ADP serveru:

    1. Увезите JSON датотеку на ADP сервер помоћу команде /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. Proverite 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
Da li je ovaj članak bio koristan?
Da li je ovaj članak bio koristan?