Konfigurace rozhraní CTI pro integraci Webex

list-menuZpětná vazba?
Naučte se konfigurovat rozhraní CTI, ověřování MTL a zabezpečené předplatné událostí pro Webex a BroadWorks.

Rozhraní CTI a související konfigurace

Pořadí konfigurace „nejvnitřnější až nejvzdálenější“ je uvedeno níže. Dodržování této objednávky není povinné.

  1. Konfigurace aplikačního serveru pro předplatné CTI

  2. Konfigurace XSP|ADP pro předplatné CTI ověřená MTL

  3. Otevřete příchozí porty pro zabezpečené rozhraní CTI

  4. Přihlaste svou organizaci Webex k odběru událostí BroadWorks CTI

Konfigurace aplikačního serveru pro předplatné CTI

Aktualizujte ClientIdentity na aplikačním serveru běžným názvem (CN) certifikátu klienta Webex pro Cisco BroadWorks CTI.

Pro každý aplikační server, který používáte s Webex, přidejte identitu certifikátu do ClientIdentity následujícím způsobem:

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

Obecný název klientského certifikátu Webex pro Cisco BroadWorks je. bwcticlient.webex.com

Konfigurace protokolu TLS a šifrů v rozhraní CTI

Úrovně konfigurovatelnosti rozhraní XSP|ADP CTI jsou následující:

Nejobecnější = Systém > Doprava > Rozhraní CTI > rozhraní CTI = Nejkonkrétnější

Kontexty rozhraní příkazového řádku, které používáte k zobrazení nebo úpravě různých nastavení SSL, jsou:

Specifičnost

Kontext CLI

Systém (globální)

(R22 a novější)

XSP| /System/SSLCommonSettings/JSSE/Šifry > ADP_CLI

XSP| ADP_CLI /System/SSLCommonSettings/jsse/Protokoly >

Přep ravní protokoly pro tento systém

(R22 a novější)

XSP| /System/SSLCommonSettings/OpenSSL/Šifry > ADP_CLI

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

Všechna rozhraní CTI v tomto systému

(R22 a novější)

XSP| ADP_CLI /rozhraní/CTI/SSLCommonSettings/Šifry >

XSP| ADP_CLI /rozhraní/CTI/SSLCommonSettings/Protokoly >

Specifické rozhraní CTI v tomto systému

(R22 a novější)

XSP| ADP_CLI /rozhraní/CTI/CTIServer/SSLNastavení/Šifry >

XSP| ADP_CLI /rozhraní/CTI/CTIServerSLSettings/Protocols >

Při nové instalaci jsou ve výchozím nastavení nainstalovány následující šifry na úrovni systému. Pokud není nic nakonfigurováno na úrovni rozhraní (například na rozhraní CTI nebo rozhraní HTTP), použije se tento seznam šifra. Všimněte si, že tento seznam se může časem 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

  1. Přihlaste se k XSP|ADP a přejděte na XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Zadejte getpříkaz a přečtěte si výsledky. Měli byste vidět rozhraní (IP adresy) a pro každé, 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 Cloudem, musí být nakonfigurováno pro TLS v1.2. Cloud nevyjednává dřívější verze protokolu TLS.

Postup konfigurace protokolu TLSv1.2 v rozhraní CTI:

  1. Přihlaste se k XSP|ADP a přejděte na XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Zadejte příkaz get <interfaceIp>a zjistěte, které protokoly jsou již v tomto rozhraní použity.

  3. Zadejte příkaz, add <interfaceIp> TLSv1.2abyste zajistili, že rozhraní může používat TLS 1.2 při komunikaci s cloudem.

Úprava konfigurace šifrování TLS v rozhraní CTI

Postup konfigurace požadovaných šifrů v rozhraní CTI:

  1. Přihlaste se k XSP|ADP a přejděte na XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Zadejte getpříkaz a zjistěte, které šifry jsou již v tomto rozhraní použity. Musí existovat alespoň jeden ze sad doporučených společností Cisco (viz XSP|ADP Identity and Security Requirements v části Přehled).

  3. Zadejte příkaz add <interfaceIp> <cipherName>pro přidání šifru do rozhraní CTI.

    CLI XSP|ADP vyžaduje standardní název sady šifrování IANA, nikoli název sady šifrování OpenSSL. Chcete-li například přidat šifru OpenSSL ECDHE-ECDSA-CHACHA20-POLY1305do rozhraní CTI, použij ete: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Na adrese https://ciphersuite.info/ najdete sadu podle obou jmen.

Důvěryhodné kotvy pro rozhraní CTI (R22 a novější)

Tento postup předpokládá, že XSP|ADP jsou buď orientovaní na internet, nebo čelí internetu prostřednictvím proxyserveru proxy. Konfigurace certifikátu se u překlenovacího proxy liší (viz Požadavky na certifikát TLS pro proxy server TLS-Bridge).

Pro každý XSP|ADP ve vaší infrastruktuře, který publikuje události CTI do Webex, proveďte následující:

  1. Přihlaste se do Partnerského centra.

  2. Přejděte na Služby > Další odkazy a kliknutím na Stáhnout certifikát Webex CA se dostanete do místního CombinedCertChain2023.txtpočítače.

    Tyto soubory obsahují dvě sady dvou certifikátů. Soubory musíte rozdělit, než je nahrajete do XSP|ADP. Všechny soubory jsou povinné.

  3. Rozdělit řetězec certifikátů na dva certifikáty - combinedcertchain2023.txt

    1. Otevřete combinedcertchain2023.txtv textovém editoru.

    2. Vyberte a vyjměte první blok textu, včetně řádků -----BEGIN CERTIFICATE-----a -----END CERTIFICATE-----, a vložte textový blok do nového souboru.

    3. Uložte nový soubor jako root2023.txt.

    4. Uložte původní soubor jako issuing2023.txt. Původní soubor by nyní měl mít pouze jeden blok textu, obklopený řádky -----BEGIN CERTIFICATE-----a -----END CERTIFICATE-----.

  4. Zkopírujte oba textové soubory do dočasného umístění na XSP|ADP, které zabezpečujete, např. a /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

  5. Přihlaste se k XSP|ADP a přejděte na /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Volitelné) Sp help updateTrustusťte pro zobrazení parametrů a formátu příkazu.

  7. Nahrajte soubory certifikátů do nových ukotvení 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ý název. webexclientroot2023, a webexclientissuing2023jsou příklady aliasů pro ukotvení důvěryhodnosti; můžete použít své vlastní, pokud jsou všechny položky jedinečné.

  8. 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]
  9. Povolit klientům ověřování pomocí certifikátů:

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

Přidejte rozhraní CTI a povolte MTL

  1. 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ý vlastním podpisem a vynutí rozhraní vyžadovat klientský certifikát.

    • Na BroadWorks R22 a R23:

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

  2. Nahraďte certifikát serveru a klíč na rozhraní 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

      Poté spusťte následující příkazy a nahraďte certifikát s vlastním podepsáním rozhraní vlastním certifikátem a soukromým klíčem:

      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. Restartujte XSP|ADP.

Povolit přístup k událostem BroadWorks CTI na Webex

Při konfiguraci clusterů v Partner Hub musíte přidat a ověřit rozhraní CTI. Podrobné pokyny najdete v tématu Konfigurace partnerské organizace v centru partnerů.

  • Určete adresu CTI, podle které se Webex může přihlásit k odběru událostí BroadWorks CTI.

  • Předplatné CTI jsou založeny na jednotlivých účastnících a jsou vytvořeny a udržovány pouze v době, kdy je tento předplatitel zřízený pro Webex pro Cisco BroadWorks.

Byl tento článek užitečný?
Byl tento článek užitečný?