Konfiguracja interfejsu CTI dla integracji z Webex

list-menuOpinia?
Dowiedz się, jak skonfigurować interfejs CTI, uwierzytelnianie MTL i bezpieczne subskrypcje zdarzeń dla Webex i BroadWorks.

Interfejs CTI i powiązana konfiguracja

Kolejność konfiguracji „od wewnątrz do najdalszej” jest wymieniona poniżej. Przestrzeganie tego zamówienia nie jest obowiązkowe.

  1. Konfigurowanie serwera aplikacji dla subskrypcji CTI

  2. Konfigurowanie XSP|ADP dla uwierzytelnionych subskrypcji CTI MTL

  3. Otwórz porty przychodzące dla bezpiecznego interfejsu CTI

  4. Subskrybuj swoją organizację Webex na wydarzenia BroadWorks CTI

Konfigurowanie serwera aplikacji dla subskrypcji CTI

Zaktualizuj ClientIdentity na serwerze aplikacji o wspólną nazwę (CN) certyfikatu klienta Webex for Cisco BroadWorks CTI.

Dla każdego serwera aplikacji używanego z Webex dodaj identyfikator certyfikatu do identyfikatora ClientIdentity w następujący sposób:

AS_CLI/System/ClientIdentity> add bwcticlient.webex.com

Powszechna nazwa certyfikatu klienta Webex for Cisco BroadWorks to. bwcticlient.webex.com

Konfigurowanie protokołu TLS i szyfrów w interfejsie CTI

Poziomy konfigurowalności interfejsu XSP|ADP CTI są następujące:

Najbardziej ogólne = System > Transport > Interfejsy CTI > Interfejs CTI = Najbardziej specyficzny

Konteksty interfejsu wiersza polecenia używanych do przeglą dania lub modyfikowania różnych ustawień SSL to:

Specyfika

Kontekst CLI

System (globalny)

(R22 i nowsze)

XSP| /System/SSLCommonSettings/JSSE/Szyfry > ADP_CLI

XSP| /System/SSLcommonSettings/JSSE/Protokoły > ADP_CLI

Protokoły transportowe dla tego systemu

(R22 i nowsze)

XSP| /System/SSLCommonSettings/OpenSSL/Szyfry > ADP_CLI

XSP| /System/SSLcommonSettings/OpenSSL/Protokoły > ADP_CLI

Wszystkie interfejsy CTI w tym systemie

(R22 i nowsze)

XSP| /Interfejs/CTI/SSLCommonSettings/Szyfry > ADP_CLI

XSP| /Interfejs/CTI/SSLcommonSettings/Protokoły > ADP_CLI

Specyficzny interfejs CTI w tym systemie

(R22 i nowsze)

XSP| /Interfejs/CTI/CTIServer/Ustawienia SSL/Szyfry > ADP_CLI

XSP| ADP_CLI /Interface/CTI/CTIServersLSettings/Protokoły >

W przypadku nowej instalacji następujące szyfry są domyślnie instalowane na poziomie systemu. Jeśli nic nie jest skonfigurowane na poziomie interfejsu (na przykład w interfejsie CTI lub interfejsie HTTP), ta lista szyfrów ma zastosowanie. Należy pamiętać, że ta lista może ulec zmianie w miarę upływu czasu:

  • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256

  • TLS_DHE_DSS_WITH_AES_128_GCM_SHA256

  • TLS_DHE_RSA_WITH_AES_128_GCM_SHA256

  • TLS_DHE_RSA_WITH_AES_128_CBC_SHA256

  • TLS_DHE_DSS_WITH_AES_128_CBC_SHA256

  • TLS_ECDH_RSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDH_ECDSA_WITH_AES_128_GCM_SHA256

  • TLS_ECDH_RSA_WITH_AES_128_CBC_SHA256

  • TLS_ECDH_ECDSA_WITH_AES_128_CBC_SHA256

Odczyt konfiguracji interfejsu CTI TLS na XSP|ADP

  1. Zaloguj się do XSP|ADP i przejdź do XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Wprowadź getpolecenie i przeczytaj wyniki. Powinieneś zobaczyć interfejsy (adresy IP) i, dla każdego, czy wymagają certyfikatu serwera i czy wymagają uwierzytelniania klienta.

    XSP|ADP_CLI/Interface/CTI/CTIServer> get
      Interface IP  Port  Secure  Server Certificate  Client Auth Req
    =================================================================
      10.155.6.175  8012    true                true             true
    

Dodawanie protokołu TLS 1.2 do interfejsu CTI

Interfejs XSP|ADP CTI, który współdziała z chmurą Webex, musi być skonfigurowany dla protokołu TLS v1.2. Chmura nie negocjuje wcześniejszych wersji protokołu TLS.

Aby skonfigurować protokół TLSv1.2 w interfejsie CTI:

  1. Zaloguj się do XSP|ADP i przejdź do XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Wprowadź polecenie, get <interfaceIp>aby zobaczyć, które protokoły są już używane w tym interfejsie.

  3. Wprowadź polecenie, add <interfaceIp> TLSv1.2aby upewnić się, że interfejs może używać protokołu TLS 1.2 podczas komunikacji z chmurą.

Edycja konfiguracji szyfrów TLS w interfejsie CTI

Aby skonfigurować wymagane szyfry w interfejsie CTI:

  1. Zaloguj się do XSP|ADP i przejdź do XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Wprowadź getpolecenie, aby zobaczyć, które szyfry są już używane w tym interfej sie. Musi być co najmniej jeden z pakietów zalec anych przez Cisco (patrz wymagania dotyczące tożsamości i bezpieczeństwa XSP|ADP w sekcji Przegląd).

  3. Wprowadź polecenie, add <interfaceIp> <cipherName>aby dodać szyfr do interfejsu CTI.

    Interfejs wiersza polecenia XSP|ADP wymaga standardowej nazwy pakietu szyfrów IANA, a nie nazwy pakietu szyfrów OpenSSL. Na przykład, aby dodać szyfr OpenSSL ECDHE-ECDSA-CHACHA20-POLY1305do interfejsu CTI, należy użyć: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Zobacz https://ciphersuite.info/, aby znaleźć pakiet według dowolnej nazwy.

Kotwy zaufania do interfejsu CTI (R22 i nowsze)

Ta procedura zakłada, że XSP|ADP są albo skierowane do Internetu, albo stają w obliczu Internetu przez pass-through proxy. Konfiguracja certyfikatu jest inna dla serwera proxy mostkującego (patrz Wymagania certyfikatu TLS dla serwera proxy TLS-Bridge).

Dla każdego XSP|ADP w infrastrukturze, która publikuje zdarzenia CTI w Webex, wykonaj następujące czynności:

  1. Zaloguj się do Partner Hub.

  2. Przejdź do Usługi > Dodatkowe łącz a i kliknij Pobierz certyfikat Webex CA, aby uzyskać dostęp do CombinedCertChain2023.txtkomputera lokalnego.

    Pliki te zawierają dwa zestawy dwóch certyfikatów. Musisz podzielić pliki przed przesłaniem ich do XSP|ADPS. Wszystkie pliki są wymagane.

  3. Podziel łańcuch certyfikatów na dwa certyfikaty - combinedcertchain2023.txt

    1. Otwórz combinedcertchain2023.txtw edytorze tekstu.

    2. Zaznacz i wytnij pierwszy blok tekstu, w tym wiersze -----END CERTIFICATE-----, -----BEGIN CERTIFICATE-----i wklej blok tekstowy do nowego pliku.

    3. Zapisz nowy plik jako root2023.txt.

    4. Zapisz oryginalny plik jako issuing2023.txt. Oryginalny plik powinien teraz mieć tylko jeden blok tekstu, otoczony liniami -----BEGIN CERTIFICATE-----i -----END CERTIFICATE-----.

  4. Skopiuj oba pliki tekstowe do tymczasowej lokalizacji na zabezpieczonym XSP|ADP, np. /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

  5. Zaloguj się do XSP|ADP i przejdź do /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Opcjonalnie) U help updateTrustruchom, aby zobaczyć parametry i format polecenia.

  7. Przesyłanie plików certyfikatów do nowych kotew zaufania - 2023

    XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txt

    XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txt

    Wszystkie aliasy muszą mieć inną nazwę. webexclientroot2023, i webexclientissuing2023są przykładowymi aliasami dla kotew zaufania; możesz używać własnych, o ile wszystkie wpisy są unikalne.

  8. Potwierdź, że kotwy zostały zaktualizowane:

    XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> get

      Alias   Owner                                   Issuer
    =============================================================================
    webexclientissuing2023       Internal Private TLS SubCA      Internal Private Root
    webexclientroot2023       Internal Private Root      Internal Private Root[self-signed]
  9. Zezwalaj klientom na uwierzytelnianie za pomocą certyfikatów:

    XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true

Dodaj interfejs CTI i włącz MTL

  1. Dodaj interfejs CTI SSL.

    Kontekst interfejsu wiersza polecenia zależy od wersji BroadWorks. Polecenie tworzy certyfikat serwera podpisany samodzielnie w interfejsie i zmusza interfejs do wymagania certyfikatu klienta.

    • Na BroadWorks R22 i R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true

  2. Zastąp certyfikat serwera i klucz na interfejsach CTI XSP|ADP. Potrze bujesz do tego adresu IP interfejsu CTI; możesz go odczytać z następującego kontekstu:

    • Na BroadWorks R22 i R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Następnie uruchom następujące polecenia, aby zastąpić certyfikat podpisany przez interfejs własnym certyfikatem i kluczem prywatnym:

      XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate <interface IP> keyFile</path/to/certificate key file> certificateFile </path/to/server certificate> chainFile</path/to/chain file>

  3. Uruchom ponownie XSP|ADP.

Włącz dostęp do zdarzeń BroadWorks CTI na Webex

Podczas konfigurowania klastrów w Partner Hub należy dodać i sprawdzić poprawność interfejsu CTI. Szczegółowe instrukcje można znaleźć w sekcji Konfigurowanie organizacji partner skiej w Centrum partnerów.

  • Określ adres CTI, pod którym Webex może subskrybować BroadWorks CTI Events.

  • Subskrypcje CTI są przydzielane na subskrybenta i są ustanawiane i utrzymywane tylko wtedy, gdy ten abonent jest udostępniany dla Webex dla Cisco BroadWorks.

Czy ten artykuł był pomocny?
Czy ten artykuł był pomocny?