Hívás push értesítések konfigurálása a Webex BroadWorkshöz

list-menuVisszajelzés?
Ismerje meg, hogyan állíthat be híváspush értesítéseket a Webex for BroadWorks szolgáltatáshoz NPS használatával Android és iOS rendszeren.

Ebben a dokumentumban a Hívásértesítések leküldéses kiszolgálója (CNPS) kifejezést használjuk a környezetben futó XSP-ben vagy ADP-üzemeltetett alkalmazás leírására. A CNPS együttműködik a BroadWorks rendszerével, hogy tisztában legyen a felhasználókhoz érkező hívásokkal, és lekéri az értesítéseket a Google Firebase Cloud Messaging (FCM) vagy az Apple Push Notification service (APNs) értesítési szolgáltatásaiba.

Ezek a szolgáltatások értesítik a Webex mobil eszközeit a Cisco BroadWorks előfizetői számára, hogy bejövő hívásokat folytatnak a Webex-en.

A hálózati házirend-kiszolgálóval kapcsolatos további információkért tekintse meg az Értesítési leküldési kiszolgáló szolgáltatás leírását.

A Webex hasonló mechanizmusa együttműködik a Webex üzenetküldő és jelenléti szolgáltatásokkal, hogy értesítéseket küld a Google (FCM) vagy az Apple (APNS) értesítési szolgáltatásaihoz. Ezek a szolgáltatások viszont értesítik a mobil Webex felhasználókat a bejövő üzenetekről vagy a jelenlét változásairól.

Ez a szakasz leírja, hogyan konfigurálható a hálózati házirend-kiszolgáló (NPS) hitelesítési proxyhoz, ha az NPS még nem támogat más alkalmazásokat. Ha megosztott hálózati házirend-kiszolgálót kell migrálnia az NPS proxy használatára, tekintse meg a Cisco BroadWorks NPS frissítése NPS proxy használatáracímű részt.

Nps proxy – áttekintés

A Cisco BroadWorks Webex-szel való kompatibilitásához a CNPS-t javítani kell az NPS Proxy szolgáltatás, a Push Server for VoIP UCaaS támogatásához.

A funkció új tervet valósít meg az értesítési leküldéses kiszolgálón a leküldéses értesítési tanúsítvány privát kulcsainak a mobil ügyfelek szolgáltatóival való megosztásának biztonsági résének megoldására. Ahelyett, hogy a leküldéses értesítési tanúsítványokat és kulcsokat megosztaná a szolgáltatóval, az nps egy új API-t használ egy rövid életű leküldéses értesítési jogkivonat beszerzéséhez a Webex-től a Cisco BroadWorks háttérhez, és ezt a jogkivonatot használja az Apple APN-ekkel és a Google FCM szolgáltatásokkal való hitelesítéshez.

A funkció azt is javítja, hogy az értesítési leküldéses kiszolgáló az új Google Firebase Cloud Messaging (FCM) HTTPv1 API-n keresztül lekérje az értesítéseket androidos eszközökre.

APNS megfontolások

Az Apple 2021. március 31.-e után már nem támogatja a HTTP/1 alapú bináris protokollt az Apple Push Notification szolgáltatásban. Javasoljuk, hogy az XSP|ADP-t a következő használatára konfigurálja: HTTP/2-based APN-ekhez való interfész. A frissítéshez az NPS-t üzemeltető XSP|ADP-nek R22-es vagy újabb verziót kell futtatnia.

Készítse elő NPS-ét a Webex számára a Cisco BroadWorks számára

1

Telepítsen és konfiguráljon egy dedikált XSP-t (R22 minimális verzió) vagy alkalmazás-kézbesítési platformot (ADP).

2

Telepítse a hálózati házirend-kiszolgáló proxy javításait:

3

Aktiválja az Értesítési leküldéses kiszolgáló alkalmazást.

4

(Android-értesítésekhez) Engedélyezze az FCM v1 API-t a hálózati házirend-kiszolgálón.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Apple iOS-értesítésekhez) Engedélyezze a HTTP/2-t az NPS-en.

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

Ez kizárólag a 22-es és korábbi verziókban érhető el; a 23-as és újabb verziókban nem érhető el, amelyek csak a következőket támogatják: HTTP/2.

6

Csatoljon egy techsupportot az NPS XSP/ADP-ből.

7

Minden egyes AS-kiszolgálón a /usr/local/broadworks/bw_base/conf részben található namedefs fájlt konfigurálni kell az Értesítési Push kiszolgáló SRV és A rekordjaival. (XSP/ADP) keresés, ha több XSP/ADP majd szükség szerint adjon hozzá egy bejegyzést mindegyikhez.

Példa: _pushnotification-kliens._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com IN A 10.193.78.149

A beállítás után a változtatások végrehajtásához az alábbiak egyikére van szükség:

  1. Az újraindítás karbantartási időszakban történhet.

  2. A Cisco BroadWorks parancssori felületén keresztül:

    R24 és idősebb

    AS_CLI/ASDiagnostic/DNS> betöltés újra

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> betöltés újra

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> betöltés újra

Mi a következő teendő

NPS friss telepítéséhez látogasson el a NPS konfigurálása hitelesítési proxy használatáracímű részre.

Egy meglévő Android-környezet FCMv1-re való migrálásához látogasson el a NPS migrálása FCMv1-reoldalra.

NPS konfigurálása hitelesítési proxy használatára

Ez a feladat az NPS új telepítésére vonatkozik, amelyet a Cisco BroadWorks webexének szenteltek.

Ha egy olyan NPS-en szeretnéd konfigurálni a hitelesítési proxyt, amely más mobilalkalmazásokkal is meg van osztva, lásd : A Cisco BroadWorks NPS frissítése NPS proxy használatára.

1

OAuth hitelesítő adatok beszerzése a Webexhez a Cisco BroadWorks rendszerben.

2

Hozza létre az ügyfélfiókot a hálózati házirend-kiszolgálón:

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

Ha ellenőrizni szeretné, hogy a megadott értékek megegyeznek-e a megadott értékekkel, futtassa a XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

A CiscoCI issuerUrl értékének MINDIG US CI clusternek kell lennie, függetlenül a tartózkodási helyedtől, az alapértelmezett érték pedig a következő:

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

3

Adja meg a hálózati házirend-kiszolgáló proxy URL-címét, és állítsa be a jogkivonat frissítési időközét (30 perc ajánlott):

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

A DNS-feloldás sebességének növelése érdekében a jelenlegi FQDN (nps.uc-one.broadsoft.com) helyett azt javasoljuk, hogy a régiójának megfelelő FQDN-t használja.

Régió alapú FQDN-ek:

USA keleti régiója:

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

USA Nyugat:

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

Európa:

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

Ha a push értesítések időtúllépést jeleznek a DNS-feloldás késése miatt, növelje az időtúllépési értéket a "/etc/resolv.conf" fájl a BroadWorks szerveren.

4

(Android-értesítésekhez) Adja hozzá az Android-alkalmazásazonosítót az NPS FCM-alkalmazások környezetéhez.

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

5

(Apple iOS értesítések esetén) Adja hozzá az alkalmazásazonosítót az APNS-alkalmazások környezetéhez, és győződjön meg róla, hogy kihagyja az Auth kulcsot – állítsa üresre.

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

6

Konfigurálja a következő nps URL-címeket:

XSP|ADP CLI kontextus

Paraméter

Érték

  • 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

Konfigurálja a következő hálózati házirend-kiszolgáló kapcsolati paramétereket az ajánlott értékekre:

XSP|ADP CLI kontextus

Paraméter

Érték

  • 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

Ellenőrizze, hogy az Alkalmazáskiszolgáló szűri-e az alkalmazásazonosítókat, mert előfordulhat, hogy hozzá kell adnia a Webex alkalmazásokat az engedélyezési listához:

  1. Futtassa AS_CLI/System/PushNotification> get a [] parancsot , és ellenőrizze a enforceAllowedApplicationListértékét. Ha true, akkor ezt az alfeladatot kell elvégezned. Ellenkező esetben hagyja ki az alfeladat többi részét.

  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

Indítsa újra az XSP|ADP-t: bwrestart

10

Tesztelje a hívásértesítéseket úgy, hogy a BroadWorks előfizetője két Webex mobilfelhasználóhoz kezdeményez hívásokat. Ellenőrizze, hogy a hívásértesítés megjelenik-e iOS és Android eszközökön.

Nps áttelepítése AZ FCMv1-be

Ez a témakör olyan választható eljárásokat tartalmaz, amelyeket a Google FCM-konzolon akkor használhat, ha meglévő hálózati házirend-kiszolgálótelepítéssel rendelkezik, amelyet át kell telepítenie az FCMv1-re. Három eljárás létezik:

UC-One kliensek migrálása FCMv1-re

A Google FCM konzolban az alábbi lépéseket követve migrálhatja az UC-One klienseket Google FCM HTTPv1-re.

Ha a márkajelzést az ügyfélre alkalmazza, az ügyfélnek rendelkeznie kell a Feladó azonosítójával. Az FCM-konzolon tekintse meg a Project Settings > Cloud Messaging címűtémakört. A beállítás a Projekt hitelesítő adatai táblában jelenik meg.

Részletekért lásd a Connect Mobile Márkaépítési Útmutatót a 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?címen. Lásd a gcm_defaultSenderId paramétert, amely a Branding Kit, Resource mappában, a branding.xml fájlban található az alábbi szintaxissal:

xxxxxxxxxxxxx

  1. Jelentkezzen be az FCM Admin SDK-ba a http://console.firebase.google.com.

  2. Válassza ki a megfelelő Android alkalmazást.

  3. Az Általános lapon jegyezze fel a projektazonosítót

  4. A szolgáltatásfiók konfigurálásához keresse meg a szolgáltatásfiókok lapot. Létrehozhat új szolgáltatási fiókot, vagy konfigurálhat egy meglévőt.

    Új szolgáltatási fiók létrehozása:

    1. Kattintson a kék gombra új szolgáltatási fiók létrehozásához

    2. Kattintson a kék gombra egy új privát kulcs létrehozásához

    3. Kulcs letöltése biztonságos helyre

    Meglévő szolgáltatási fiók újrafelhasználása:

    1. Kattintson a kék szövegre a meglévő szolgáltatási fiókok megtekintéséhez.

    2. Határozza meg a használni használt szolgáltatási fiókot. A szervizfióknak engedélyre van szüksége firebaseadmin-sdk.

    3. A jobb oldalon kattintson a hamburger menüre, és hozzon létre egy új privát kulcsot.

    4. Töltse le a kulcsot tartalmazó json fájlt, és mentse biztonságos helyre.

  5. Másold a JSON fájlt az XSP|ADP-re.

  6. Konfigurálja a projekt azonosítóját és :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
  7. Az alkalmazás konfigurálása:

    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. FCMv1 engedélyezése:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. Futtassa a bwrestart parancsot az XSP|ADP újraindításához.

SaaS-ügyfelek áttelepítése az FCMv1-be

Ha SaaS-ügyfeleket szeretne áttelepíteni az FCMv1-be, használja az alábbi lépéseket a Google FCM Console-on.

Győződjön meg arról, hogy már befejezte a "Hálózati házirend-kiszolgáló konfigurálása hitelesítési proxy használatára" eljárást.

  1. FCM letiltása:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. Futtassa a bwrestart parancsot az XSP|ADP újraindításához.

  3. FCM engedélyezése:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. Futtassa a bwrestart parancsot az XSP|ADP újraindításához.

ADP-kiszolgáló frissítése

Használja a Google FCM Konzol alábbi lépéseit, ha a hálózati házirend-kiszolgálót ADP-kiszolgáló használatára migrálja.

  1. A JSON fájl bekérés a Google Cloud Console-ról:

    1. A Google Cloud Console-on lépjen a Szolgáltatási fiókok oldalra.

    2. Kattintson a Projekt kijelöléseelemre, válassza ki a projektet, majd kattintson a Megnyitás parancsra.

    3. Keresse meg a szolgáltatásfiók sorát, amelyhez kulcsot szeretne létrehozni, kattintson a Továbbiak függőleges gombra, majd a Kulcs létrehozásagombra.

    4. Válasszon egy Kulcs típust, majd kattintson a Létrehozásgombra

      A fájl letöltődik.

  2. FCM hozzáadása az ADP-kiszolgálóhoz:

    1. Importálja a JSON fájlt az ADP-kiszolgálóra a /bw/install parancs használatával.

    2. Jelentkezzen be az ADP CLI-be, és adjon hozzá Projekt- és API-kulcsot:

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

    3. Ezután adja hozzá az alkalmazást és a kulcsot:

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

    4. Ellenőrizze a konfigurációt:

      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
Hasznos volt ez a cikk?
Hasznos volt ez a cikk?