为 CTI 订阅配置应用程序服务器

使用适用于 Cisco BroadWorks CTI 的 Webex CTI 客户端证书的通用名称 (CN) 更新应用服务器上的 ClientIdentity。

对于您在 Webex 中使用的每个应用程序服务器，将证书身份添加到 ClientIdentity 中，如下所示：

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

在 CTI 接口上配置 TLS 和密码

XSP|ADP CTI 接口的可配置级别如下：

最通用 = 系统 > 传输 > CTI 接口 > CTI 接口 = 最具体

用于查看或 修改不同 SSL 设置的 CLI 上下文是：

读取 XSP|ADP 上的 CTI TLS 接口配置

1. 登录 XSP|ADP 并导航至 XSP|ADP_CLI/Interface/CTI/CTIServer>

2. 输入get命令并读取结果。 您应该看到接口（IP 地址），以及每个接口（IP 地址）是否需要服务器证书以及是否需要客户端身份验证。

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

向 CTI 接口添加 TLS 1.2 协议

必须为 TLS v1.2 配置与 Webex Cloud 交互的 XSP|ADP CTI 接口。 云不协商 TLS 协议的早期版本。

要在 CTI 接口上配置 TLSv1.2 协议，请执行以下操作：

1. 登录 XSP|ADP 并导航至 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

2. 输入命令get <interfaceIp>以查看该接口上已经使用了哪些协议。

3. 输入命令add <interfaceIp> TLSv1.2以确保接口在与云通信时可以使用 TLS 1.2。

在 CTI 接口上编辑 TLS 密码配置

要在 CTI 接口上配置所需的密码，请执行以下操作：

1. 登录 XSP|ADP 并导航至 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

2. 输入get命令以查看该接口 上已经使用了哪些密码。 思科推荐套件中必须至少有一个（请参阅 “概述” 部分中的 XSP|ADP 身份和安全 要求）。

3. 输入命令add <interfaceIp> <cipherName>向 CTI 接口添加密码。

   XSP|ADP CLI 需要的是 IANA 标准密码套件名称，而不是 OpenSSL 密码套件名称。 例如，要将 OpenSSL 密码添加 ECDHE-ECDSA-CHACHA20-POLY1305到 CTI 接口， 应使用： XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers> add 192.0.2.7 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

   要按任一名称查找该套房，请参阅 https://ciphersuite.info/。

CTI 接口的信任锚点（R22 及更高版本）

此过程假定 XSP|ADP 要么面向互联网，要么通过直通代理面对互联网。 桥接 代理的证书配置不同（请参阅 TLS-Bridge 代理的 TLS 证书要求）。

对于基础设施中向 Webex 发布 CTI 事件的每个 XSP|ADP，请执行以下操作：

1. 登录合作伙伴中心。

2. 转至 “服务” > “其他链接”，然后单击 “下载 Webex CA 证书” 以访问您的本地计算机。CombinedCertChain2023.txt

   这些文件包含两组两个证书。 在将文件 上传到 XSP|ADPs 之前，您需要对其进行拆分。 所有文件均为必填文件。

3. 将证书链拆分为两个证书-combinedcertchain2023.txt

   1. combinedcertchain2023.txt在文本编辑器中打开。

   2. 选择并剪切第一个文本块，包括行-----BEGIN CERTIFICATE-----和 -----END CERTIFICATE-----，然后将该文本块粘贴到新文件中。

   3. 将新文件另存为root2023.txt。

   4. 将原始文件另存为issuing2023.txt。 现在，原始文件应该只有一个文本块，由行-----BEGIN CERTIFICATE-----和包围-----END CERTIFICATE-----。

4. 将两个文本文件复制到您正在保护的 XSP|ADP 上的临时位置，例如和 /var/broadworks/tmp/root2023.txt /var/broadworks/tmp/issuing2023.txt

5. 登录 XSP|ADP 并导航至 /XSP|ADP_CLI/Interface/CTI/SSLCommonSettings/ClientAuthentication/Trusts>

6. （可选）运行help updateTrust以查看参数和命令格式。

7. 将证书文件上传到新的信任锚点-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

   所有别名必须使用不同的名称。webexclientroot2023，并且webexclientissuing2023是信任锚的示例别名；只要所有条目都是唯一的，您就可以使用自己的别名。

8. 确认锚点已更新：

   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. 允许客户端使用证书进行身份验证：

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

添加 CTI 接口并启用 mTLS

1. 添加 CTI SSL 接口。

   CLI 上下文取决于您的 BroadWorks 版本。 该命令在接口上创建自签名的服务器证书，并强制接口要求客户端证书。

   • 在 BroadWorks R22 和 R23 上：

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

2. 更换 XSP|ADP 的 CTI 接口上的服务器证书和密钥。 为此，你 需要 CTI 接口的 IP 地址；你可以从 以下上下文中读取：

   • 在 BroadWorks R22 和 R23 上：

     XSP|ADP_CLI/Interface/CTI/CTIServer> get

     然后运行以下命令将接口的自签名证书替换为你自己的证书和私钥：

     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. 重新启动 XSP|ADP。

允许在 Webex 上访问 BroadWorks CTI 活动

在 P artner Hub 中配置集群时， 需要添加和验证 CTI 接口。 有关 详细说明，请参阅在 Partner Hub 中配置您的合作伙伴组织。

• 指定 Webex 订阅 BroadWorks CTI 活动时可用的 CTI 地址。

• CTI 订阅以每位订阅者为基础，只有在该订阅者为思科 BroadWorks 版 Webex 提供服务时才能建立和维 护。