CTI-Schnittstellenkonfiguration für die Webex-Integration

list-menuFeedback?
Erfahren Sie, wie Sie die CTI-Schnittstelle, die mTLS-Authentifizierung und sichere Veranstaltungsabonnements für Webex und BroadWorks konfigurieren.

CTI-Schnittstelle und zugehörige Konfiguration

Die Konfigurationsreihenfolge „von innen nach außen“ ist unten aufgeführt. Die Einhaltung dieser Bestellung ist nicht verpflichtend.

  1. Anwendungsserver für CTI-Abonnements konfigurieren

  2. XSP|ADPs für mTLS-authentifizierte CTI-Abonnements konfigurieren

  3. Eingehende Ports für eine sichere CTI-Schnittstelle öffnen

  4. Abonnieren Sie BroadWorks CTI Events für Ihre Webex-Organisation

Anwendungsserver für CTI-Abonnements konfigurieren

Aktualisieren Sie die ClientIdentity auf dem Anwendungsserver mit dem allgemeinen Namen (CN) des Webex for Cisco BroadWorks CTI-Client-Zertifikats.

Fügen Sie für jeden Anwendungsserver, den Sie mit Webex verwenden, die Zertifikatidentität wie folgt zur clientIdentity hinzu:

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

Der allgemeine Name des Webex for Cisco BroadWorks Client-Zertifikats ist. bwcticlient.webex.com

TLS und Chiffren auf der CTI-Schnittstelle konfigurieren

Die Konfigurierbarkeitsstufen für die XSP|ADP CTI-Schnittstelle sind wie folgt:

Am allgemeinsten = System > Transport > CTI-Schnittstellen > CTI-Schnittstelle = Sehr spezifisch

Die CLI-Kontexte, die Sie verwenden, um die verschiedenen SSL-Einstellungen anzuzeigen oder zu ändern, sind:

Spezifität

CLI-Kontext

System (weltweit)

(R22 und später)

XSP | /system/sslcommonsettings/jsse/ciphers > ADP_CLI

XSP | ADP_CLI /system/sslCommonSettings/JSSE/Protokolle >

Transportprotokolle für dieses System

(R22 und später)

XSP | /system/sslCommonSettings/OpenSSL/Ciphers > ADP_CLI

XSP | /system/sslCommonSettings/OpenSSL/Protokolle > ADP_CLI

Alle CTI-Schnittstellen auf diesem System

(R22 und später)

XSP| ADP_CLI /interface/cti/sslCommonSettings/Ciphers >

XSP | ADP_CLI /interface/CTI/SSL Allgemeine Einstellungen/Protokolle >

Eine bestimmte CTI-Schnittstelle auf diesem System

(R22 und später)

XSP| /interface/cti/ctiserver/sslsettings/ciphers > ADP_CLI

XSP| /interface/CTI/CTIServerSSLSettings/Protokolle > ADP_CLI

Bei einer Neuinstallation werden die folgenden Chiffren standardmäßig auf Systemebene installiert. Wenn auf Schnittstellenebene nichts konfiguriert ist (zum Beispiel an der CTI-Schnittstelle oder HTTP-Schnittstelle), gilt diese Verschlüsselungsliste. Beachten Sie, dass sich diese Liste im Laufe der Zeit ändern kann:

  • 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

CTI TLS-Schnittstellenkonfiguration auf dem XSP|ADP lesen

  1. Melden Sie sich bei XSP|ADP an und navigieren Sie zu XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Geben Sie den getBefehl ein und lesen Sie die Ergebnisse. Sie sollten die Schnittstellen (IP-Adressen) sehen und für jede, ob sie ein Serverzertifikat benötigen und ob sie eine Client-Authentifizierung benötigen.

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

Hinzufügen des TLS 1.2-Protokolls zur CTI-Schnittstelle

Die XSP|ADP CTI-Schnittstelle, die mit der Webex Cloud interagiert, muss für TLS v1.2 konfiguriert sein. Die Cloud handelt keine früheren Versionen des TLS-Protokolls aus.

Um das TLSv1.2-Protokoll auf der CTI-Schnittstelle zu konfigurieren:

  1. Melden Sie sich bei XSP|ADP an und navigieren Sie zu XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Geben Sie den Befehl ein get <interfaceIp>, um zu sehen, welche Protokolle auf dieser Schnittstelle bereits verwendet werden.

  3. Geben Sie den Befehl ein, add <interfaceIp> TLSv1.2um sicherzustellen, dass die Schnittstelle TLS 1.2 verwenden kann, wenn sie mit der Cloud kommuniziert.

Konfiguration der TLS-Chiffren auf der CTI-Schnittstelle bearbeiten

Um die erforderlichen Chiffren auf der CTI-Schnittstelle zu konfigurieren:

  1. Melden Sie sich bei XSP|ADP an und navigieren Sie zu XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Geben Sie den getBefehl ein, um zu sehen, welche Chiffren auf dieser Schnittstelle bereits verwendet werden. Es muss mindestens eine der von Cisco empfohlenen Suiten geben (siehe XSP|ADP Identitäts- und Sicherheitsanforderungen im Abschnitt Überblick).

  3. Geben Sie den Befehl ein add <interfaceIp> <cipherName>, um der CTI-Schnittstelle eine Chiffre hinzuzufügen.

    Die XSP|ADP-CLI erfordert den Namen der IANA-Standardchiffrensuite, nicht den Namen der OpenSSL-Verschlüsselungssammlung. Um zum Beispiel die OpenSSL-Verschlüsselung zur CTI-Schnittstelle hinzuzufügen, würden Sie verwenden: ECDHE-ECDSA-CHACHA20-POLY1305 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Besuchen Sie https://ciphersuite.info/, um die Suite nach einem der beiden Namen zu finden.

Vertrauensanker für CTI Interface (R22 und höher)

Bei diesem Verfahren wird davon ausgegangen, dass die XSP|ADPs entweder mit dem Internet verbunden sind oder über einen Pass-Through-Proxy mit dem Internet verbunden sind. Die Zertifikatskonfiguration für einen Bridging-Proxy ist anders (siehe TLS-Zertifikatsanforderungen für TLS-Bridge-Proxy).

Gehen Sie für jedes XSP|ADP in Ihrer Infrastruktur, das CTI-Ereignisse auf Webex veröffentlicht, wie folgt vor:

  1. Melden Sie sich bei Partner Hub an.

  2. Gehen Sie zu Dienste > Zusätzliche Links und klicken Sie auf Webex CA-Zertifikat herunterladen, um es CombinedCertChain2023.txtauf Ihren lokalen Computer herunterzuladen.

    Diese Dateien enthalten zwei Sätze von zwei Zertifikaten. Sie müssen die Dateien teilen, bevor Sie sie in die XSP|ADPs hochladen. Alle Dateien sind erforderlich.

  3. Teilen Sie die Zertifikatskette in zwei Zertifikate auf - combinedcertchain2023.txt

    1. combinedcertchain2023.txtIn einem Texteditor öffnen.

    2. Wählen und schneiden Sie den ersten Textblock aus, einschließlich der Zeilen -----END CERTIFICATE-----, -----BEGIN CERTIFICATE-----und fügen Sie den Textblock in eine neue Datei ein.

    3. Speichern Sie die neue Datei unter root2023.txt.

    4. Speichern Sie die Originaldatei unter issuing2023.txt. Die Originaldatei sollte jetzt nur noch einen Textblock haben, umgeben von den Zeilen -----BEGIN CERTIFICATE-----und -----END CERTIFICATE-----.

  4. Kopieren Sie beide Textdateien an einen temporären Speicherort auf dem XSP|ADP, das Sie sichern, z. B. und /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

  5. Melden Sie sich bei XSP|ADP an und navigieren Sie zu /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optional) Führen Sie aus help updateTrust, um die Parameter und das Befehlsformat zu sehen.

  7. Laden Sie die Zertifikatsdateien auf neue Vertrauensanker hoch - 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

    Alle Aliase müssen einen anderen Namen haben. webexclientroot2023und webexclientissuing2023sind Beispielaliase für die Vertrauensanker; Sie können Ihre eigenen verwenden, solange alle Einträge eindeutig sind.

  8. Bestätigen Sie, dass die Anker aktualisiert wurden:

    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. Erlauben Sie Kunden, sich mit Zertifikaten zu authentifizieren:

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

CTI-Schnittstelle hinzufügen und mTLS aktivieren

  1. Fügen Sie die CTI SSL-Schnittstelle hinzu.

    Der CLI-Kontext hängt von Ihrer BroadWorks-Version ab. Der Befehl erstellt ein selbstsigniertes Serverzertifikat auf der Schnittstelle und zwingt die Schnittstelle, ein Client-Zertifikat zu verlangen.

    • Auf BroadWorks R22 und R23:

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

  2. Ersetzen Sie das Serverzertifikat und den Schlüssel auf den CTI-Schnittstellen von XSP|ADP. Sie benötigen dafür die IP-Adresse der CTI-Schnittstelle; Sie können sie aus dem folgenden Kontext lesen:

    • Auf BroadWorks R22 und R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Führen Sie dann die folgenden Befehle aus, um das selbstsignierte Zertifikat der Schnittstelle durch Ihr eigenes Zertifikat und Ihren privaten Schlüssel zu ersetzen:

      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. Starten Sie XSP|ADP neu.

Zugriff auf BroadWorks CTI-Ereignisse auf Webex aktivieren

Sie müssen die CTI-Schnittstelle hinzufügen und validieren, wenn Sie Ihre Cluster in Partner Hub konfigurieren. Eine ausführliche Anleitung finden Sie unter Konfigurieren Sie Ihre Partnerorganisation in Partner Hub.

  • Geben Sie die CTI-Adresse an, unter der Webex BroadWorks CTI Events abonnieren kann.

  • CTI-Abonnements gelten pro Abonnent und werden nur eingerichtet und verwaltet, solange dieser Abonnent Webex für Cisco BroadWorks bereitgestellt hat.

War dieser Artikel hilfreich für Sie?
War dieser Artikel hilfreich für Sie?