Cisco BroadWorks NPS'yi NPS Proxy'yi Kullanmak İçin Güncelleyin: Yapılandırma Kılavuzu

NPS Kimlik Doğrulama Proxy'sine Genel Bakış

Bu makalede, paylaşılan bir NPS'nin NPS kimlik doğrulama proxy'sini kullanmak üzere nasıl yapılandırılacağı açıklanmaktadır, böylece Webex uygulamalarına çağrı bildirimleri iletmek için de kullanılabilir. NPS'niz diğer uygulamaları desteklemiyorsa, Webex for BroadWorks Çözüm Kılavuzu'ndaki basitleştirilmiş yordamı uygulayabilirsiniz.

NPS Proxy'ye Genel Bakış

BroadWorks için Webex ile uyumluluk için, NPS'nizin UCaaS'de VoIP için P ush Sun ucusu olan NPS Proxy özelliğini destekleyecek şekilde yamalanması gerekir.

Bu özellik, anlık bildirim sertifikası özel anahtarlarını mobil istemciler için servis sağlayıcılarla paylaşmanın güvenlik açığını gidermek için Bildirim Push Sunucusunda yeni bir tasarım uygular. Anlık bildirim sertifikalarını ve anahtarlarını servis sağlayıcıyla paylaşmak yerine, NPS, UCaaS arka ucundan kısa ömürlü bir push bildirim belirteci elde etmek için yeni bir API kullanır ve bu belirteci Apple APN'leri ve Google FCM hizmetleriyle kimlik doğrulaması için kullanır.

Bu özellik ayrıca, Bildirim Push Sunucusunun yeni Google Firebase Cloud Messaging (FCM) HTTPv1 API aracılığıyla bildirimleri Android cihazlara iletme yeteneğini de geliştirir.

Daha fazla bilgi için UCaaS Özellik Açıklamas ındaki VoIP için Push Sunucusu bölümüne bakın.
Özellik için BroadWorks yamaları şu adreste mevcuttur: https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04.
ADP sunucusu hakkında daha fazla bilgi Cisco BroadWorks Application Delivery Platform adresinde bulunabilir.

NPS Kimlik Doğrulama Proxy Önkoşulları

NPS'yi barındıran XSP (veya Uygulama Dağıtım Platformu ADP) aşağıdaki gereksinimleri karşılamalıdır:

Minimum Sürümler ve Eş-İkamet Kısıtlamaları

NPS, özel bir XSP/ADP üzerinde etkinleştirilmeli ve NPS sunucuda barındırılan tek uygulama olmalıdır. Bu, Push bildirimlerinin teslimatındaki müdahaleyi ortadan kaldırmak içindir.
Bir dağıtımda yalnızca bir NPS uygulaması olmalıdır. Mobil UC-One Collaborate/Connect ve/veya UC-One SaaS kullanıyorsanız ve BroadWorks için Webex uyguluyorsanız, bu tek NPS'yi tüm uygulamalar için paylaşmanız gerekir.
NPS, R22 veya sonraki XSP veya ADP sürümünde olmalıdır.

R22/R23 XSP, XSP yalnızca NPS çalıştırıyorsa ve AS R21.SP1 ise bir R21 yığınıyla uyumludur. Daha fazla bilgi için BroadWorks Uyumluluk Matris ine bakın.
ADP sunucusu hakkında daha fazla bilgi Cisco BroadWorks Application Delivery Platform adresinde bulunabilir.

Paylaşılan NPS

Paylaşılan NPS'nizi NPS Proxy'yi kullanacak şekilde yapılandırmadan önce şu notları okuyun:

NPS'niz diğer uygulamalarla kullanılıyorsa (yalnızca Webex Uygulaması değil): Önce NPS proxy'sini yapılandır ın, ardından NPS'yi FCM eski API'yi kullanmaktan FCM HTTP v1 API'sini kullanmaya değiştirin.
NPS proxy'sine sahip eski uygulamalar için bildirimlerin düzgün çalıştığını doğruladıktan sonra Android uygulaması için FCM API anahtarını ve iOS uygulaması için APNs kimlik doğrulama anahtarını kaldırın.

APN'ler HTTP/2

Cisco/Broadsoft'tan olmayan iOS uygulamaları dağıttıysanız, NPS'yi NPS proxy'sini kullanacak şekilde yapılandırmadan önce bu uygulamaları HTTP/2 APNS protokolünü kullanacak şekilde yapılandırın.
Collaborate veya SaaS BroadWorks uygulamasını zaten destekleyen XSP/ADP'lerin HTTP/2'ye geçirilmesi gerekir. HTTP/2'yi yapılandırma hakkında ayrıntılı bilgi için bkz. APNS için Bildirim Push Sunucusuna HTTP/2 Desteği (bu iOS uygulamalarını desteklemek için NPS'nin taşınması bu makalede özetlenmiştir).

Android FCMv1

Cisco/Broadsoft'tan olmayan herhangi bir Android uygulaması dağıttıysanız, NPS'yi NPS proxy'sini kullanacak şekilde yapılandırmadan önce bu uygulamaları FCMv1 anahtarlarını kullanacak şekilde yapılandırın.
XSP/ADP şu anda Connect veya UC-One SaaS uygulamasını destekliyorsa, NPS proxy'sini yapılandırdıktan sonra FCMv1 anahtarlarını etkinleştirin. Tüm ek uygulamaları FCMv1 anahtarlarına geçirmenizi , etkinleştirmenizi ve test etmenizi, ardından kurulum talimatlarını tamamlamaya hazır ol ana kadar devre dışı bırakmanızı öneririz (geçiş akışı bu makalede belgelenmiştir).

NPS Proxy Geçiş Özeti

***NPS Kimlik Doğrulama Proxy'sine Geçişin Görsel Özeti***

Tablo 1. NPS Proxy'ye Geçilecek Görevlerin Özeti
Sıra	Görev Başlığı	Görev ne zaman/neden gereklidir?
1	UC-One SaaS (veya Connect) iOS uygulamaları için NPS'yi HTTP/2'ye taşıyın.	NPS bu uygulamaları destekliyorsa ve henüz HTTP/2 için yapılandırılmamışsa.
2	UC-One SaaS (veya Connect) Android uygulamaları için NPS'yi FCMv1'e taşıyın.	NPS bu uygulamaları destekliyorsa ve henüz FCMv1 için yapılandırılmamışsa.
3	FCMv1 modunu etkinleştirin ve push bildirimlerini test edin.	NPS, UC-One Connect ve/veya diğer (Cisco olmayan) Android uygulamalarını destekliyorsa.
4	FCM eski modunu yeniden etkinleştirin.	NPS UC-One SaaS destekliyorsa. FCMv1'i etkin bırakırsanız, NPS proxy'sini yapılandırmadan önce, UC-One SaaS'a push bildirimleri başarısız olmaya başlar.
5	NPS kimlik doğrulama proxy yamalarını yükleyin.	NPS, XSP R22 veya XSP R23 üzerindeyse.
6	NPS'yi NPS kimlik doğrulama proxy'sini kullanacak şekilde yapılandırın: NPS'den teknik destek ekleme CI OAuth hesabı isteyin NPS'de CI hesabı oluşturun ve yenileme belirteci zaman aşımını yapılandırın Android uygulama kimlikleri ekleyin İOS uygulama kimlikleri ekleyin URL'leri ve bağlantı zaman aşımlarını kontrol etme/ayarlama AS izin listesine uygulama ekleme (Yeniden) FCMv1'i Etkinleştir XSP/ADP'yi yeniden başlat İOS ve Android uygulamaları için PN'leri test edin	Her zaman gerekli.
7	FCM eski mod tuşlarını kaldırın.	FCMv1'de NPS tarafından başarıyla desteklenen uygulamalar için.

BroadWorks Collaborate iOS Uygulamalarını HTTP/2'ye Taşıma

Bu görev, iOS platformlarındaki UC-One SaaS ve Webex uygulamalarına push bildirimleri için zorunludur.

Başlamadan önce

XSP'nizde R22 çalışıyorsa, NPS uygulamasını APNS için HTTP/2 kullanacak şekilde yapılandırmadan önce ap354313'ü uygulamanız gerekir.

1	Üretim URL'sini ve bağlantı parametrelerini `X` SP_CLI/Applications/NotificationPushServer/APNS/Production> adresinde ayarlayın `url ayarla https://api.push.apple.com/3/device` `bağlantıyı ayarlayınHavuzBoyut 2` `ConnectionTimeout 3000 ayarla` `bağlantıyı ayarla IdleTimeoutInSeconds 600` Not: Bağlantı zaman aşımını 1000'in altına ayarlamayın.
2	Uygulama kimliklerini APNS uygulamaları bağlamına ekleyin, Kimlik Doğrulama anahtarını atladığınızdan emin olun - boş olarak ayarlayın. UC-One SaaS için: `X` SP_CLI/Uygulamalar/NotificationPushServer/APNS/Production/Tokens> com.broadsoft.uc-one ekleyin Webex uygulaması için: `xsp` _CLI/Applications/NotificationPushServer/APNS/Production/Tokens> com.cisco.squared ekle
3	`X` `SP_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> get ile kimlik doğrulama anahtarlarını kontrol edin`
4	`com.broadsoft.uc-one için kimlik doğrulama anahtarı boş değilse, xsp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> auth anahtarını temiz` `le ile temizleyebilirsiniz.`
5	HTTP/2'yi etkinleştir: `xsp_CLI` `/Uygulamalar/NotificationPushServer/APNS/GeneralSettings> http2enabled true olarak ayarla`
6	Yalnızca UC-One SaaS uygulamaları için: Bayi portalında oturum açın ve Yapılandırma > BroadWorks > böl ümüne gidin.
7	Bildirim Push Sunucusu bölümüne gidin ve sürümünüzü seçin (örn. Sürüm 22), ardından portalda verilen talimatları izleyin.

BroadWorks UC-One Connect/SaaS Android Uygulamalarını FCMv1'e Taşıyın

Bu görev, XSP'deki NPS için geçerlidir. NPS"niz ADP"deyse görmezden gelin.
UC-One Connect veya UC-One SaaS Android uygulamaları için FCMv1 bildirimlerine geçiş yapmak için bu yordamı kullanabilirsiniz.
UC-One veya Webex Android uygulamalarına push bildirimlerini doğrulamak için NPS proxy'sini kullanmak istiyorsanız FCMv1 kullanmanız gerekir.
Bu görev, NPS kimlik doğrulama proxy'sinin yapılandırmasının bir parçası olarak etkinleştirebilmeniz için NPS'yi FCMv1 için hazırlar. NPS kimlik doğrulama proxy'sini yapılandırmaya hazır olana kadar FCMv1'i etkinleştirmeyin, aksi takdirde SaaS istemcilerine yapılan bildirimler başarısız olur.

Firebase konsolundan proje kimliğini alın:

console.firebase.google.com adresinde oturum açın.
UC-One (Connect veya SaaS) uygulama projesini seçin, proje ayarlarını açın.
Genel sekmesini açın ve proje kimliğini kaydedin.

Hizmet hesabınızın özel anahtarını Firebase'den alın:

Proje ayarlarında Hizmet hesapları sekmesine gidin.
Ya yeni bir hizmet hesabı oluşturun ve özel anahtarını alın.
Veya mevcut bir hizmet hesabı açın ve bunun için yeni bir özel anahtar oluşturun.

Not: Hizmet hesabının firebasead min-sdk iznine sahip olması gerekir.
Anahtarı güvenli bir yere indirin.

Anahtarı NPS'nizi barındıran XSP'ye kopyalayın.

Proje kimliğini ve ilişkili özel anahtarı FCM projeleri bağlamına ekleyin:

xsp_CLI /Applications/NotificationPushServer/fcm/projeler> proje kimliği yolu/anahtar dosyasına ekle

UC-One (Connect veya SaaS) uygulamasını ve ilişkili proje kimliğini FCM uygulamaları bağlamına ekleyin:

xsp_CLI/Uygulamalar/NotificationPushServer/FCM/Uygulam alar> uygulama kimliği ekle com.broadsoft.connect ProjectID proje kimliği

Burada gösterilen özniteliklere ve önerilen değerlere göre FCM yapılandırmasını kontrol edin. Gerek irse değerleri değiştirmek için komutun set sürümünü kullanın:

Xsp _CLI/Applications/NotificationPushServer/FCM> get'i çalıştırın

Parametre	Tavsiye Edilen Değer
`AuthURL`	`https://www.googleapis.com/oauth2/v4/token`
`PushUrl`	`https://fcm.googleapis.com/v1/projects/ PROJE KIMLIĞI /mesajlar:gönder`
`kapsam`	`https://www.googleapis.com/auth/firebase.messaging`
`TokenTimeOliveSaniye cinsinden`	3600
`BağlantıHavuz Boyutu`	10
`Bağlantı Süresi Aşımı Milisaniye`	3000
`ConnectionIdleTimeOutinSeconds`	600

BroadWorks UC-One Connect/SaaS Android Uygulamalarını FCMv1'e taşıyın (ADP'de)

Bu görev ADP'deki NPS için geçerlidir. NPS'niz XSP üzerindeyse bunu görmezden gelin.
UC-One Connect veya UC-One SaaS Android uygulamaları için FCMv1 bildirimlerine geçiş yapmak için bu yordamı kullanabilirsiniz.
UC-One veya Webex Android uygulamalarına push bildirimlerini doğrulamak için NPS proxy'sini kullanmak istiyorsanız FCMv1 kullanmanız gerekir.
Bu görev, NPS kimlik doğrulama proxy'sinin yapılandırmasının bir parçası olarak etkinleştirebilmeniz için NPS'yi FCMv1 için hazırlar. NPS kimlik doğrulama proxy'sini yapılandırmaya hazır olana kadar FCMv1'i etkinleştirmeyin, aksi takdirde SaaS istemcilerine yapılan bildirimler başarısız olur.

1	Firebase konsolundan proje kimliğini alın: console.firebase.google.com adresinde oturum açın. UC-One (Connect veya SaaS) uygulama projesini seçin, proje ayarlarını açın. Genel sekmesini açın ve proje kimliğini kaydedin.
2	Hizmet hesabınızın özel anahtarını Firebase'den alın: Proje ayarlarında Hizmet hesapları sekmesine gidin. Ya yeni bir hizmet hesabı oluşturun ve özel anahtarını alın. Veya mevcut bir hizmet hesabı açın ve bunun için yeni bir özel anahtar oluşturun. Not: Hizmet hesabının firebasead min-sdk iznine sahip olması gerekir. Anahtarı (.json dosyası) güvenli bir konuma indirin.
3	`.json dosyasını /bw/install ADP sunucusuna aktarın.`
4	ADP CLI'ye giriş yapın ve proje ve API anahtarını FCM projeleri bağlamına ekleyin: `adp_cli/uygulamalar/notificationpushserver/fcm/projeler> connect-ucaas /bw/install/dosy adı.json ekle`
5	Uygulama ve proje kimliğini FCM uygulamaları bağlamına ekleyin: `adp_cli/Uygulamalar/NotificationPushServer/FCM/Uygulam alar> uygulama kimliği ekle com.broadsoft.ucaas.connect ProjectID proje kimliği`
6	Yapılandırmanızı doğrulayın: `ADP_CLI/Applications/NotificationPushServer/FCM/Projects> get Project ID Accountkey ======================== connect-ucaas ********` `ADP_CLI/Applications/NotificationPushServer/FCM/Applications> get Application ID Project ID =================================== com.broadsoft.ucaas.connect connect-ucaas`

FCM Eski Modunu yeniden etkinleştirin

Bunu yalnızca aşağıdaki durumlarda yapmanız gerekir (geçişin bir parçası olarak):

NPS'niz UC-One SaaS veya BroadWorks Connect Android uygulamaları için kullanılır.
Diğer uygulamalara yapılan anlık arama bildirimlerinin FCMv1 API ile çalıştığını zaten test ettiniz.

Bu uygulamalar için FCMv1 anahtarlarının yalnızca NPS kimlik doğrulaması proxy yapılandırma işlemi sırasında etkinleştirilmesi gerekti ğinden, FCMv1'i geçici olarak devre dışı bırakıyorsunuz.

1	Paylaşılan NPS'nizi barındıran XSP'de oturum açın.
2	FCM bağlamına gidin ve FCM v1'i devre dışı bırakın: `xsp_CLI/Applications/NotificationPushServer/fcm> FCM eski API anahtarını kullanmaya geri dönmek için v1enabled false ayarını yapın`.

NPS Kimlik Doğrulama Proxy Yamalarını Yükleme

NPS kimlik doğrulama proxy özelliğini desteklemek için aşağıdaki yamaları yükleyin:

R22 Yamaları

R23 Yamaları

Kimlik doğrulama proxy'sini kullanmak için NPS'yi yapılandırma

(Webex Ortak Kimliği) OAuth istemci hesabınızı sağlamak için katılım kişinizle veya TAC ile bir hizmet isteği oluşturun. Servis isteğinize Kimlik Doğrulama Proxy Kurulumu için NPS Yapılandırması başlığı verin.

Size bir OAuth istemci kimliği, bir istemci sırrı ve 60 gün geçerli bir yenileme belirteci veriyoruz. Belirteç, NPS'nizle kullanmadan önce sona ererse, başka bir istek gönderebilirsiniz.

NPS'de istemci hesabı oluşturun:

xsp_CLI/Uygulamalar/NotificationPushServer/Ciscoci/Cli ent> istemci-Adım1'den istemci kimliğini ayarla

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set clientSecret
New Password: client-Secret-From-Step1

XSP_CLI/Applications/NotificationPushServer/CiscoCI/Client> set RefreshToken
New Password: Refresh-Token-From-Step1

Girdiğiniz değerlerin size sağlananlarla eşleştiğini doğrulamak için komutu çalıştırın. xsp_CLI/Uygulamalar/NotificationPushServer/Ciscoci/Client> get

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

Bölge tabanlı FQDN'ler:

ABD Doğu:

xsp_CLI /Uygulamalar/NotificationPushServer/CloudNPSService> url ayarla https://broadworks-idp-proxy-a.wbx2.com/nps/

ABD Batı:

xsp_CLI /Uygulamalar/NotificationPushServer/CloudNPSService> url ayarla https://broadworks-idp-proxy-r.wbx2.com/nps/

Avrupa:

xsp_CLI /Uygulamalar/NotificationPushServer/CloudNPSService> url ayarla https://broadworks-idp-proxy-k.wbx2.com/nps/

xsp_CLI /Uygulamalar/NotificationPushServer/CloudNPSService> VoipTokenRefreshInterval 1800'ü ayarla

Suudi Arabistan:

xsp_CLI /Uygulamalar/NotificationPushServer/CloudNPSService> url ayarla https://broadworks-idp-proxy-d.wbx2.com/nps/

Avustralya:

xsp_CLI /Uygulamalar/NotificationPushServer/CloudNPSService> url ayarla https://broadworks-idp-proxy-m.wbx2.com/nps/

DNS çözümünde gecikme nedeniyle push bildirimleri zaman aşımına uğrarsa, BroadWorks sunucusundaki “/etc/resolv.conf” dosyasındaki zaman aşımı değerini artırın.

(Android bildirimleri için) Android uygulama kimliklerini NPS'deki FCM uygulamaları bağlamına ekleyin.

Android'de Webex Uygulaması için: XSP_CLI/Uygulamalar/NotificationPushServer/FCM/Uygulamalar> com.cisco.wx2. android ekle

Android'de UC-One Uygulaması için: X SP_CLI/Uygulamalar/NotificationPushServer/FCM/Uygulamalar> com.broadsoft.connect ekle

(Bil Apple iOS dirimler için) Uygulama kimliğini APNS uygulamaları bağlamına ekleyin, Kimlik Doğrulama anahtarını atladığınızdan emin olun - boş olarak ayarlayın.

İOS'ta Webex Uygulaması için: xsp _CLI/Applications/NotificationPushServer/APNS/Production/Tokens> com.cisco.squared ekle

İOS'ta UC-One uygulaması için: x sp_CLI/Applications/NotificationPushServer/APNS/Production/Tokens> com.cisco.squared ekle

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

XSP CLI bağlamı	Parametre	Değer
`xsp_CLI/Uygulamalar/BildirimPushServer/FCM>`	`AuthURL`	`https://www.googleapis.com/oauth2/v4/token`
	`PushUrl`	`https://fcm.googleapis.com/v1/projects//messages:send`
	`kapsam`	`https://www.googleapis.com/auth/firebase.messaging`
`xsp_CLI/Uygulamalar/BildirimPushServer/APNS/Üretim>`	`URL'si`	`https://api.push.apple.com/3/device`

Aşağıdaki NPS bağlantı parametrelerini gösterilen önerilen değerlere göre yapılandırın:

XSP CLI Bağlamı	Parametre	Değer
`xsp_CLI/Uygulamalar/BildirimPushServer/FCM>`	`TokenTimeOliveSaniye cinsinden`	3600
	`BağlantıHavuz Boyutu`	10
	`Bağlantı Süresi Aşımı Milisaniye`	3000
	`ConnectionIdleTimeOutinSeconds`	600
`xsp_CLI/Uygulamalar/BildirimPushServer/APNS/Üretim>`	`Bağlantı Zaman Aşımı`	3000
	`BağlantıHavuz Boyutu`	2
	`ConnectionIdleTimeOutinSeconds`	600

Uygulama Sunucusunun uygulama kimliklerini tarayıp taramadığını kontrol edin, çünkü Webex uygulamalarını izin listesine eklemeniz gerekebilir:

As_CLI/System/PushNotification> get komutunu çalıştırın ve enforceAllowedApplicationList değerini kontrol edin. Eğer doğruysa, bu alt görevi tamamlamanız gerekir. Aksi takdirde, alt görevin geri kalanını atlayın.
as_cli/System/Push Notification/AllowedApplications> com.cisco.wx2.android “Webex Android” ekleme
as_CLI/System/Push Notification/AllowedApplications> com.cisco.squared “Webex iOS” ekleme

NPS'yi Yeniden Başlat ve Anlık Bildirimleri Test Edin

1	XSP'yi yeniden başlatın: `bwyeniden başlat`
2	Bir BroadWorks abonesinden Android'deki arayan istemciye arama yaparak Android'e yapılan çağrı bildirimlerini test edin. Arama bildiriminin Android cihazda göründüğünü doğrulayın. Not: UC-One android uygulaması için push bildirimleri başarısız olmaya başlarsa, yanlış yapılandırma olabilir. Durumunuz buysa, eski FCM'ye aşağıdaki gibi geri dönebilirsiniz: `FCMv1'i devre dışı bırak: XSP _CLI/Applications/NotificationPushServer/FCM> V1Enabled false ayarla` `XSP'yi yeniden başlat: bwrestart` Yapılandırmanızı kontrol edin. FCMv1'i yeniden etkinleştirin ve XSP'yi yeniden başlatın. Testi tekrarlayın.
3	Bir BroadWorks abonesinden iOS'ta arayan istemciye arama yaparak iOS'a yapılan çağrı bildirimlerini test edin. Çağrı bildiriminin iOS cihazında göründüğünü doğrulayın. Not: UC-One iOS uygulaması için push bildirimleri başarısız olmaya başlarsa, yanlış yapılandırma olabilir. Durumunuz buysa, `http2enabled false ayarıyla eski ikili arayüze geri dönebilirsiniz`.

Cisco AI Assistant

Geri bildiriminiz için teşekkürler.