Webex BroadWorks için çağrı anında bildirimleri yapılandırın

list-menuGeri Bildirim?
Android ve iOS için NPS'yi kullanarak Webex for BroadWorks için çağrı anında bildirimlerinin nasıl ayarlanacağını öğrenin.

Bu belgede, ortamınız üzerinde çalışan XSP tarafından barındırılan veya ADP tarafından barındırılan uygulamayı tanımlamak için Çağrı Bildirimleri Push Server (CNPS) terimini kullanıruz. CNPS'niz, kullanıcılarınıza gelen çağrılardan haberdar olmak için BroadWorks sisteminiz ile çalışır ve bu çağrılardan Google Firebase Cloud Messaging (FCM) veya Apple Anlık Bildirim hizmeti (APN'ler) bildirim hizmetleriyle bildirimlerini iletir.

Bu hizmetler, Cisco BroadWorks aboneleri için Webex telefon cihazlarının mobil cihazlarını, telefon üzerinden gelen çağrılara sahip Webex.

NPS hakkında daha fazla bilgi için Bildirim Sunucu Özelliği Açıklaması 'nebakın.

Google (FCM) Webex Apple (APNS) bildirim hizmetleriyle anlık bildirimler Webex iletişim durumu hizmetleriyle çalışan bir mekanizma da benzer bir mekanizmadır. Bu hizmetler, mobil cihaz kullanıcılarını Webex gelen mesajlar veya iletişim durumu değişiklikleri hakkında bilgilendirin.

Bu bölümde, NPS'nin diğer uygulamaları desteklemediği durumlarda kimlik doğrulama proxy'si için NPS'nin nasıl yapılandırılacağı açıklanmaktadır. Paylaşılan bir NPS'yi NPS proxy'sini kullanacak şekilde taşımanız gerekiyorsa, Cisco BroadWorks NPS'yi NPS Proxy'sini Kullanacak Şekilde Güncellemekonusuna bakın.

NPS Proxy'ye Genel Bakış

Cisco BroadWorks Webex uyumluluk için CNPS'nizin UCaaS'te NpS Proxy özelliği olan Push Server'VoIP desteklemek için yamanızgerekir.

Bu özellik, mobil istemciler için hizmet sağlayıcılarıyla push bildirim sertifikası özel anahtarları paylaşma güvenlik açığını çözmek için Bildirim Push Server'a yeni bir tasarım benimser. Hizmet sağlayıcısı ile push bildirim sertifikalarını ve anahtarlarını paylaşmak yerine, NPS Cisco BroadWorks arka ucu için Webex'dan kısa-kısa bildirim bildirim belirteci almak için yeni bir API kullanır ve Apple APN'leri ve Google FCM hizmetleriyle kimlik doğrulaması için bu jetonu kullanır.

Bu özellik ayrıca yeni Google Firebase Cloud Messaging (FCM) HTTPv1 API'si aracılığıyla Android cihazlarına bildirimler için Bildirim Anlık Sunucusu özelliğini de geliştirmektedir.

APN'ler için Dikkate Alınması Gerekenler

Apple, 31 Mart 2021'den sonra Apple Push Notification hizmeti üzerinde HTTP/1 tabanlı ikili protokole artık destek olmayacaktır. XSP|ADP'nizi aşağıdaki şekilde yapılandırmanızı öneririz: HTTP/2-based APN'ler için arayüz. Bu güncelleme, NPS'yi barındıran XSP|ADP'nizin R22 veya üzerini çalıştırmasını gerektirir.

Cisco BroadWorks için Webex NPS'nizi Hazırlama

1

Özel bir XSP (minimum sürüm R22) veya Uygulama Teslimat Platformu'na (ADP) yükleyin ve yapılandırın.

2

NPS Kimlik Doğrulaması Proxy yamalarını yükleyin:

3

Bildirim Sunucu uygulamasını etkinleştirin.

4

(Android bildirimleri için) NPS'de FCM v1 API'sini etkinleştirin.

XSP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true

5

(Apple iOS bildirimleri için) NPS'de HTTP/2'yi etkinleştirin.

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

Bu, yalnızca Sürüm 22 ve önceki sürümler için geçerlidir; yalnızca Sürüm 23 ve üzeri sürümlerde mevcut değildir; bunlar yalnızca HTTP/2.

6

NPS XSP/ADP'den bir teknik destek iliştirin.

7

Her AS sunucusunda, /usr/local/broadworks/bw_base/conf içindeki namedefs dosyası, Bildirim İtme Sunucusu için SRV ve A kayıtlarıyla yapılandırılmalıdır (XSP/ADP) birden fazlaysa ara XSP/ADP daha sonra her biri için gerektiği gibi bir giriş ekleyin.

Örnek: _pushnotification-client._tcp.qaxsps.broadsoft.com SRV 20 20 443 qa149.vle.broadsoft.com qa149.vle.broadsoft.com 10.193.78.149'DA

Ayarlandıktan sonra, değişikliklerin alınması için aşağıdakilerden biri gereklidir:

  1. Bakım penceresinde yeniden başlatma işlemi gerçekleştirilebilir.

  2. Cisco BroadWorks CLI aracılığıyla:

    R24 ve üzeri

    AS_CLI/ASDiagnostic/DNS> yeniden yükle

    R25 +

    AS_CLI/ASDiagnostic/DNS/ExecutionServer> yeniden yükle

    AS_CLI/ASDiagnostic/DNS/ProvisioningServer> yeniden yükle

Sonraki işlemler

NPS'nin yeni kurulumları için NPS'yi kimlik doğrulama proxy'sini kullanacak şekilde yapılandırmabölümüne gidin

Mevcut bir Android dağıtımını FCMv1'e geçirmek için NPS'yi FCMv1'e Geçirbölümüne gidin

NPS'yi kimlik doğrulama proxy'sini kullanacak şekilde yapılandırın

Bu görev, Cisco BroadWorks için Webex NPS'nin yeni yüklemesi için geçerlidir.

Diğer mobil uygulamalarla paylaşılan bir NPS'de kimlik doğrulama proxy'sini yapılandırmak istiyorsanız, Cisco BroadWorks NPS'yi NPS Proxy'sini Kullanacak Şekilde Güncellemebölümüne bakın.

1

Cisco BroadWorks için Webex'iniz için OAuth kimlik bilgilerinin alınması.

2

NPS üzerinde istemci hesabını oluşturun:

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

Girdiğiniz değerlerin size verilenle eş olduğunu doğrulamak için çalıştırın XSP|ADP_CLI/Applications/NotificationPushServer/CiscoCI/Client> get

CiscoCI issuerUrl'si konumunuzdan bağımsız olarak HER ZAMAN US CI kümesi olmalı ve varsayılan değer şu şekilde olmalıdır:

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

3

NPS Proxy URL'sini girin ve belirteç yenileme aralığını ayarlayın (30 dakika önerilir):

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

DNS çözümleme hızını artırmak için mevcut FQDN nps.uc-one.broadsoft.com yerine bölgenize uygun FQDN'yi kullanmanızı öneririz.

Bölge tabanlı FQDN'ler:

ABD Doğu:

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

ABD Batısı:

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

Avrupa:

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

XSP_CLI/Applications/NotificationPushServer/CloudNPSService> set VOIPTokenRefreshInterval 1800

DNS çözümlemesindeki gecikme nedeniyle anında bildirimler zaman aşımına uğrarsa, zaman aşımı değerini artırın "/etc/resolv.conf" BroadWorks sunucusundaki dosya.

4

(Android bildirimleri için) NPS'de FCM uygulamaları bağlamına Android uygulama kimliğini ekleyin.

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

5

(Apple iOS bildirimleri için) Uygulama kimliğini APNS uygulamaları bağlamına ekleyin, bu da Auth anahtarını atla - boş olarak ayarlayın.

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

6

Aşağıdaki NPS URL'lerini yapılandır:

XSP|ADP CLI Bağlamı

Parametre

Değer

  • 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

Aşağıdaki NPS bağlantı parametrelerini, gösterilen önerilen değerlere yapılandırabilirsiniz:

XSP|ADP CLI Bağlamı

Parametre

Değer

  • 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

Uygulama Sunucusu ile ilgili uygulama kimliklerinin doğru olup olduğunu kontrol edin; bunun nedeni, uygulama Webex izin listesine eklemenizin gerekir:

  1. AS_CLI/System/PushNotification> get [ ]'yi çalıştırın ve enforceAllowedApplicationListdeğerini kontrol edin. Eğer trueise, bu alt görevi tamamlamanız gerekmektedir. Aksi takdirde, alt görevin geri kalanını atla.

  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'yi yeniden başlatın: bwrestart

10

BroadWorks abonelerinden iki kullanıcıya veya mobil kullanıcıya çağrı yapan Webex test çağrısı bildirimleri. Çağrı bildiriminin iOS ve Android cihazlarda göründüğünü doğrulayın.

NPS'yi FCMv1'e Geçir

Bu konu başlığı, FCMv1'e taşımanız gereken mevcut bir NPS dağıtımınız olduğunda Google FCM Konsolu'nda kullanabileceğiniz isteğe bağlı prosedürleri içerir. Üç prosedür vardır:

UC-One İstemcilerini FCMv1'e Taşıyın

UC-One istemcilerini Google FCM HTTPv1'e geçirmek için Google FCM Konsolu'ndaki aşağıdaki adımları kullanın.

Markalama istemciye uygulanırsa istemcinin Gönderen Kimliğine sahip olması gerekir. FCM Konsolunda, bkz. Proje Ayarları > Mesajlaşma . Ayar, Proje kimlik bilgileri tablosunda görünür.

Ayrıntılar için [] adresindeki Connect Mobile Branding Guidehttps://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?]' a bakın. Aşağıdaki sözdizimini kullanarak Branding Kit, Kaynak klasörü, branding.xml dosyasında bulunan gcm_defaultSenderId parametresine başvurun:

xxxxxxxxxxxxx

  1. FCM Yöneticisi SDK'sını oturumu açma http://console.firebase.google.com.

  2. Uygun Android uygulamasını seçin.

  3. Genel sekmesinde proje kimliğini kaydetmek

  4. Hizmet hesabı yapılandırmak için hizmet hesapları sekmesine gidin. Yeni bir hizmet hesabı oluşturabilir veya mevcut bir hesabı yapılandırabilirsiniz.

    Yeni bir Hizmet Hesabı oluşturmak için:

    1. Yeni hizmet hesabı oluşturmak için mavi düğmeye tıklayın

    2. Yeni bir özel anahtar oluşturmak için mavi düğmeye tıklayın

    3. Anahtarı güvenli bir konuma indir

    Mevcut bir hizmet hesabını yeniden kullanmak için:

    1. Mevcut hizmet hesaplarını görüntülemek için mavi metne tıklayın.

    2. Kullanmak için hizmet hesabını tanımlamak. Hizmet hesabı için izin firebaseadmin-sdkgerekiyor.

    3. Çok sağda hamburger menüye tıklayın ve yeni bir özel anahtar oluşturun.

    4. Anahtarı içeren json dosyasını indirin ve güvenli bir konuma kaydedin.

  5. Json dosyasını XSP|ADP'ye kopyalayın.

  6. Proje kimliğini yapılandır ve :

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add  
  7. Uygulamayı yapılandırma:

    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'i etkinleştir:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  9. XSP|ADP'yi yeniden başlatmak için bwrestart komutunu çalıştırın.

SaaS İstemcilerini FCMv1'e Geçir

SaaS istemcilerini FCMv1'e geçirmek için Google FCM Konsolunda aşağıdaki adımları kullanın.

"Kimlik Doğrulaması Proxy'sını Kullanmak için NPS'yi Yapılandırma" prosedürlerini zaten tamamladık emin olun.

  1. FCM'yi devre dışı bırak:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false
    ...Done
  2. XSP|ADP'yi yeniden başlatmak için bwrestart komutunu çalıştırın.

  3. FCM'yi etkinleştir:

    XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true
    ...Done
  4. XSP|ADP'yi yeniden başlatmak için bwrestart komutunu çalıştırın.

ADP Sunucusunu Güncelle

NPS'yi bir ADP sunucusu kullanmak üzere kullanıyorsanız Google FCM Konsolu'nu aşağıdaki adımları kullanın.

  1. JSON dosyasını Google Bulut Konsolundan al:

    1. Google Bulut Konsolunda, Hizmet Hesapları sayfasına gidin.

    2. Bir proje seçin seçeneğinetıklayın, projenizi seçin ve Aç'a tıklayın.

    3. Anahtar oluşturmak istediğiniz hizmet hesabının satırını bulun, Daha Fazla dikey düğmesine tıklayın ve ardından Anahtar Oluşturöğesine tıklayın.

    4. Anahtar türünü seçin ve Oluşturöğesine tıklayın

      Dosya indirilir.

  2. FCM'yi ADP sunucusuna ekle:

    1. /bw/install komutunu kullanarak JSON dosyasını ADP sunucusuna aktarın.

    2. ADP CLI'da oturum açma ve Project ve API anahtarı ekleyin:

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

    3. Ardından, Uygulama ve anahtarı ekleyin:

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

    4. Yapılandırmayı doğrulayın:

      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
Bu makale yararlı oldu mu?
Bu makale yararlı oldu mu?