CTI-grænsefladekonfiguration til Webex-integration

list-menuHar du feedback?
Lær at konfigurere CTI-grænseflade, MTLS-godkendelse og sikre hændelsesabonnementer til Webex og BroadWorks.

CTI-grænseflade og relateret konfiguration

Konfigurationsrækkefølgen „inderst til yderste“ er angivet nedenfor. Det er ikke obligatorisk at følge denne ordre.

  1. Konfigurer applikationsserver til CTI-abonnementer

  2. Konfigurere XSP|ADP'er til MTLS-godkendte CTI-abonnementer

  3. Åbn indgående porte til sikker CTI-grænseflade

  4. Abonner din Webex-organisation på BroadWorks CTI-begivenheder

Konfigurer applikationsserver til CTI-abonnementer

Opdater ClientIdentity on Application Server med fællesnavnet (CN) på Webex for Cisco BroadWorks CTI-klientcertifikatet.

For hver applikationsserver, du bruger med Webex, skal du tilføje certifikatidentiteten til ClientIdentity som følger:

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

Det almindelige navn på Webex til Cisco BroadWorks-klientcertifikatet er. bwcticlient.webex.com

Konfigurer TLS og krypteringer på CTI-grænsefladen

Konfigurationsniveauerne for XSP|ADP CTI-grænsefladen er som følger:

Mest generelle = System > Transport > CTI-grænseflader > CTI-grænseflade = Mest specifik

De CLI-kontekster, du bruger til at se eller ændre de forskellige SSL-indstillinger, er:

Specificitet

CLI-kontekst

System (globalt)

(R22 og senere)

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

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

Transport protokoller til dette system

(R22 og senere)

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

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

Alle CTI-grænseflader på dette system

(R22 og senere)

XSP| ADP_CLI /Grænseflade/CTI/SSLCommonSettings/Ciphers >

XSP| ADP_CLI /Grænseflade/CTI/SSLCommonIndstillinger/Protokoller >

En specifik CTI-grænseflade på dette system

(R22 og senere)

XSP| ADP_CLI /Grænseflade/CTI/CTIServer/SSLIndstillinger/Chiffer >

XSP| ADP_CLI /Grænseflade/CTI/CTIServersslSettings/Protokoller >

Ved en ny installation installeres følgende chiffer som standard på systemniveau. Hvis der ikke er konfigureret noget på grænsefladeniveau (f.eks. ved CTI-grænsefladen eller HTTP-grænsefladen), gælder denne chifferliste. Bemærk, at denne liste kan ændre sig over 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æsning af CTI TLS-grænsefladekonfiguration på XSP|ADP

  1. Log ind på XSP|ADP og naviger til XSP|ADP_CLI/Interface/CTI/CTIServer>

  2. Indtast getkommandoen og læs resultaterne. Du skal se grænsefladerne (IP-adresser) og for hver af dem, om de kræver et servercertifikat, og om de kræver klientgodkendelse.

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

Tilføjelse af TLS 1.2-protokol til CTI-grænsefladen

XSP|ADP CTI-grænsefladen, der interagerer med Webex Cloud, skal konfigureres til TLS v1.2. Skyen forhandler ikke tidligere versioner af TLS- protokollen.

Sådan konfigureres TLSv1.2-protokollen på CTI-grænsefladen:

  1. Log ind på XSP|ADP og naviger til XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

  2. Indtast kommandoen get <interfaceIp>for at se, hvilke protokoller der allerede bruges på denne grænseflade.

  3. Indtast kommandoen add <interfaceIp> TLSv1.2for at sikre, at grænsefladen kan bruge TLS 1.2, når du kommunikerer med skyen.

Redigering af TLS-chifferkonfiguration på CTI-grænsefladen

Sådan konfigureres de nødvendige chiffer på CTI-grænsefladen:

  1. Log ind på XSP|ADP og naviger til XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

  2. Indtast getkommandoen for at se, hvilke chiffer der allerede bruges på denne grænseflade. Der skal være mindst én af de Ciscos anbefal ede pakker (se XSP|ADP-identitets- og sikkerhed skrav i oversigtsafsnittet).

  3. Indtast kommandoen add <interfaceIp> <cipherName>for at tilføje en chiffer til CTI-grænsefladen.

    XSP|ADP CLI kræver IANA-standardkrypteringspakkenavnet, ikke navnet på OpenSSL-krypteringspakken. Hvis du f.eks. vil føje OpenSSL-krypteringen ECDHE-ECDSA-CHACHA20-POLY1305til CTI-grænsefladen, skal du bruge: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

    Se https://ciphersuite.info/ for at finde suiten ved begge navne.

Tillidsankre til CTI-grænseflade (R22 og nyere)

Denne procedure forudsætter, at XSP|ADP'erne enten er internetvendte eller vender mod internettet via pass-through proxy. Certifikatkonfigurationen er forskellig for en bro- proxy (se TLS-certifikatkrav til TLS- broproxy).

For hver XSP|ADP i din infrastruktur, der udgiver CTI-begivenheder til Webex, skal du gøre følgende:

  1. Log ind på Partner Hub.

  2. Gå til Services > Yderligere links, og klik på Download Webex CA-certifikat for at komme CombinedCertChain2023.txtpå din lokale computer.

    Disse filer indeholder to sæt af to certifikater. Du skal opdele filerne, før du uploader dem til XSP|ADP'erne. Alle filer er påkrævet.

  3. Opdel certifikatkæden i to certifikater - combinedcertchain2023.txt

    1. Åbn combinedcertchain2023.txti en teksteditor.

    2. Vælg og klip den første tekstblok, inklusive linjerne -----BEGIN CERTIFICATE-----og -----END CERTIFICATE-----, og indsæt tekstblokken i en ny fil.

    3. Gem den nye fil som root2023.txt.

    4. Gem den originale fil som issuing2023.txt. Den originale fil skal nu kun have en tekstblok, omgivet af linjerne -----BEGIN CERTIFICATE-----og -----END CERTIFICATE-----.

  4. Kopier begge tekstfiler til en midlertidig placering på den XSP|ADP, du sikrer, f.eks. og /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

  5. Log ind på XSP|ADP og naviger til /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

  6. (Valgfrit) Kør help updateTrustfor at se parametrene og kommandoformatet.

  7. Upload certifikatfilerne til nye tillidsankre - 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 aliaser skal have et andet navn. webexclientroot2023, og webexclientissuing2023er eksempler på aliaser for tillidsankre; du kan bruge dine egne, så længe alle poster er unikke.

  8. Bekræft, at ankre er opdateret:

    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. Tillad klienter at godkende med certifikater:

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

Tilføj CTI-grænseflade og aktiver MTL'er

  1. Tilføj CTI SSL-grænsefladen.

    CLI-konteksten afhænger af din BroadWorks-version. Kommandoen opretter et selvsigneret servercertifikat på grænsefladen og tvinger grænsefladen til at kræve et klientcertifikat.

    • På BroadWorks R22 og R23:

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

  2. Udskift servercertifikatet og nøglen på XSP|ADP's CTI-grænseflader. Du har brug for IP-adressen på CTI-grænsefladen til dette; du kan læse den fra følgende kontekst:

    • På BroadWorks R22 og R23:

      XSP|ADP_CLI/Interface/CTI/CTIServer> get

      Kør derefter følgende kommandoer for at erstatte grænsefladens selvsignerede certifikat med dit eget certifikat og private nøgle:

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

Aktivér adgang til BroadWorks CTI-begivenheder på Webex

Du skal tilføje og validere CTI-grænsefladen, når du konfigurerer dine klynger i Partner Hub. Se Konfigurere din partnerorganisation i Partner Hub for detaljerede instruktioner.

  • Angiv den CTI-adresse, hvormed Webex kan abonnere på BroadWorks CTI Events.

  • CTI-abonnementer er pr. abonnent og etableres og vedligeholdes kun, mens denne abonnent er klargjort til Webex til Cisco BroadWorks.

Var denne artikel nyttig?
Var denne artikel nyttig?