CTI-gränssnittskonfiguration för Webex-integration

list-menuHar du feedback?
Lär dig att konfigurera CTI-gränssnitt, MTLS-autentisering och säkra händelseprenumerationer för Webex och BroadWorks.

CTI-gränssnitt och relaterad konfiguration

Konfigurationsordningen ”innerst till yttersta” listas nedan. Att följa denna order är inte obligatoriskt.

  1. Konfigurera programserver för CTI-prenumerationer

  2. Konfigurera XSP|ADP för MTL-autentiserade CTI-prenumerationer

  3. Öppna inkommande portar för säkert CTI-gränssnitt

  4. Prenumerera din Webex-organisation på BroadWorks CTI-evenemang

Konfigurera programserver för CTI-prenumerationer

Uppdatera ClientIdentity on Application Server med det vanliga namnet (CN) för Webex för Cisco BroadWorks CTI-klientcertifikat.

För varje programserver som du använder med Webex lägger du till certifikatidentiteten i ClientIdentity enligt följande:

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

Det vanliga namnet på Webex för Cisco BroadWorks-klientcertifikatet är. bwcticlient.webex.com

Konfigurera TLS och chiffer på CTI-gränssnittet

Nivåerna av konfigurerbarhet för XSP|ADP CTI-gränssnittet är följande:

Mest allmänt = System > Transport > CTI-gränssnitt > CTI-gränssnitt = Mest specifika

De CLI-sammanhang som du använder för att visa eller ändra de olika SSL-inställningarna är:

Specificitet

CLI-sammanhang

System (globalt)

(R22 och senare)

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

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

Tran sportprotokoll för detta system

(R22 och senare)

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

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

Alla CTI-gränssnitt på detta system

(R22 och senare)

XSP| ADP_CLI /Gränssnitt/CTI/SSLCommonInställningar/Chiffer >

XSP| ADP_CLI /Gränssnitt/CTI/SSLCommonInställningar/Protokoll >

Ett specifikt CTI-gränssnitt på detta system

(R22 och senare)

XSP| ADP_CLI /Gränssnitt/CTI/CTIServer/SSLInställningar/Chiffer >

XSP| ADP_CLI /Gränssnitt/CTI/CTIServersslInställningar/Protokoll >

Vid en ny installation installeras följande chiffer som standard på systemnivå. Om inget är konfigurerat på gränssnittsnivå (till exempel vid CTI-gränssnittet eller HTTP-gränssnittet) gäller denna chifferlista. Observera att listan kan ändras över tid:

  • 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

Läsa CTI TLS-gränssnittskonfiguration på XSP|ADP

  1. Logga in på XSP|ADP och navigera till XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Ange getkommandot och läs resultaten. Du bör se gränssnitten (IP-adresser) och, för varje, om de kräver ett servercertifikat och om de kräver klientautentisering.

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

Lägga till TLS 1.2-protokoll till CTI-gränssnittet

XSP|ADP CTI-gränssnittet som interagerar med Webex Cloud måste konfigureras för TLS v1.2. Molnet förhandlar inte om tidigare versioner av TLS- protokollet.

Så här konfigurerar du TLSv1.2-protokollet på CTI-gränssnittet:

  1. Logga in på XSP|ADP och navigera till XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Ange kommandot get <interfaceIp>för att se vilka protokoll som redan används i det här gränssnittet.

  3. Ange kommandot add <interfaceIp> TLSv1.2för att säkerställa att gränssnittet kan använda TLS 1.2 när du kommunicerar med molnet.

Redigera TLS-chifferkonfiguration på CTI-gränssnittet

Så här konfigurerar du de krypteringar som krävs i CTI-gränssnittet:

  1. Logga in på XSP|ADP och navigera till XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Ange getkommandot för att se vilka chiffer som redan används i det här gräns snittet. Det måste finnas minst en av Ciscos rekommenderade sviter (se XSP|ADP-identitets- och säkerhet skrav i avsnittet Översikt).

  3. Ange kommandot add <interfaceIp> <cipherName>för att lägga till en chiffer i CTI-gränssnittet.

    XSP|ADP CLI kräver IANA-standardkrypteringssvitens namn, inte OpenSSL-krypteringssvitens namn. Om du till exempel vill lägga till OpenSSL-krypteringen ECDHE-ECDSA-CHACHA20-POLY1305i CTI-gränssnittet använder du: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Se https://ciphersuite.info/ för att hitta sviten med endera namnet.

Trust Anchors för CTI-gränssnitt (R22 och senare)

Den här proceduren förutsätter att XSP|ADP: erna antingen är internetvända eller möter internet via pass-through proxy. Certifikatkonfigurationen är annorlunda för en överbryggnings proxy (se TLS-certifikatkrav för TLS- bryggproxy).

Gör följande för varje XSP|ADP i infrastrukturen som publicerar CTI-händelser till Webex:

  1. Logga in på Partner Hub.

  2. Gå till Tjänster > Ytterligare länkar och klicka på Ladda ner Webex CA-certifikat för att komma CombinedCertChain2023.txttill din lokala dator.

    Dessa filer innehåller två uppsättningar med två certifikat. Du måste dela upp filerna innan du laddar upp dem till XSP|ADP. Alla filer krävs.

  3. Dela certifikatkedjan i två certifikat - combinedcertchain2023.txt

    1. Öppna combinedcertchain2023.txti en textredigerare.

    2. Markera och klipp ut det första textblocket, inklusive raderna -----BEGIN CERTIFICATE-----och -----END CERTIFICATE-----, och klistra in textblocket i en ny fil.

    3. Spara den nya filen som root2023.txt.

    4. Spara originalfilen som issuing2023.txt. Originalfilen ska nu bara ha ett textblock, omgiven av raderna -----BEGIN CERTIFICATE-----och -----END CERTIFICATE-----.

  4. Kopiera båda textfilerna till en tillfällig plats på XSP|ADP som du säkrar, t.ex. /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

  5. Logga in på XSP|ADP och navigera till /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Valfritt) Kör help updateTrustför att se parametrarna och kommandoformatet.

  7. Ladda upp certifikatfilerna till nya förtroendeankare - 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

    Alla alias måste ha ett annat namn. webexclientroot2023, och webexclientissuing2023är exempel på alias för förtroendeankare. Du kan använda dina egna så länge alla poster är unika.

  8. Bekräfta att ankarna är uppdaterade:

    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. Tillåt klienter att autentisera med certifikat:

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

Lägg till CTI-gränssnitt och aktivera MTL

  1. Lägg till CTI SSL-gränssnittet.

    CLI-sammanhanget beror på din BroadWorks-version. Kommandot skapar ett självsignerat servercertifikat i gränssnittet och tvingar gränssnittet att kräva ett klientcertifikat.

    • På BroadWorks R22 och R23:

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

  2. Ersätt servercertifikatet och nyckeln på XSP|ADP:s CTI-gränssnitt. Du behöver IP-adressen för CTI-gränssnittet för detta; du kan läsa den från följande sammanhang:

    • På BroadWorks R22 och R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Kör sedan följande kommandon för att ersätta gränssnittets självsignerade certifikat med ditt eget certifikat och privata nyckel:

      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. Starta om XSP|ADP.

Aktivera åtkomst till BroadWorks CTI-händelser på Webex

Du måste lägga till och validera CTI-gränssnittet när du konfigurerar dina kluster i Partner Hub. Se Konfigurera din partnerorganisation i Partner Hub för detaljerade instruktioner.

  • Ange den CTI-adress som Webex kan prenumerera på BroadWorks CTI Events med.

  • CTI-prenumerationer är per abonnent och upprättas och underhålls endast medan den abonnenten är etablerad för Webex för Cisco BroadWorks.

Var den här artikeln användbar?
Var den här artikeln användbar?