Konfigurace rozhraní CTI pro integraci Webex
Rozhraní CTI a související konfigurace

Pořadí konfigurace "nejvnitřnější až nejvzdálenější" je uvedeno níže. Dodržování tohoto pořadí není povinné.
-
Konfigurace aplikačního serveru pro předplatná CTI
-
Konfigurace XSP|ADP pro předplatné CTI ověřené mTLS
-
Otevření příchozích portů pro zabezpečené rozhraní CTI
-
Přihlásit svou organizaci Webex k událostem BroadWorks CTI
Konfigurace aplikačního serveru pro předplatná CTI
Aktualizujte ClientIdentity na aplikačním serveru běžným názvem (CN) klientského certifikátu Webex pro Cisco BroadWorks CTI.
Pro každý aplikační server, který používáte s Webexem, přidejte identitu certifikátu do ClientIdentity následujícím způsobem:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
Běžný název klientského certifikátu Webex pro Cisco BroadWorks je bwcticlient.webex.com
.
Konfigurace protokolů TLS a šifer v rozhraní CTI
Úrovně konfigurovatelnosti rozhraní XSP|ADP CTI jsou následující:
Nejobecnější = Rozhraní > > CTI > Rozhraní CTI = Nejspecifičtější
Kontexty rozhraní příkazového řádku, které používáte k zobrazení nebo úpravě různých nastavení SSL, jsou:
Specifičnost |
Kontext rozhraní příkazového řádku |
---|---|
Systém (globální) (R22 a novější) |
XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/JSSE/Protocols> |
Transportní protokoly pro tento systém (R22 a novější) |
XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Ciphers> XSP|ADP_CLI/System/SSLCommonSettings/OpenSSL/Protocols> |
Všechna rozhraní CTI v tomto systému (R22 a novější) |
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/Protocols> |
Specifické rozhraní CTI v tomto systému (R22 a novější) |
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> XSP|ADP_CLI/Interface/CTI/CTIServerSSLSettings/Protocols> |
Při nové instalaci se na úrovni systému standardně nainstalují následující šifry. Pokud na úrovni rozhraní není nic nakonfigurováno (například na rozhraní CTI nebo HTTP), platí tento seznam šifer. Upozorňujeme, že tento seznam se může v průběhu času měnit:
-
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
Čtení konfigurace rozhraní CTI TLS na XSP|ADP
-
Přihlaste se do XSP|ADP a přejděte na
XSP|ADP_CLI/Interface/CTI/CTIServer>
Zadejte příkaz
get
a přečtěte si výsledky. Měli byste vidět rozhraní (IP adresy) a pro každé z nich, zda vyžadují certifikát serveru a zda vyžadují ověření 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
Přidání protokolu TLS 1.2 do rozhraní CTI
Rozhraní XSP|ADP CTI, které interaguje s Webex Cloud, musí být nakonfigurováno pro TLS v1.2. Cloud nevyjednává starší verze protokolu TLS.
Konfigurace protokolu TLSv1.2 v rozhraní CTI:
-
Přihlaste se do XSP|ADP a přejděte na
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>
-
Zadejte příkaz
get
a zjistěte, které protokoly se na tomto rozhraní již používají. -
Zadejte příkaz
add TLSv1.2
, abyste zajistili, že rozhraní může při komunikaci s cloudem používat TLS 1.2.
Úprava konfigurace šifer TLS v rozhraní CTI
Konfigurace požadovaných šifer v rozhraní CTI:
-
Přihlaste se do XSP|ADP a přejděte na
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>
-
Zadejte příkaz
get
a zjistěte, které šifry se na tomto rozhraní již používají. Musí existovat alespoň jeden z doporučených sad Cisco (viz XSP|Požadavky na identitu a zabezpečení ADP v části Přehled). -
Zadejte příkaz
add
pro přidání šifry do rozhraní CTI.Rozhraní CLI XSP|ADP vyžaduje standardní název šifrovací sady IANA, nikoli název šifrovací sady openSSL. Například pro přidání šifry openSSL
ECDHE-ECDSA-CHACHA20-POLY1305
do rozhraní CTI byste použili:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305
Podívejte https://ciphersuite.info/ se, jak najít sadu podle obou jmen.
Důvěryhodné kotvy pro rozhraní CTI (R22 a novější)
Tento postup předpokládá, že ADP XSP|jsou buď připojeny k internetu, nebo jsou k internetu připojeny přes průchozí proxy. Konfigurace certifikátu se liší pro přemosťující proxy server (viz Požadavky na certifikát TLS pro proxy TLS-bridge).
Pro každý XSP|ADP ve vaší infrastruktuře, který publikuje události CTI do Webexu, proveďte následující:
-
Přihlas se do partnerského centra.
-
Přejít na Služby > Další odkazy a kliknutím na Stáhnout certifikát CA Webex získáte
CombinedCertChain2023.txt
na svém místním počítači.Tyto soubory obsahují dvě sady po dvou certifikátech. Před nahráním do XSP|ADP je nutné soubory rozdělit. Všechny soubory jsou povinné.
-
Rozdělte řetězec certifikátů na dva certifikáty -
combinedcertchain2023.txt
-
Otevřete
combinedcertchain2023.txt
v textovém editoru. -
Vyberte a vyjměte první blok textu, včetně řádků
-----BEGIN CERTIFICATE-----
a-----END CERTIFICATE-----
, a vložte textový blok do nového souboru. -
Uložte nový soubor jako
root2023.txt
. -
Uložte původní soubor jako
issuing2023.txt
. Původní soubor by nyní měl obsahovat pouze jeden blok textu, ohraničený řádky-----BEGIN CERTIFICATE-----
a-----END CERTIFICATE-----
.
-
-
Zkopírujte oba textové soubory do dočasného umístění na XSP|ADP, které zabezpečujete, např.
/var/broadworks/tmp/root2023.txt
a/var/broadworks/tmp/issuing2023.txt
-
Přihlaste se do XSP|ADP a přejděte na
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>
-
(Volitelné) Spusťte
help updateTrust
pro zobrazení parametrů a formátu příkazu. -
Nahrávání souborů certifikátů do nových kotev důvěryhodnosti – 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
Všechny aliasy musí mít jiné jméno.
webexclientroot2023
awebexclientissuing2023
jsou příklady aliasů pro důvěryhodné kotvy; můžete použít vlastní, pokud jsou všechny položky jedinečné. -
Potvrďte, že jsou kotvy aktualizovány:
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]
-
Povolit klientům ověřování pomocí certifikátů:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Přidání rozhraní CTI a povolení mTLS
-
Přidejte rozhraní CTI SSL.
Kontext rozhraní příkazového řádku závisí na vaší verzi BroadWorks. Příkaz vytvoří v rozhraní certifikát serveru podepsaný svým držitelem a vynutí, aby rozhraní vyžadovalo klientský certifikát.
-
Na BroadWorks R22 a R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add 8012 true true true
-
-
Nahraďte certifikát a klíč serveru na rozhraních CTI XSP|ADP. K tomu potřebujete IP adresu rozhraní CTI; můžete si ji přečíst z následujícího kontextu:
-
Na BroadWorks R22 a R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> get
Pak spuštěním následujících příkazů nahraďte certifikát rozhraní podepsaný svým držitelem vlastním certifikátem a soukromým klíčem:
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Certificates> sslUpdate keyFile certificateFile chainFile
-
-
Restartujte XSP|ADP.
Povolit přístup k událostem ČOi BroadWorks na Webexu
Při konfiguraci clusterů v partnerském centru je třeba přidat a ověřit rozhraní CTI. Podrobné pokyny najdete v tématu Konfigurace partnerské organizace v partnerském centru.
-
Zadejte adresu CTI, pomocí které se Webex může přihlásit k odběru událostí BroadWorks CTI.
-
Předplatná CTI jsou na základě jednotlivých předplatitelů a jsou vytvořena a udržována pouze v době, kdy je tento předplatitel zřízen pro Webex pro Cisco BroadWorks.