Konfigurirajte potisna obvestila o klicih za Webex BroadWorks

list-menuPovratne informacije?
Naučite se nastaviti potisna obvestila o klicih za Webex za BroadWorks z uporabo NPS za Android in iOS.

V tem dokumentu uporabljamo izraz strežnik za pošiljanje obvestil o klicih (CNPS) za opis aplikacije, ki jo gosti XSP ali ADP in se izvaja v vašem okolju. Vaš CNPS sodeluje z vašim sistemom BroadWorks, da se zaveda dohodnih klicev vaših uporabnikov in o njih pošilja obvestila v storitve obveščanja Google Firebase Cloud Messaging (FCM) ali Apple Push Notification service (APNs).

Te storitve obvestijo mobilne naprave naročnikov Webex za Cisco BroadWorks, da imajo dohodne klice na Webexu.

Za več informacij o NPS glejte Opis funkcije strežnika za potisna obvestila.

Podoben mehanizem v Webexu deluje s storitvami za sporočanje in prisotnost Webex za pošiljanje obvestil storitvam za obveščanje Google (FCM) ali Apple (APNS). Te storitve nato obveščajo uporabnike mobilnega Webexa o dohodnih sporočilih ali spremembah prisotnosti.

V tem razdelku je opisano, kako konfigurirati NPS za posredniški strežnik za preverjanje pristnosti, če NPS še ne podpira drugih aplikacij. Če morate migrirati skupni NPS za uporabo proxyja NPS, glejte Posodobitev Cisco BroadWorks NPS za uporabo proxyja NPS.

Pregled proxyja NPS

Za združljivost z Webexom za Cisco BroadWorks mora biti vaš CNPS popravljen, da podpira funkcijo NPS Proxy, Push Server za VoIP v UCaaS.

Funkcija uvaja novo zasnovo v strežniku za potisna obvestila, da bi odpravila varnostno ranljivost deljenja zasebnih ključev potrdil za potisna obvestila s ponudniki storitev za mobilne odjemalce. Namesto deljenja potrdil in ključev za potisna obvestila s ponudnikom storitev NPS uporablja nov API za pridobitev kratkotrajnega žetona za potisna obvestila od Webexa za zaledni sistem Cisco BroadWorks in ta žeton uporablja za preverjanje pristnosti z Apple APN-ji in storitvami Google FCM.

Funkcija prav tako izboljšuje zmožnost strežnika Notification Push Server za pošiljanje obvestil v naprave Android prek novega API-ja Google Firebase Cloud Messaging (FCM) HTTPv1.

Premisleki glede APNS

Apple ne bo več podpiral HTTP/1-based binarni protokol v storitvi Apple Push Notification po 31. marcu 2021. Priporočamo, da konfigurirate svoj XSP|ADP za uporabo HTTP/2-based vmesnik za APN-je. Ta posodobitev zahteva, da vaš XSP|ADP, ki gosti NPS, uporablja različico R22 ali novejšo.

Pripravite svoj NPS za Webex za Cisco BroadWorks

1

Namestite in konfigurirajte namensko platformo XSP (najmanj različice R22) ali platformo za dostavo aplikacij (ADP).

2

Namestite popravke proxyja za preverjanje pristnosti NPS:

3

Aktivirajte aplikacijo Strežnik za potisna obvestila.

4

(Za obvestila za Android) Omogočite API FCM v1 na NPS-ju.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Za obvestila Apple iOS) Omogoči HTTP/2 na NPS.

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

To velja izključno za izdajo 22 in starejše različice; ni na voljo v izdaji 23 in novejših različicah, ki podpirajo samo HTTP/2.

6

Priložite tehnično podporo NPS-a XSP/ADP.

7

Na vsakem strežniku AS mora biti datoteka namedefs v /usr/local/broadworks/bw_base/conf konfigurirana z zapisi SRV in A za strežnik za potisna obvestila. (XSP/ADP) iskanje, če jih je več XSP/ADP nato pa po potrebi dodajte vnos za vsakega.

Primer: _pushnotification-odjemalec._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com V A 10.193.78.149

Ko je nastavljeno, je za prevzem sprememb potrebno eno od naslednjega:

  1. Ponovni zagon se izvede v vzdrževalnem oknu.

  2. Prek vmesnika Cisco BroadWorks CLI:

    R24 in starejši

    AS_CLI/ASDiagnostic/DNS> znova naloži

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> znova naloži

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> znova naloži

Kaj storiti naprej

Za nove namestitve NPS-ja pojdite na Konfiguriranje NPS-ja za uporabo proxyja za preverjanje pristnosti

Če želite obstoječo uvedbo sistema Android preseliti v FCMv1, pojdite na Migracija NPS v FCMv1

Konfigurirajte NPS za uporabo posredniškega strežnika za preverjanje pristnosti

To opravilo velja za novo namestitev NPS, namenjeno Webexu za Cisco BroadWorks.

Če želite konfigurirati proxy za preverjanje pristnosti na NPS-ju, ki je v skupni rabi z drugimi mobilnimi aplikacijami, glejte Posodobitev Cisco BroadWorks NPS za uporabo proxyja NPS.

1

Pridobivanje poverilnic OAuth za vaš Webex za Cisco BroadWorks.

2

Ustvarite odjemalski račun na NPS:

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

Če želite preveriti, ali se vnesene vrednosti ujemajo s prejetimi, zaženite XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

IssuerUrl CiscoCI mora VEDNO biti gruča US CI, ne glede na vašo lokacijo, privzeta vrednost pa mora biti:

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

3

Vnesite URL proxyja NPS in nastavite interval osveževanja žetona (priporočeno 30 minut):

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

Za povečanje hitrosti razreševanja DNS-ov vam namesto trenutnega FQDN nps.uc-one.broadsoft.com priporočamo uporabo ustreznega FQDN-ja glede na vašo regijo.

Regijski FQDN-ji:

Vzhod ZDA:

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

Zahod ZDA:

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

Če potisna obvestila zaradi zamude pri razreševanju DNS-a prenehajo veljati, povečajte vrednost časovne omejitve v "/etc/resolv.conf" datoteka na strežniku BroadWorks.

4

(Za obvestila za Android) Dodajte ID aplikacije za Android v kontekst aplikacij FCM na NPS.

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

5

(Za obvestila Apple iOS) Dodajte ID aplikacije v kontekst aplikacij APNS, pri čemer izpustite ključ za avtorizacijo – nastavite ga na prazno.

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

6

Konfigurirajte naslednje URL-je NPS:

Kontekst XSP|ADP CLI

Parameter

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

Konfigurirajte naslednje parametre povezave NPS na prikazane priporočene vrednosti:

Kontekst XSP|ADP CLI

Parameter

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

Preverite, ali aplikacijski strežnik pregleduje ID-je aplikacij, ker boste morda morali aplikacije Webex dodati na seznam dovoljenih:

  1. Zaženite AS_CLI/System/PushNotification> get in preverite vrednost enforceAllowedApplicationList. Če je true, morate dokončati to podnalogo. Sicer preskočite preostanek podnaloge.

  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

Znova zaženite XSP|ADP: bwrestart

10

Preizkusite obvestila o klicih tako, da opravite klice z naročnika BroadWorks dvema uporabnikoma mobilnih naprav Webex. Preverite, ali se obvestilo o klicu prikaže v napravah iOS in Android.

Migracija NPS-ja v FCMv1

Ta tema vsebuje izbirne postopke, ki jih lahko uporabite v konzoli Google FCM, če imate obstoječo uvedbo NPS, ki jo morate preseliti v FCMv1. Obstajajo trije postopki:

Migracija odjemalcev UC-One v FCMv1

Za migracijo odjemalcev UC-One v Google FCM HTTPv1 uporabite spodnje korake v konzoli Google FCM.

Če se na stranko nanaša blagovna znamka, mora imeti stranka ID pošiljatelja. V konzoli FCM glejte Nastavitve projekta > Sporočanje v oblaku. Nastavitev se prikaže v tabeli poverilnic projekta.

Za podrobnosti glejte Vodnik za mobilno blagovno znamko Connect 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?. Glejte parameter gcm_defaultSenderId, ki se nahaja v mapi Resource v kompletu Branding Kit, datoteki branding.xml, s spodnjo sintakso:

xxxxxxxxxxxxx

  1. Prijavite se v skrbniški SDK FCM na http://console.firebase.google.com.

  2. Izberite ustrezno aplikacijo za Android.

  3. Na zavihku Splošno zabeležite ID projekta

  4. Za konfiguracijo računa storitve se pomaknite na zavihek računov storitev. Ustvarite lahko nov račun storitve ali konfigurirate obstoječega.

    Če želite ustvariti nov račun storitve:

    1. Kliknite modri gumb za ustvarjanje novega servisnega računa

    2. Kliknite modri gumb za ustvarjanje novega zasebnega ključa

    3. Prenesite ključ na varno mesto

    Če želite ponovno uporabiti obstoječi račun storitve:

    1. Kliknite modro besedilo za ogled obstoječih računov storitev.

    2. Določite račun storitve, ki ga želite uporabiti. Storitveni račun potrebuje dovoljenje firebaseadmin-sdk.

    3. Na skrajni desni strani kliknite meni hamburgerja in ustvarite nov zasebni ključ.

    4. Prenesite datoteko JSON, ki vsebuje ključ, in jo shranite na varno mesto.

  5. Kopirajte datoteko json na XSP|ADP.

  6. Konfigurirajte ID projekta in :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
  7. Konfigurirajte aplikacijo:

    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. Omogoči FCMv1:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Za ponovni zagon XSP|ADP zaženite ukaz bwrestart.

Migracija odjemalcev SaaS v FCMv1

Če želite odjemalce SaaS preseliti v FCMv1, sledite spodnjim korakom v konzoli Google FCM.

Prepričajte se, da ste že zaključili postopek »Konfiguracija NPS za uporabo posredniškega strežnika za preverjanje pristnosti«.

  1. Onemogoči FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Za ponovni zagon XSP|ADP zaženite ukaz bwrestart.

  3. Omogoči FCM:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Za ponovni zagon XSP|ADP zaženite ukaz bwrestart.

Posodobi strežnik ADP

Če selite NPS za uporabo strežnika ADP, uporabite spodnje korake v konzoli Google FCM.

  1. Pridobite datoteko JSON iz konzole Google Cloud:

    1. V konzoli Google Cloud Console pojdite na stran Računi storitev.

    2. Kliknite Izberi projekt, izberite svoj projekt in kliknite Odpri.

    3. Poiščite vrstico storitvenega računa, za katerega želite ustvariti ključ, kliknite navpični gumb Več in nato kliknite Ustvari ključ.

    4. Izberite vrsto ključa in kliknite Ustvari

      Datoteka se prenese.

  2. Dodajte FCM na strežnik ADP:

    1. Uvozite datoteko JSON na strežnik ADP z ukazom /bw/install.

    2. Prijavite se v ADP CLI in dodajte projektni in API ključ:

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

    3. Nato dodajte aplikacijo in ključ:

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

    4. Preverite konfiguracijo:

      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
Ali je bil ta članek koristen?
Ali je bil ta članek koristen?