Configuración de la interfaz CTI para la integración de Webex
Interfaz CTI y configuración relacionada

El orden de configuración “de lo más bajo a lo más avanzado” se enumera a continuación. Seguir esta orden no es obligatorio.
-
Configurar el servidor de aplicaciones para las suscripciones de CTI
-
Configurar XSP|ADP para suscripciones CTI autenticadas por MTLs
-
Puertos de entrada abiertos para una interfaz CTI segura
-
Suscriba su organización Webex a los eventos CTI de BroadWorks
Configurar el servidor de aplicaciones para las suscripciones de CTI
Actualice la Identidad del cliente en el servidor de aplicaciones con el nombre común (CN) del certificado de cliente de Webex para Cisco BroadWorks CTI.
Para cada servidor de aplicaciones que esté utilizando con Webex, agregue la identidad del certificado a ClientIdentity de la siguiente manera:
AS_CLI/System/ClientIdentity> add bwcticlient.webex.com
El nombre común del certificado de cliente Webex para Cisco BroadWorks es. bwcticlient.webex.com
Configurar TLS y cifrados en la interfaz CTI
Los niveles de configurabilidad para la interfaz XSP|ADP CTI son los siguientes:
Más general = Sistema > Transporte > Interfaces CTI > Interfaz CTI = Más específico
Los contextos CLI que utiliza para ver o modificar las diferentes configuraciones SSL son:
|
Especificidad |
Contexto CLI |
|---|---|
|
Sistema (global) (R22 y posterior) |
XSP|/System/SSLCommonSettings/JSSE/Cifrados > ADP_CLI XSP|/System/SSLCommonSettings/JSSE/Protocolos > ADP_CLI |
|
Protocolos de transporte para este sistema (R22 y posterior) |
XSP | /Sistema/Configuración común SSL/OpenSSL/Cifrados > ADP_CLI XSP | /Sistema/Configuración común de SSL/OpenSSL/Protocolos > ADP_CLI |
|
Todas las interfaces CTI en este sistema (R22 y posterior) |
XSP| ADP_CLI /Interface/CTI/SSLConfiguración común/Cifrados > XSP|/Interface/CTI/SSLConfiguración común/Protocolos > ADP_CLI |
|
Una interfaz CTI específica en este sistema (R22 y posterior) |
XSP| ADP_CLI /Interface/CTI/CTIServer/SSLSettings/Ciphers > XSP | /Interface/CTI/CTIServerVersSLConfiguración/Protocolos > ADP_CLI |
En una instalación nueva, los siguientes cifrados se instalan de forma predeterminada en el nivel del sistema. Si no se configura nada en el nivel de interfaz (por ejemplo, en la interfaz CTI o la interfaz HTTP), se aplica esta lista de cifrado. Tenga en cuenta que esta lista puede cambiar con el tiempo:
-
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
Lectura de la configuración de la interfaz CTI TLS en el XSP|ADP
-
Inicie sesión en el XSP|ADP y navegue hasta
XSP|ADP_CLI/Interface/CTI/CTIServer> Escriba el
getcomando y lea los resultados. Debería ver las interfaces (direcciones IP) y, para cada una, si requieren un certificado de servidor y si requieren autenticación de cliente.XSP|ADP_CLI/Interface/CTI/CTIServer> get Interface IP Port Secure Server Certificate Client Auth Req ================================================================= 10.155.6.175 8012 true true true
Agregar el protocolo TLS 1.2 a la interfaz CTI
La interfaz XSP|ADP CTI que interactúa con Webex Cloud debe configurarse para TLS v1.2. La nube no negocia versiones anteriores del protocolo TLS.
Para configurar el protocolo TLSv1.2 en la interfaz CTI:
-
Inicie sesión en el XSP|ADP y navegue hasta
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols> -
Introduzca el comando
get <interfaceIp>para ver qué protocolos ya se utilizan en esta interfaz. -
Introduzca el comando
add <interfaceIp> TLSv1.2para asegurarse de que la interfaz pueda usar TLS 1.2 cuando se comunique con la nube.
Edición de la configuración de cifrados TLS en la interfaz CTI
Para configurar los cifrados requeridos en la interfaz CTI:
-
Inicie sesión en el XSP|ADP y navegue hasta
XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> -
Escriba el
getcomando para ver qué cifrados ya se utilizan en esta interfaz. Debe haber al menos una de las suites recomendadas por Cisco (consulte Requisitos de identidad y seguridad de XSP|ADP en la sección Descripción general). -
Escriba el comando
add <interfaceIp> <cipherName>para agregar un cifrado a la interfaz CTI.La CLI XSP|ADP requiere el nombre del conjunto de cifrado estándar de IANA, no el nombre del conjunto de cifrado OpenSSL. Por ejemplo, para agregar el cifrado OpenSSL
ECDHE-ECDSA-CHACHA20-POLY1305a la interfaz CTI, usaría:XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305Consulte https://ciphersuite.info/ para encontrar la suite con cualquier nombre.
Anclas de confianza para la interfaz CTI (R22 y posterior)
Este procedimiento supone que los XSP|ADP están conectados a Internet o están orientados a Internet a través de un proxy de paso. La configuración del certificado es diferente para un proxy puente (consulte Requisitos de certificado TLS para proxy TLS Bridge).
Para cada XSP|ADP de su infraestructura que publique eventos CTI en Webex, haga lo siguiente:
-
Inicie sesión en Partner Hub.
-
Vaya a Servicios > Enlaces adicionales y haga clic en Descargar certificado de Webex CA para acceder a su
CombinedCertChain2023.txtcomputadora local.Estos archivos contienen dos conjuntos de dos certificados. Necesita dividir los archivos antes de subirlos al XSP|ADP. Todos los archivos son necesarios.
-
Dividir la cadena de certificados en dos certificados -
combinedcertchain2023.txt-
Abrir
combinedcertchain2023.txten un editor de texto. -
Seleccione y corte el primer bloque de texto, incluidas las líneas
-----BEGIN CERTIFICATE-----y-----END CERTIFICATE-----, y pegue el bloque de texto en un archivo nuevo. -
Guarde el nuevo archivo como
root2023.txt. -
Guarde el archivo original como
issuing2023.txt. El archivo original ahora solo debería tener un bloque de texto, rodeado por las líneas-----BEGIN CERTIFICATE-----y-----END CERTIFICATE-----.
-
-
Copie ambos archivos de texto a una ubicación temporal en el XSP|ADP que está asegurando, por ejemplo, y
/var/broadworks/tmp/root2023.txt/var/broadworks/tmp/issuing2023.txt -
Inicie sesión en XSP|ADP y navegue hasta
/XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> -
(Opcional) Ejecute
help updateTrustpara ver los parámetros y el formato del comando. -
Cargue los archivos del certificado a nuevos anclajes de confianza - 2023
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientroot2023 /var/broadworks/tmp/root2023.txtXSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> updateTrust webexclientissuing2023 /var/broadworks/tmp/issuing2023.txtTodos los alias deben tener un nombre diferente.
webexclientroot2023, ywebexclientissuing2023son alias de ejemplo para los anclajes de confianza; puede usar los suyos siempre que todas las entradas sean únicas. -
Confirme que los anclajes están actualizados:
XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts> getAlias Owner Issuer ============================================================================= webexclientissuing2023 Internal Private TLS SubCA Internal Private Root webexclientroot2023 Internal Private Root Internal Private Root[self-signed] -
Permita que los clientes se autentiquen con certificados:
XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication> set allowClientApp true
Agregue la interfaz CTI y habilite los MTLs
-
Agregue la interfaz SSL de CTI.
El contexto de la CLI depende de su versión de BroadWorks. El comando crea un certificado de servidor autofirmado en la interfaz y obliga a la interfaz a requerir un certificado de cliente.
-
En BroadWorks R22 y R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> add <Interface IP> 8012 true true true
-
-
Reemplace el certificado y la clave del servidor en las interfaces CTI de XSP|ADP. Necesita la dirección IP de la interfaz CTI para esto; puede leerla en el siguiente contexto:
-
En BroadWorks R22 y R23:
XSP|ADP_CLI/Interface/CTI/CTIServer> getA continuación, ejecute los siguientes comandos para reemplazar el certificado autofirmado de la interfaz con su propio certificado y clave privada:
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>
-
-
Reinicie el XSP|ADP.
Habilitar el acceso a eventos CTI de BroadWorks en Webex
Necesita agregar y validar la interfaz CTI cuando configure sus clústeres en Partner Hub. Consulte Configurar su organización asociada en Partner Hub para obtener instrucciones detalladas.
-
Especifique la dirección CTI mediante la cual Webex puede suscribirse a BroadWorks CTI Events.
-
Las suscripciones de CTI son por suscriptor y solo se establecen y mantienen mientras ese suscriptor se aprovisiona para Webex para Cisco BroadWorks.