Configurar o servidor de aplicativos para assinaturas CTI

Atualize a ClientIdentity no servidor de aplicativos com o nome comum (CN) do certificado de cliente Webex for Cisco BroadWorks CTI.

Para cada servidor de aplicativos que você está usando com o Webex, adicione a identidade do certificado à ClientIdentity da seguinte forma:

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

Configurar TLS e cifras na interface CTI

Os níveis de configurabilidade da interface XSP|ADP CTI são os seguintes:

Mais geral = Sistema > Transporte > Interfaces CTI > Interface CTI = Mais específico

Os contextos da CLI que você usa para visualizar ou modificar as diferentes configurações de SSL são:

Lendo a configuração da interface CTI TLS no XSP|ADP

1. Faça login no XSP|ADP e navegue até XSP|ADP_CLI/Interface/CTI/CTIServer>

2. Digite o getcomando e leia os resultados. Você deve ver as interfaces (endereços IP) e, para cada uma, se elas exigem um certificado de servidor e se exigem autenticação do 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
   

Adicionando o protocolo TLS 1.2 à interface CTI

A interface CTI XSP|ADP que está interagindo com o Webex Cloud deve ser configurada para TLS v1.2. A nuvem não negocia versões anteriores do protocolo TLS.

Para configurar o protocolo TLSv1.2 na interface CTI:

1. Faça login no XSP|ADP e navegue até XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

2. Digite o comando get <interfaceIp>para ver quais protocolos já estão sendo usados nessa interface.

3. Insira o comando add <interfaceIp> TLSv1.2para garantir que a interface possa usar o TLS 1.2 ao se comunicar com a nuvem.

Editando a configuração de cifras TLS na interface CTI

Para configurar as cifras necessárias na interface CTI:

1. Faça login no XSP|ADP e navegue até XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

2. Digite o getcomando para ver quais cifras já estão sendo usadas nessa interface. Deve haver pelo menos uma das suítes recomendadas pela Cisco (consulte Requisitos de identidade e segurança XSP|ADP na seção Visão geral).

3. Digite o comando add <interfaceIp> <cipherName>para adicionar uma cifra à interface CTI.

   A CLI do XSP|ADP exige o nome do conjunto de cifras padrão da IANA, não o nome do conjunto de cifras OpenSSL. Por exemplo, para adicionar a cifra OpenSSL ECDHE-ECDSA-CHACHA20-POLY1305à interface CTI, você usaria: XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

   Consulte https://ciphersuite.info/ para encontrar a suíte com qualquer um dos nomes.

Âncoras de confiança para interface CTI (R22 e versões posteriores)

Esse procedimento pressupõe que o XSP|ADPS esteja voltado para a Internet ou voltado para a Internet por meio de um proxy de passagem. A configuração do certificado é diferente para um proxy de ponte (consulte Requisitos de certificado TLS para proxy TLS de ponte).

Para cada XSP|ADP em sua infraestrutura que está publicando eventos de CTI no Webex, faça o seguinte:

1. Faça login no Partner Hub.

2. Vá para Serviços > Links adicionais e clique em Baixar o certificado Webex CA para acessar seu CombinedCertChain2023.txtcomputador local.

   Esses arquivos contêm dois conjuntos de dois certificados. Você precisa dividir os arquivos antes de enviá-los para o XSP|ADPS. Todos os arquivos são obrigatórios.

3. Divida a cadeia de certificados em dois certificados - combinedcertchain2023.txt

   1. Abra combinedcertchain2023.txtem um editor de texto.

   2. Selecione e recorte o primeiro bloco de texto, incluindo as linhas -----BEGIN CERTIFICATE-----e -----END CERTIFICATE-----, e cole o bloco de texto em um novo arquivo.

   3. Salve o novo arquivo como root2023.txt.

   4. Salve o arquivo original como issuing2023.txt. O arquivo original agora deve ter apenas um bloco de texto, cercado pelas linhas -----BEGIN CERTIFICATE----------END CERTIFICATE-----e.

4. Copie os dois arquivos de texto para um local temporário no XSP|ADP que você está protegendo, por exemplo, e /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

5. Faça login no XSP|ADP e navegue até /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

6. (Opcional) Execute help updateTrustpara ver os parâmetros e o formato do comando.

7. Carregue os arquivos do certificado para novas âncoras de confiança - 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

   Todos os aliases devem ter um nome diferente. webexclientroot2023, e webexclientissuing2023são exemplos de aliases para as âncoras de confiança; você pode usar os seus próprios, desde que todas as entradas sejam exclusivas.

8. Confirme se as âncoras estão atualizadas:

   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. Permita que os clientes se autentiquem com certificados:

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

Adicionar interface CTI e ativar mTLS

1. Adicione a interface CTI SSL.

   O contexto da CLI depende da sua versão do BroadWorks. O comando cria um certificado de servidor autoassinado na interface e força a interface a exigir um certificado de cliente.

   • No BroadWorks R22 e R23:

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

2. Substitua o certificado e a chave do servidor nas interfaces CTI do XSP|ADP. Você precisa do endereço IP da interface CTI para isso; você pode lê-lo no seguinte contexto:

   • No BroadWorks R22 e R23:

     XSP|ADP_CLI/Interface/CTI/CTIServer> get

     Em seguida, execute os seguintes comandos para substituir o certificado autoassinado da interface pelo seu próprio certificado e chave 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>

3. Reinicie o XSP|ADP.

Habilitar o acesso aos eventos BroadWorks CTI no Webex

Você precisa adicionar e validar a interface CTI ao configurar seus clusters no Partner Hub. Consulte Configurar sua organização parceira no Partner Hub para obter instruções detalhadas.

• Especifique o endereço CTI pelo qual o Webex pode se inscrever nos eventos CTI da BroadWorks.

• As assinaturas CTI são por assinante e só são estabelecidas e mantidas enquanto esse assinante é provisionado para o Webex for Cisco BroadWorks.