Ortak İkamet Gereksinimleri

• Kimlik Doğrulama Hizmeti, Xsi uygulamalarıyla birlikte yerleşik olmalıdır, çünkü bu arabirimlerin hizmet yetkilendirmesi için uzun ömürlü belirteçleri kabul etmesi gerekir. Bu belirteçleri doğrulamak için kimlik doğrulama hizmeti gereklidir.

• Kimlik doğrulama hizmeti ve Xsi gerekirse aynı bağlantı noktasında çalışabilir.

• Diğer hizmetleri/uygulamaları teraziniz için gerektiği gibi ayırabilirsiniz (örneğin, özel cihaz yönetimi XSP|ADP grubu).

• Xsi, CTI, Kimlik Doğrulama Hizmeti ve DMS uygulamalarını birlikte yerleştirebilirsiniz.

• XSP|ADP'lere BroadWorks'ü Webex ile entegre etmek için kullanılan diğer uygulamaları veya hizmetleri yüklemeyin.

• NPS uygulamasını diğer uygulamalarla birlikte yerleştirmeyin.

Xsi Arayüzleri

Xsi-Actions ve Xsi-Events uygulamalarını Cisco BroadWorks Xtended Services Interface Configuration Guide (Cisco BroadWorks X tended Services Interface Configuration Guide) bölümünde açıklandığı gibi yükleyin ve yapılandırın.

CTI arabirimi için kullanılan XSP|ADP üzerinde Xsi-Events uygulamalarının yalnızca bir örneği dağıtılmalıdır.

Broadworks'ü Webex ile entegre etmek için kullanılan tüm Xsi-Events, Applications/XSI-Events/GeneralSettings altında tanımlanan aynı CallControlApplicationName öğesine sahip olmalıdır. Örneğin:

adp_cli/Uygulamalar/XSI-Events/GeneralSettings> get

CallControlApplicationName = com.broadsoft.xsi-events

Bir kullanıcı Webex'e katıldığında, Webex, varlık ve arama geçmişi için telefon olaylarını almak için AS üzerindeki kullanıcı için bir abonelik oluşturur. Abonelik, CallControlApplicationName ile ilişkilendirilir ve AS, telefon olaylarını hangi Xsi-Events'e göndereceğini bilmek için kullanır.

Kimlik Doğrulama Hizmetini Yapılandırma (CI Token Doğrulaması ile)

Kimlik Doğrulama Hizmetini TLS ile CI Token Doğrulaması kullanacak şekilde yapılandırmak için bu yordamı kullanın. Bu kimlik doğrulama yöntemi, R22 veya daha yüksek bir sürümü kullanıyorsanız ve sisteminiz bunu destekliyorsa önerilir.

1. Cisco BroadWorks için Webex için OAuth kimlik bilgilerini alma.

2. Aşağıdaki yamaları her XSP|ADP sunucusuna yükleyin. Sürümünü ze uygun yamaları yükleyin:

   • R22 için:

     AP.Platform.22.0.1123.AP376508

     AP.XSP.22.0.1123.AP376508

     AP.XSP.22.0.1123.AP368601

   • R23 için:

     AP.XSP.23.0.1075.AP376509

     AP.Platform.23.0.1075.AP376509

   • R24 için - yama gerekmez

   XSP'ye yapılan herhangi bir referans XSP veya ADP'yi içerir.

3. Her XSP| ADP hizmetine AuthenticationService uygulamasını yükleyin.

   1. XSP|ADP üzerindeki AuthenticationService uygulamasını /AuthService bağlam yoluna etkinleştirmek için aşağıdaki komutu çalıştırın.

      xsp|adp_cli/Maintenance/ManagedObjects> uygulama AuthenticationService 22.0_1.1123/AuthService'i etkinleştir

   2. AuthenticationService'i XSP|ADP üzerinde dağıtmak için şu komutu çalıştırın:

      xsp|ADP_CLI/Maintenance/ManagedObjects> /AuthServiceBroadworks SW Yöneticisi/AuthService... dağıtma uygulaması/AuthService...

4. Broadworks build 2022.10'dan başlayarak, Java'nın yeni bir sürümüne geçerken Java ile birlikte gelen sertifika yetkilileri artık otomatik olarak BroadWorks güven deposuna dahil edilmez. AuthenticationService, erişim belirtecini almak için Webex'e bir TLS bağlantısı açar ve IDBroker ve Webex URL'sini doğrulamak için güven deposunda aşağıdakilere sahip olması gerekir:

   • IdenTrust Ticari Kök CA 1

   • Go Daddy Root Certificate Authority - G2

   Bu sertifikaların aşağıdaki CLI altında bulunduğunu doğrulayın

   adp_cli/system/SSLCommonSettings/Trusts/Varsayılanlar> al

   Varsayılan Java güvenlerini içe aktarmak için aşağıdaki komutu çalıştırın:

   ADP_CLI/System/SSLCommonSettings/Trusts/Varsayılanlar> JavaCatTrust içeri aktarma

   Alternatif olarak, aşağıdaki komutla bu sertifikaları güven bağlantıları olarak manuel olarak ekleyebilirsiniz:

   ADP_CLI/System/SSLCommonSettings/Trusts/Broadworks> UpdateTrust <alias><trustAnchorFile>

   ADP önceki sürümden yükseltilmişse, eski sürümdeki sertifika yetkilileri otomatik olarak yeni sürüme aktarılır ve manuel olarak kaldırılıncaya kadar içe aktarılmaya devam eder.

   AuthenticationService uygulaması, ADP_CLI/System/SSLCommonSettings/GeneralSettings altındaki ValidatePeerIdentity ayarından muaftır ve her zaman eş Kimliği doğrular. Bu ayar hakkında daha fazla bilgi için Cisco Broadworks X509 Sertifika Doğrul ama FD'sine bakın.

5. Her XSP|ADP sunucusunda aşağıdaki komutları çalıştırarak Kimlik Sağlayıcılarını yapılandırın:

   xsp|ADP_CLI/Uygulamalar/Kimlik Doğrulaması/Kimlik Sağlayıcıları/Cisco> al

   • Adım1'den ClientID istemci kimliğini ayarla

   • etkinleştirildi true olarak ayarla

   • ClientSecret Client-Secret-Step1'den ayarla

   • ciResponseBodyMaxSizeInbytes 65536'yı ayarlayın

   • düzenleyiciAdı ayarla <URL>— URL için CI Kümeniz için geçerli olan VerisherName URL'sini girin. Aşağıdaki tabloya bakın.

   • IssuerURL'yi ayar <URL>la — URL için CI Kümeniz için geçerli olan IssuerURL'yi girin. Aşağıdaki tabloya bakın.

   • set tokenInFourl —Teams <IdPProxy URL>Kümeniz için geçerli olan IdP Proxy URL'sini girin. Aşağıdaki ikinci tabloya bakın.

   Tablo 1. IssuerName ve IssuerURL'yi ayarlayın

   CI Kümesi ise...	IssuerName ve IssuerUrl olarak ayarlayın...
   US-A	https://idbroker.webex.com/idb
   EU	https://idbroker-eu.webex.com/idb
   US-B	https://idbroker-b-us.webex.com/idb
   CI Kümenizi bilmiyorsanız, bilgileri Control Hub'ın Yardım Masası görünümündeki Müşteri ayrıntılarından edinebilirsiniz.

   Tablo 2. TokenInFourl Ayarla

   Takımlar Kümesi ise...	TokenInFourl'u ayarla... (IdP Proxy URL'si)
   ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   Ekipler Kümenizi bilmi yorsanız, bilgileri Control Hub'ın Yardım Masası görünümündeki Müşteri ayrıntılarından edinebilirsiniz. Test için, URL'nin "idp/authenticate" bölümünü "ping" ile değiştirerek tokenInfoURL'nin geçerli olduğunu doğrulayabilirsiniz.

6. Aşağıdaki komutu çalıştırarak Webex'teki kullanıcı profilinde bulunması gereken Webex yetkisini belirtin:

   XSP|AD P_CLI/Uygulamalar/Kimlik Doğrulaması/Kimlik Sağlayıcıları/Cisco/Kapsamlar> kapsamı ayarla geniş iş bağlantısı:kullanıcı

7. Her XSP|ADP sunucusunda aşağıdaki komutları kullanarak Cisco Federasyon Kimlik Sağlayıcılarını yapılandırın:

   xsp|ADP_CLI/Uygulamalar/Kimlik Doğrulaması/Kimlik Sağlayıcıları/Cisco/Federation> al

   • FLsUrl https://cifls.webex.com/federation ayarlayın

   • RefreshPeriodinMinutes 60 olarak ayarlayın

   • RefreshToken RefreshToken Refresh-token'ı adım1'den ayarlayın

8. FLS yapılandırmanızın çalıştığını doğrulamak için aşağıdaki komutu çalıştırın. Bu komut Kimlik Sağlayıcılarının listesini döndürür:

   xsp|ADP_CLI/Uygulamalar/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Al

9. Her XSP| ADP sunucusunda aşağıdaki komutları kullanarak Token Yönetimini yapılandırın:

   • XSP|ADP_CLI/Uygulamalar/Kimlik DoğrulamaHizmeti/Token Yönetimi>

   • TokenIssuer BroadWorks kümesi

   • TokenDurationHours 720 olarak ayarla

10. RSA Anahtarları Oluşturun ve Paylaşın. Anahtarları bir XSP|ADP'de oluşturmalı ve ardından diğer tüm XSP|ADP'lere kopyal amalısınız. Bu, aşağıdaki faktörlerden kaynaklanmaktadır:

    • Kimlik doğrulama hizmetinin tüm örneklerinde belirteç şifreleme/şifre çözme için aynı genel/özel anahtar çiftlerini kullanmanız gerekir.

    • Anahtar çifti, kimlik doğrulama hizmeti tarafından ilk kez bir belirteç çıkarılması gerektiğinde oluşturulur.

    Anahtarları döngülerseniz veya anahtar uzunluğunu değiştirirseniz, aşağıdaki yapılandırmayı tekrarlamanız ve tüm XSP|ADP'leri yeniden başlatmanız gerekir.

    1. Anahtar çifti oluşturmak için kullanılacak bir XSP|ADP seçin.

    2. İstemcinin tarayıcısından aşağıdaki URL'yi isteyerek XSP|ADP'den şifrelenmiş bir belirteç istemek için bir istemci kullanın:

       https://<XSP|ADP-IPAddress>/authService/token? anahtar=base64 URL (ClientPublicKey)

       (Bu, XSP|ADP'de bir özel/genel anahtar çifti oluşturur, eğer zaten bir tane yoksa)

    3. Anahtar mağaza konumu yapılandırılamaz. Anahtarları dışa aktarın:

       XSP|ADP_CLI/Uygulamalar/Kimlik Doğrulama/Anahtar Yönetimi> Anahtarları dış a Aktarma

    4. Dışa aktarılan /var/Broadworks/tmp/AuthService.keys dosyasını diğer XSP|ADPS üzerindeki aynı konuma kopyalayın, gerekirse eski bir .keys dosyasının üzerine yazın.

    5. Diğer XSP|ADP'lerin her birindeki anahtarları içe aktarın:

       xsp| ADP_CLI/Uygulamalar/Kimlik Doğrulama/Anahtar Yönetimi> ImportKeys /var/Broadworks/TMP/AuthService.keys

11. Web kabına AuthService URL'sini sağlayın. XSP|ADP'nin web kapsayıcısı, belirteçleri doğrulayabilmesi için AuthService URL'sine ihtiyaç duyar. XSP|ADP'lerin her birinde:

    1. Kimlik doğrulama hizmeti URL'sini BroadWorks Communications Utility için harici bir kimlik doğrulama hizmeti olarak ekleyin:

       xsp|ad p_cli/sistem/iletişim yardımcı programı/varsayılan ayarlar/ExternalAuthentication/AuthService> url ayarla http://127.0.0.1:80/authService

    2. Kimlik doğrulama hizmeti URL'sini kapsayıcıya ekleyin:

       xsp|adp _cli/bakım/ContainerOptions> tomcat ekleme bw.authService.AuthServiceUrl http://127.0.0.1:80/authService

       Bu, Webex'in kimlik bilgileri olarak sunulan belirteçleri doğrulamak için Kimlik Doğrulama Hizmetini kullanmasını sağlar.

    3. Parametreyi get ile kontrol edin.

    4. XSP|ADP'yi yeniden başlatın.

Kimlik Doğrulama Hizmeti için İstemci Kimlik Doğrulama Gereksinimini Kaldır (yalnızca R24)

Kimlik Doğrulama Hizmeti, R24'te CI Token doğrulaması ile yapılandırıldıysa, Kimlik Doğrulama Hizmeti için İstemci Kimlik Doğrulama Gereksinimini de kaldırmanız gerekir. Aşağıdaki CLI komutunu çalıştırın:

adp_cli/arayüz/http/sslCommonSettings/ClientAuthentication/WebApps> kimlik doğrulamasıService ClientAuthReq yanlış ayarla <interfaceIp><port>

HTTP Ara yüzlerinde TLS ve Şifreleri Yapılandırma (XSI ve Kimlik Doğrulama Hizmeti için)

Kimlik Doğrulama Hizmeti, Xsi-Eylemleri ve Xsi-Events uygulamaları HTTP sunucu arabirimlerini kullanır. Bu uygulamalar için TLS yapılandırılabilirlik seviyeleri aşağıdaki gibidir:

En genel = Sistem > Taşıma > HTTP > HTTP Sunucu arayüzü = En spesifik

Farklı SSL ayarlarını görüntülemek veya değiştirmek için kullandığınız CLI bağlamları şunlardır:

XSP|ADP'de HTTP Sunucusu TLS Arayüzü Yapılandırmasını Okuma

1. XSP|ADP'de oturum açın ve XSP|ADP_CLI/Interface/HTTP/HTTPServer> adresine gidin

2. get komutunu girin ve sonuçları okuyun. Arayüzleri (IP adresleri) ve her biri için güvenli olup olmadıklarını ve istemci kimlik doğrulaması gerek tirip gerektirmediklerini gör melisiniz.

Apache tomcat, her güvenli arayüz için bir sertifika zorunlu kılar; sistem gerektiğinde kendi kendini imzalayan bir sertifika oluşturur.

XSP|ADP_CLI/Interface/Http/HttpServer> get

HTTP Sunucu Arayüzüne TLS 1.2 Protokolü Ekleme

Webex Cloud ile etkileşime giren HTTP arabirimi TLSv1.2 için yapılandır ılmalıdır. Bulut, TLS protokolünün önceki sürümlerini müzakere etmez.

HTTP Sunucusu arabiriminde TLSv1.2 protokolünü yapılandırmak için:

1. XSP|ADP'de oturum açın ve XSP|ADP_CLI/Interface/HTTP/HTTP/HTTPServer/SSLSettings/Protocols> adresine gidin

2. <interfaceIp>Bu arayüzde hangi protokollerin zaten kullanıldığını görmek için get 443 komutunu girin.

3. <interfaceIp>Arayüzün bul utla iletişim kurarken TLS 1.2'yi kullanabilmesini sağlamak için add 443 TLSv1.2 komutunu girin.

HTTP Sunucu Arabiriminde TLS Şifreleri Yapılandırmasını Düzenleme

Ger ekli şifreleri yapılandırmak için:

1. XSP|ADP'de oturum açın ve XSP|ADP_CLI/Interface/HTTP/HTTP/HTTPServer/SSLSettings/Ciphers> adresine gidin

2. <interfaceIp>Bu arayüzde hangi şifrelerin kullanıldığını görmek için get 443 komutunu girin. Cisco tarafından önerilen paketlerden en az bir tanesi olmalıdır (Genel Bakış bölümündeki XSP|ADP Kimlik ve Güvenlik Gereksinimlerine bakın).

3. <interfaceIp><cipherName>HTTP Sunucusu arayüz üne bir şifre eklemek için add 443 komutunu girin.

   XSP|ADP CLI, OpenSSL şifre paketi adını değil, IANA standart şifre paketi adını gerektirir. Örneğin, OpenSSL şifresini ECDHE- ECDSA-CHACHA20-POLY1305 HTTP sunucu arayüzüne eklemek için şunları kullanırsınız: xsp|ADP_CLI/Interface/HTTP/HTTP/HTTPServer/SSLSettings/Ciphers> add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

   Sü iti her iki isme göre bulmak için https://ciphersuite.info/ adresine bakın.

XSP|ADP, Uygulama Sunucusu ve Profil Sunucusunda Aygıt Yönetimini Yapılandırma

Aygıt Yönetimi için Profil Sunucusu ve XSP|ADP zorunludur. Bunlar, BroadWorks Aygıt Yönetimi Yapılandırma Kılavuzu'ndaki talimatlara göre yapılandırılmalıdır.