CTI-interfaceconfiguratie voor Webex-integratie

list-menuFeedback?
Leer hoe u de CTI-interface, MTLS-verificatie en veilige evenementenabonnementen voor Webex en BroadWorks kunt configureren.

CTI-interface en gerelateerde configuratie

De configuratievolgorde van „van binnen naar buiten” wordt hieronder vermeld. Het volgen van deze bestelling is niet verplicht.

  1. Applicatieserver configureren voor CTI-abonnementen

  2. XSP|ADPS configureren voor MTL's geverifieerde CTI-abonnementen

  3. Open binnenkomende poorten voor een veilige CTI-interface

  4. Abonneer uw Webex-organisatie op BroadWorks CTI-evenementen

Applicatieserver configureren voor CTI-abonnementen

Update de ClientIdentity op Application Server met de algemene naam (CN) van het Webex for Cisco BroadWorks CTI-clientcertificaat.

Voor elke toepassingsserver die u met Webex gebruikt, moet u de certificaatidentiteit als volgt aan de ClientIdentity toevoegen:

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

De algemene naam van het Webex for Cisco BroadWorks-clientcertificaat is. bwcticlient.webex.com

Configureer TLS en cijfers op de CTI-interface

De niveaus van configureerbaarheid voor de XSP|ADP CTI-interface zijn als volgt:

Meest algemeen = Systeem > Transport > CTI-interfaces > CTI-interface = Meest specifiek

De CLI-contexten die u gebruikt om de verschillende SSL-instellingen te bekijken of te wijzigen zijn:

Specificiteit

CLI-context

Systeem (wereldwijd)

(R22 en hoger)

XSP| ADP_CLI /System/SSL/CommonSettings/JSSE/Ciphers >

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

Transportprotocollen voor dit systeem

(R22 en hoger)

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

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

Alle CTI-interfaces op dit systeem

(R22 en hoger)

XSP| /Interface/CTI/SSLCommonSettings/Ciphers > ADP_CLI

XSP| /Interface/CTI/SSL-algemene instellingen/protocollen > ADP_CLI

Een specifieke CTI-interface op dit systeem

(R22 en hoger)

XSP| /Interface/CTI/CTIServer/SSL-instellingen/cijfers > ADP_CLI

XSP| /Interface/CTI/CTIServers/SSL-instellingen/protocollen > ADP_CLI

Bij een nieuwe installatie worden de volgende cijfers standaard op systeemniveau geïnstalleerd. Als er niets is geconfigureerd op interfaceniveau (bijvoorbeeld op de CTI-interface of de HTTP-interface), is deze coderingslijst van toepassing. Houd er rekening mee dat deze lijst in de loop van de tijd kan veranderen:

  • 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

De CTI TLS-interfaceconfiguratie lezen op de XSP|ADP

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Voer de getopdracht in en lees de resultaten. U zou de interfaces (IP-adressen) moeten zien en, voor elk ervan, of ze een servercertificaat vereisen en of ze client-authenticatie vereisen.

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

Het TLS 1.2-protocol aan de CTI-interface toevoegen

De XSP|ADP CTI-interface die interageert met de Webex Cloud moet worden geconfigureerd voor TLS v1.2. De cloud onderhandelt niet over eerdere versies van het TLS-protocol.

Om het TLSv1.2-protocol op de CTI-interface te configureren:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Voer de opdracht in get <interfaceIp>om te zien welke protocollen al worden gebruikt op deze interface.

  3. Voer de opdracht in add <interfaceIp> TLSv1.2om ervoor te zorgen dat de interface TLS 1.2 kan gebruiken bij communicatie met de cloud.

De TLS-coderingsconfiguratie op de CTI-interface bewerken

Om de vereiste cijfers op de CTI-interface te configureren:

  1. Meld u aan bij de XSP|ADP en navigeer naar XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Voer de getopdracht in om te zien welke cijfers al worden gebruikt op deze interface. Er moet minstens één van de door Cisco aanbevolen suites zijn (zie de Identiteits- en beveiligingsvereisten van XSP|ADP in de sectie Overzicht).

  3. Voer de opdracht in add <interfaceIp> <cipherName>om een cijfer toe te voegen aan de CTI-interface.

    De XSP|ADP CLI vereist de naam van de standaard IANA-coderingssuite, niet de naam van de OpenSSL-coderingssuite. Als u bijvoorbeeld het OpenSSL-cijfer ECDHE-ECDSA-CHACHA20-POLY1305aan de CTI-interface wilt toevoegen, gebruikt u: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Ga naar https://ciphersuite.info/ om de suite met een van beide namen te vinden.

Trust Anchors voor CTI Interface (R22 en hoger)

Bij deze procedure wordt ervan uitgegaan dat de XSP|ADP's ofwel naar het internet zijn gericht, ofwel via een pass-through proxy naar het internet kijken. De certificaatconfiguratie is anders voor een overbruggingsproxy (zie TLS-certificaatvereisten voor TLS-Bridge Proxy).

Voor elke XSP|ADP in uw infrastructuur die CTI-gebeurtenissen naar Webex publiceert, doet u het volgende:

  1. Meld u aan bij Partner Hub.

  2. Ga naar Services > Aanvullende links en klik op Webex CA-certificaat downloaden om toegang te krijgen CombinedCertChain2023.txttot uw lokale computer.

    Deze bestanden bevatten twee sets van twee certificaten. U moet de bestanden splitsen voordat u ze naar de XSP|adps uploadt. Alle bestanden zijn vereist.

  3. De certificaatketen opsplitsen in twee certificaten - combinedcertchain2023.txt

    1. Open combinedcertchain2023.txtin een teksteditor.

    2. Selecteer en knip het eerste tekstblok, inclusief de regels -----BEGIN CERTIFICATE-----en -----END CERTIFICATE-----, en plak het tekstblok in een nieuw bestand.

    3. Sla het nieuwe bestand op als root2023.txt.

    4. Sla het originele bestand op als issuing2023.txt. Het originele bestand zou nu maar één blok tekst moeten bevatten, omgeven door de regels -----BEGIN CERTIFICATE-----en -----END CERTIFICATE-----.

  4. Kopieer beide tekstbestanden naar een tijdelijke locatie op de XSP|ADP die u aan het beveiligen bent, bijv. en /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

  5. Meld u aan bij de XSP|ADP en navigeer naar /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Optioneel) Voer uit help updateTrustom de parameters en het formaat van de opdracht te zien.

  7. Upload de certificaatbestanden naar nieuwe vertrouwensankers - 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 aliassen moeten een andere naam hebben. webexclientroot2023, en webexclientissuing2023zijn bijvoorbeeld aliassen voor de vertrouwensankers; u kunt uw eigen alias gebruiken zolang alle vermeldingen uniek zijn.

  8. Bevestig dat de ankers zijn bijgewerkt:

    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. Klanten toestaan zich te authenticeren met certificaten:

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

CTI-interface toevoegen en MTL's inschakelen

  1. Voeg de CTI SSL-interface toe.

    De CLI-context is afhankelijk van uw BroadWorks-versie. De opdracht creëert een zelfondertekend servercertificaat op de interface en dwingt de interface om een clientcertificaat te vereisen.

    • Op BroadWorks R22 en R23:

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

  2. Vervang het servercertificaat en de sleutel op de CTI-interfaces van de XSP|ADP. Hiervoor hebt u het IP-adres van de CTI-interface nodig; u kunt het uit de volgende context aflezen:

    • Op BroadWorks R22 en R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Voer vervolgens de volgende opdrachten uit om het zelfondertekende certificaat van de interface te vervangen door uw eigen certificaat en privésleutel:

      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. Start de XSP|ADP opnieuw.

Toegang tot BroadWorks CTI-gebeurtenissen op Webex inschakelen

U moet de CTI-interface toevoegen en valideren wanneer u uw clusters in Partner Hub configureert. Zie Uw partnerorganisatie configureren in Partner Hub voor gedetailleerde instructies.

  • Geef het CTI-adres op waarmee Webex zich kan abonneren op BroadWorks CTI-evenementen.

  • CTI-abonnementen zijn per abonnee en worden alleen ingesteld en onderhouden zolang die abonnee beschikbaar is voor Webex for Cisco BroadWorks.

Vond u dit artikel nuttig?
Vond u dit artikel nuttig?