Webex BroadWorks için çağrı anında bildirimleri yapılandırın
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.
-
Daha fazla bilgi için UCaaS özellik açıklamasında VoIP için Push Server'abakın.
-
Bu özelliğe ilişkin BroadWorks yamaları şu adreste mevcuttur: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
NPS yazılımı ve yamaları için Cisco BroadWorks için Webex'e Yönelik NPS'nizi Hazırlamabölümüne bakın.
Yazılım indirme sayfasından yamayı arayın ve indirin.
-
ADP sunucusu hakkında daha fazla bilgi Cisco BroadWorks Uygulama Dağıtım Platformuadresinde bulunabilir.
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: XSP R22 yamaları: XSP R23 yamaları: |
| 3 |
Bildirim Sunucu uygulamasını etkinleştirin. |
| 4 |
(Android bildirimleri için) NPS'de FCM v1 API'sini etkinleştirin.
|
| 5 |
(Apple iOS bildirimleri için) NPS'de HTTP/2'yi etkinleştirin.
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, Ö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:
|
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:
Girdiğiniz değerlerin size verilenle eş olduğunu doğrulamak için çalıştırın 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:
| |||||||||||||||||||
| 3 |
NPS Proxy URL'sini girin ve belirteç yenileme aralığını ayarlayın (30 dakika önerilir):
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: ABD Batısı:
Avrupa:
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.
| |||||||||||||||||||
| 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.
| |||||||||||||||||||
| 6 |
Aşağıdaki NPS URL'lerini yapılandır:
| |||||||||||||||||||
| 7 |
Aşağıdaki NPS bağlantı parametrelerini, gösterilen önerilen değerlere yapılandırabilirsiniz:
| |||||||||||||||||||
| 8 |
Uygulama Sunucusu ile ilgili uygulama kimliklerinin doğru olup olduğunu kontrol edin; bunun nedeni, uygulama Webex izin listesine eklemenizin gerekir: | |||||||||||||||||||
| 9 |
XSP|ADP'yi yeniden başlatın: | |||||||||||||||||||
| 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 istemcilerini FCMv1'e taşıyın—Mevcut UCaaS istemcileriniz varsa ve bunları FCMv1'i kullanacak şekilde taşımanız gerektiğinde.
-
SaaS İstemcilerini FCMv1'e Taşıyın—Mevcut SaaS istemcileriniz varsa ve bunları FCMv1'i kullanacak şekilde taşımanız gerektiğinde.
-
ADP Sunucusunu Güncelle— NPS'yi bir ADP sunucusuna taşıdığınızda.
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. . 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
-
FCM Yöneticisi SDK'sını oturumu açma http://console.firebase.google.com.
-
Uygun Android uygulamasını seçin.
-
Genel sekmesinde proje kimliğini kaydetmek
-
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:
-
Yeni hizmet hesabı oluşturmak için mavi düğmeye tıklayın
-
Yeni bir özel anahtar oluşturmak için mavi düğmeye tıklayın
-
Anahtarı güvenli bir konuma indir
Mevcut bir hizmet hesabını yeniden kullanmak için:
-
Mevcut hizmet hesaplarını görüntülemek için mavi metne tıklayın.
-
Kullanmak için hizmet hesabını tanımlamak. Hizmet hesabı için izin firebaseadmin-sdkgerekiyor.
-
Çok sağda hamburger menüye tıklayın ve yeni bir özel anahtar oluşturun.
-
Anahtarı içeren json dosyasını indirin ve güvenli bir konuma kaydedin.
-
-
Json dosyasını XSP|ADP'ye kopyalayın.
-
Proje kimliğini yapılandır ve :
XSP|ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add -
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 -
FCMv1'i etkinleştir:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
XSP|ADP'yi yeniden başlatmak için
bwrestartkomutunu ç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.
-
FCM'yi devre dışı bırak:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled false ...Done -
XSP|ADP'yi yeniden başlatmak için
bwrestartkomutunu çalıştırın. -
FCM'yi etkinleştir:
XSP|ADP_CLI/Applications/NotificationPushServer/FCM> set V1Enabled true ...Done -
XSP|ADP'yi yeniden başlatmak için
bwrestartkomutunu ç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.
-
JSON dosyasını Google Bulut Konsolundan al:
-
Google Bulut Konsolunda, Hizmet Hesapları sayfasına gidin.
-
Bir proje seçin seçeneğinetıklayın, projenizi seçin ve Aç'a tıklayın.
-
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.
-
Anahtar türünü seçin ve Oluşturöğesine tıklayın
Dosya indirilir.
-
-
FCM'yi ADP sunucusuna ekle:
-
/bw/installkomutunu kullanarak JSON dosyasını ADP sunucusuna aktarın. -
ADP CLI'da oturum açma ve Project ve API anahtarı ekleyin:
ADP_CLI/Applications/NotificationPushServer/FCM/Projects> add connect /bw/install/google JSON: -
Ardından, Uygulama ve anahtarı ekleyin:
ADP_CLI/Applications/NotificationPushServer/FCM/Applications> add com.broadsoft.ucaas.connect projectId connect-ucaas...Done -
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
-