感谢您的反馈。

共驻要求

• 身份验证服务必须与 Xsi 应用程序共驻，因为这些接口必须接受长效令牌才能进行服务授权。需要身份验证服务才能验证这些令牌。

• 如有必要，身份验证服务和 Xsi 可以在同一端口上运行。

• 你可以把其他部分分开。 services/applications 根据您的规模需要（例如，专用设备管理 XSP|ADP 集群）。

• 您可以将 Xsi、CTI、身份验证服务和 DMS 应用程序设在同地。

• 不要在用于将 BroadWorks 与 Webex 集成的 XSP|ADP 上安装其他应用程序或服务。

• 请勿将 NPS 应用程序与其他任何应用程序设在同地。

Xsi 接口

按照“Cisco BroadWorks Xtended 服务接口配置指南”中的描述安装和配置 Xsi-Actions 和 Xsi-Events 应用程序。

在用于 CTI 接口的 XSP|ADP 上，只能部署一个 Xsi-Events 应用程序实例。

所有用于将 Broadworks 与 Webex 集成的 Xsi 事件都必须具有相同的 callControlApplicationName 定义。 Applications/Xsi-Events/GeneralSettings. 例如：

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

当用户注册 Webex 时，Webex 会在 AS 上为该用户创建一个订阅，以便接收有关状态和通话记录的电话事件。订阅与 callControlApplicationName 相关联，AS 使用该名称来确定要将电话事件发送到哪些 Xsi-Events。

配置身份验证服务（使用 CI 令牌验证）

下列步骤用于将身份验证服务配置为通过 TLS 使用 CI 令牌验证。如果您使用的是 R22 或更高版本，并且您的系统支持，建议采用此身份验证方法。

1. 获取适用于 Cisco BroadWorks 的 Webex 的 OAuth 凭据。

2. 在每个 XSP|ADP 服务器上安装以下补丁。安装适合您发行版的补丁：

   • 对于 R22：

     AP.platform.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap376508

     AP.xsp.22.0.1123.ap368601

   • 对于 R23：

     AP.xsp.23.0.1075.ap376509

     AP.platform.23.0.1075.ap376509

   • 对于 R24 - 不需要补丁

   凡提及 XSP，均指 XSP 或 ADP。

3. 在每个 XSP|ADP 服务上安装 AuthenticationService 应用程序。

   1. 运行以下命令以在 XSP|ADP 上激活 AuthenticationService 应用程序 /authService 上下文路径。

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application AuthenticationService 22.0_1.1123/authService

   2. 运行此命令以在 XSP|ADP 上部署身份验证服务：

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /authServiceBroadWorks SW Manager deploying /authService...

4. 从 Broadworks 版本 2022.10 开始，切换到新版本的 Java 时，Java 自带的证书颁发机构不再自动添加到 BroadWorks 信任存储中。身份验证服务会打开与 Webex 的 TLS 连接以获取访问令牌，并且需要在其信任库中包含以下内容以验证 IDBroker 和 Webex URL：

   • IdenTrust Commercial Root CA 1

   • Go Daddy Root Certificate Authority - G2

   请使用以下 CLI 命令验证这些证书是否存在。

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> get

   如果不存在，请运行以下命令导入默认的 Java 信任：

   ADP_CLI/System/SSLCommonSettings/Trusts/Defaults> importJavaCATrust

   或者，您可以使用以下命令手动将这些证书添加为信任锚：

   ADP_CLI/System/SSLCommonSettings/Trusts/BroadWorks> updateTrust

   如果 ADP 是从以前的版本升级的，那么旧版本中的证书颁发机构会自动导入到新版本中，并且会一直导入，直到手动删除为止。

   AuthenticationService 应用程序不受 ADP_下的 validatePeerIdentity 设置的限制。 CLI/System/SSLCommonSettings/GeneralSettings, 并始终验证对等方身份。有关此设置的更多信息，请参阅 Cisco Broadworks X509 证书验证 FD 。

5. 在每个 XSP|ADP 服务器上运行以下命令来配置身份提供程序：

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco> get

   • set clientId client-Id-From-Step1

   • set enabled true

   • set clientSecret client-Secret-From-Step1

   • set ciResponseBodyMaxSizeInBytes 65536

   • set issuerName —对于 URL，请输入适用于您的 CI 集群的 IssuerName URL。请参见下表。

   • set issuerUrl —对于 URL，请输入适用于您的 CI 集群的 IssuerUrl。请参见下表。

   • set tokenInfoUrl —输入应用于 Teams 集群的 IdP 代理 URL。请参见下面的第二个表格。

   表1。 设置 issuerName 和 issuerURL

   如果 CI 集群是...	将 issuerName 和 issuerURL 设置为...
   US-A	https://idbroker.webex.com/idb
   欧盟	https://idbroker-eu.webex.com/idb
   US-B	https://idbroker-b-us.webex.com/idb
   CA	https://idbroker-ca.webex.com/idb
   SG	https://idbroker-sg.webex.com/idb
   IN	https://idbroker-in.webex.com/idb
   AE	https://idbroker-ae.webex.com/idb
   AU	https://idbroker-au.webex.com/idb
   如果您不知道您的 CI 集群，您可以从 Control Hub 的帮助台视图中的客户详细信息中获取信息。

   表 2. 设置 tokenInfoURL

   如果 Teams 集群是...	将 tokenInfoURL 设置为...（身份提供商代理 URL）
   ACHM	https://broadworks-idp-proxy-a.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AFRA	https://broadworks-idp-proxy-k.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   AORE	https://broadworks-idp-proxy-r.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   ADXB	https://broadworks-idp-proxy-d.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   附加系统	https://broadworks-idp-proxy-m.wbx2.com/broadworks-idp-proxy/api/v1/idp/authenticate
   如果您不知道您的 Teams 集群，您可以从 Control Hub 的帮助台视图中的客户详细信息中获取信息。 为了进行测试，您可以通过将 URL 中的“idp/authenticate”部分替换为“ping”来验证 tokenInfoURL 是否有效。

6. 通过运行以下命令指定 Webex 中用户档案中必须存在的 Webex 权限：

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Scopes> set scope broadworks-connector:user

7. 使用以下命令在每个 XSP|ADP 服务器上配置 Cisco Federation 的身份提供程序：

   XSP|ADP_CLI/Applications/AuthenticationService/IdentityProviders/Cisco/Federation> get

   • set flsUrl https://cifls.webex.com/federation

   • set refreshPeriodInMinutes 60

   • set refreshToken refresh-Token-From-Step1

8. 运行以下命令以验证您的 FLS 配置是否有效。该命令将返回身份提供程序列表：

   XSP|ADP_CLI/Applications/AuthService/IdentityProviders/Cisco/Federation/ClusterMap> Get

9. 在每个 XSP|ADP 服务器上使用以下命令配置令牌管理：

   • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

10. 生成并共享 RSA 密钥。您必须在一个 XSP|ADP 上生成密钥，然后将其复制到所有其他 XSP|ADP。这是由于以下因素：

    • 身份验证服务的所有实例必须使用相同的公钥/私钥对进行令牌加密/解密。

    • 首次收到颁发令牌要求时，身份验证服务会生成密钥对。

    如果您循环使用密钥或更改密钥长度，则需要重复以下配置并重新启动所有 XSP|ADP。

    1. 选择一个 XSP|ADP 用于生成密钥对。

    2. 使用客户端通过客户端浏览器请求以下 URL，向该 XSP|ADP 请求加密令牌：

       https:///authService/token?key=BASE64URL(clientPublicKey)

       （这将生成一个私有 / XSP|ADP 上的公钥对（如果之前没有的话）

    3. 密钥存储位置不可配置。导出密钥：

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. 将导出的文件 /var/broadworks/tmp/authService.keys 复制到其他 XSP|ADP 上的相同位置，如有必要，覆盖较旧的 .keys 文件。

    5. 将密钥导入其他每个 XSP|ADP：

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> importKeys /var/broadworks/tmp/authService.keys

11. 向 Web 容器提供 authService URL。XSP|ADP 的 Web 容器需要 authService URL 以便验证令牌。在每个 XSP|ADP 上：

    1. 添加身份验证服务 URL 作为 BroadWorks Communications Utility 的外部身份验证服务：

       XSP|ADP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/AuthService> set url http://127.0.0.1:80/authService

    2. 将身份验证服务 URL 添加到容器：

       XSP|ADP_CLI/Maintenance/ContainerOptions> add tomcat bw.authservice.authServiceUrl http://127.0.0.1:80/authService

       这样，Webex 即可使用身份验证服务来验证作为凭据提交的令牌。

    3. 检查参数是否为 get。

    4. 重启 XSP|ADP。

删除身份验证服务的客户端验证要求（仅适用于 R24）

如果您在 R24 上配置了带 CI 令牌验证的身份验证服务，则还需要删除身份验证服务的客户端验证要求。运行以下 CLI 命令：

ADP_CLI/Interface/Http/SSLCommonSettings/ClientAuthentication/WebApps> set AuthenticationService clientAuthReq false

在 HTTP 接口上配置 TLS 和密码（用于 XSI 和身份验证服务）

身份验证服务、Xsi-Actions 和 Xsi-Events 应用程序使用 HTTP 服务器接口。这些应用程序的 TLS 配置级别如下：

最一般 = 系统 > 传输 > HTTP > HTTP 服务器接口 = 最特殊

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

读取 XSP 上的 HTTP 服务器 TLS 接口配置|ADP

1. 登录 XSP|ADP 并导航至 XSP|ADP_CLI/Interface/Http/HttpServer>

2. 输入 get 命令并读取结果。您应看到接口（IP 地址），并分别查看是否安全以及是否需要客户端身份验证。

Apache tomcat 要求每个安全接口都有证书；如果需要，系统会生成自签名证书。

XSP|ADP_CLI/Interface/Http/HttpServer> get

将 TLS 1.2 协议添加到 HTTP 服务器接口

必须将与 Webex 云交互的 HTTP 接口配置为用于 TLSv1.2。云不会协商早期版本的 TLS 协议。

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

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

2. 输入命令 get 443 查看此接口上已使用的协议。

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

在 HTTP 服务器接口上编辑 TLS 密码配置

要配置所需的密码，请执行以下操作：

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

2. 输入命令 get 443 查看此接口上已使用的密码套件。必须至少包含 Cisco 推荐套件中的一个（请参阅概述部分中的 XSP|ADP 身份和安全要求 ）。

3. 输入命令 add 443 向 HTTP 服务器接口添加密码。

   XSP|ADP CLI 需要 IANA 标准密码套件名称，而不是 openSSL 密码套件名称。例如，要将 openSSL 密码套件 ECDHE-ECDSA-CHACHA20-POLY1305 添加到 HTTP 服务器接口，您可以使用： XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>add 192.0.2.7 443 TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305

   请参阅 https://ciphersuite.info/，以便按任一名称查找此套件。

在 XSP|ADP、应用服务器和配置文件服务器上配置设备管理

Profile Server 和 XSP|ADP 是设备管理所必需的。必须按照 BroadWorks 设备管理配置指南中的说明进行配置。

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

使用 Webex for Cisco BroadWorks CTI 客户端证书的公用名 (CN)，更新应用程序服务器上的 ClientIdentity。

对于 Webex 使用的每个应用服务器，使用以下命令将证书标识添加到 ClientIdentity 中：

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

在 CTI 接口上配置 TLS 和密码

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

最一般 = 系统 > 传输 > CTI > CTI 接口 = 最特殊

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

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

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

2. 输入 get 命令并读取结果。您应看到接口（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
   

将 TLS 1.2 协议添加到 CTI 接口

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

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

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

2. 输入命令 get 查看此接口上已使用的协议。

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

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

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

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

2. 输入 get 命令，查看此接口上已使用的密码套件。必须至少包含 Cisco 推荐套件中的一个（请参阅概述部分中的 XSP|ADP 身份和安全要求 ）。

3. 输入命令 add 向 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 桥接代理的 TLS 证书要求”）。

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

1. 登录合作伙伴中心。

2. 前往 服务 > 其他链接 并点击 下载 Webex CA 证书 以将 CombinedCertChain2023.txt 获取到您的本地计算机。

   这些文件包含两组证书，每组两份。在将文件上传到 XSP|ADP 之前，需要先拆分文件。所有文件均需提交。

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 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 keyFile certificateFile chainFile

3. 重启 XSP|ADP。

在 Webex 上启用 BroadWorks CTI 事件访问

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

• 指定 Webex 可订阅 BroadWorks CTI 事件的 CTI 地址。

• CTI 订阅按订阅者进行，并且只有在为该订阅者预配置 Webex for BroadWorks 时才会建立和维护 CTI 订阅。

用户体验

• Windows 用户：点击 通话设置 ，然后点击 打开通话偏好设置 > 高级通话设置。

• Mac 用户：点击个人资料图片，然后点击 偏好设置 > 高级通话设置。

在 XSP|ADPs 上安装呼叫设置 Webview

CSWV 应用程序必须位于您环境中托管 Xsi-Actions 接口的同一 XSP|ADP(s) 上。这是一个基于 XSP|ADP 的非托管应用程序，因此您需要安装和部署 Web 归档文件。

1. 登录 cisco.com，在软件下载部分搜索“BWCallSettingsWeb”。

2. 查找并下载文件的最新版本。

   例如， BWCallSettingsWeb_1.8.2_1.war ( https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04) 是撰写本文时最新的。

3. 根据 Cisco BroadWorks Xtended Service Platform 配置指南，针对您的 XSP|ADP 版本安装、激活和部署 Web 归档。（R24 版本为 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf）。

   1. 将 .war 文件复制到 XSP|ADP 上的临时位置，例如 /tmp/。

   2. 导航至以下 CLI 上下文并运行安装命令：

      XSP|ADP_CLI/Maintenance/ManagedObjects> install application /tmp/BWCallSettingsWeb_1.7.5_1.war

      BroadWorks 软件管理器会验证并安装文件。

   3. [Optional] 删除 /tmp/BWCallSettingsWeb_1.7.5_1.war （此文件不再需要）。

   4. 激活应用程序：

      XSP|ADP_CLI/Maintenance/ManagedObjects> activate application BWCallSettingsWeb 1.7.5 /callsettings

      任何应用程序的名称和版本都是必填的，但是对于 CSWV，还必须提供 contextPath，因为它不是托管应用程序。您可以使用任何其他应用程序未使用的值，例如 /callsettings。

   5. 在选定的上下文路径上部署呼叫设置应用程序：

      XSP|ADP_CLI/Maintenance/ManagedObjects> deploy application /callsettings

4. 现在可以预测将为客户指定的呼叫设置 URL，如下所示：

   https:///callsettings/

   注意：

   • 当您在客户端配置文件中输入此 URL 时，必须输入结尾的斜杠。

   • XSP|ADP-FQDN 必须与 Xsi-Actions FQDN 匹配，因为 CSWV 需要使用 Xsi-Actions，并且不支持 CORS。

   • 请确保在每个托管 CSWV 的 ADP 或 XSP 的 HttpAlias 中添加 ： ADP_CLI/Interface/Http/HttpAlias>

5. 对 Webex for Cisco BroadWorks 环境中的其他 XSP|ADP 重复此过程（如有必要）。

呼叫设置 Webview 应用程序现已在 XSP|ADP 上激活。

NPS 代理概述

为了与 Webex for Cisco BroadWorks 兼容，必须对 CNPS 打补丁以支持 NPS 代理功能，即 UCaaS 中用于 VoIP 的推送服务器。

该功能在通知推送服务器中实现了新的设计，可解决与移动客户端的服务商共享推送通知证书私钥的安全漏洞。NPS 不再与服务商共享推送通知证书和密钥，而是使用新 API 从 Webex for Cisco BroadWorks 后端获取短效推送通知令牌，并使用此令牌向 Apple APNS 和 Google FCM 服务进行身份验证。

此功能还增强了通知推送通过新的 Google Firebase Cloud Messaging (FCM) HTTPv1 API 向 Android 设备推送通知的功能。

• 有关更多信息，请参阅 UCaaS 中用于 VoIP 的推送服务器功能说明。

• 该功能的 BroadWorks 补丁可在以下位置找到： https://software.cisco.com/download/home/286326302/type/286326345/release/RI.2022.04。

  有关 NPS 软件和补丁，请参阅 为 Cisco BroadWorks 的 Webex 准备 NPS部分。

  从软件下载页面搜索并下载补丁。

• 有关 ADP 服务器的更多信息，请访问 Cisco BroadWorks 应用交付平台。

配置 BroadWorks 集群

[每个集群一次]

进行此操作的原因如下：

• 要使 Webex 云能够通过 XSP|ADP 托管的身份验证服务，针对 BroadWorks 对您的用户进行身份验证。

• 要启用 Webex 应用程序以便使用 Xsi 接口进行呼叫控制。

• 要允许 Webex 侦听 BroadWorks 发布的 CTI 事件（电话在线状态和呼叫历史记录）。

您需要进行的操作：

1. 登录 Partner Hub：admin.webex.com。

2. 从侧边菜单打开 服务 页面，找到 其他链接 卡片。

   如果管理员用户看不到 附加链接 卡，建议您向 Cisco TAC 开具案例。

3. 单击 Add Cluster（添加集群）。

   这将启动一个向导，您可以在其中提供您的 XSP|ADP 接口（URL）。如果您使用非标准端口，可以将端口添加到接口 URL。

4. 为此集群命名，然后单击 Next（下一步）。

   这里所说的集群概念其实就是一组接口，通常位于 XSP|ADP 服务器或集群上，使 Webex 能够从您的应用程序服务器 (AS) 读取信息。每个 AS 集群可以有一个 XSP|ADP，或者每个集群有多个 XSP|ADP，或者每个 XSP|ADP 有多个 AS 集群。此处已超出 BroadWorks 系统的扩展要求。

5. （可选）输入您用于连接到 Webex 的 BroadWorks 系统中的 BroadWorks 用户帐户名和密码，然后单击 Next（下一步）。

   验证测试可以使用该帐户来验证与集群中接口的连接。

6. 添加您的 XSI 操作和 XSI 事件 URL。

7. 可选。将 DAS URL 更新为设备激活服务的 URL。

8. 可选。如果您希望 BroadWorks 登录直接通过 BroadWorks 进行，请选中 启用 BroadWorks 直接身份验证 复选框。否则，对 BroadWorks 的身份验证将通过 Webex 托管的 IdP 代理服务进行代理。

   此复选框会影响以下登录情况：

   • 用户激活门户登录—用户登录门户时必须输入其 BroadWorks 凭据。上述设置决定登录是直接登录 BroadWorks 还是通过 IdP 代理登录。

   • 客户端登录—如果在入职模板中配置了 BroadWorks 身份验证 ，则上述设置决定客户端登录 Webex 应用程序是直接登录 BroadWorks 还是通过 IdP 代理进行代理。

9. 单击下一步。

10. 在 CTI 接口页面上，执行以下操作：

    1. 添加要连接的 CTI 接口的 CTI URL 和端口。

    2. 可选。启用 通话记录 开关，然后输入您的 BroadWorks 用户 ID。选择此选项后，BroadWorks 通话记录事件将同步到 Webex 云端。用户可查看 Webex App 上的呼叫历史记录。

    3. 可选。启用 请勿打扰 (DND) 同步 开关，然后输入您的 BroadWorks 用户 ID。此选项可在 Webex 和 BroadWorks 之间同步 DND 事件，确保该功能在两个平台上运行一致。

    4. 可选。启用 个人助理状态同步 开关，然后输入您的 BroadWorks 用户 ID。此选项可同步 BroadWorks Calling 设备和 Webex App 之间的个人助理在线状态。

    5. 单击下一步。

11. 添加验证服务 URL。

12. 选择使用 CI 令牌验证的身份验证服务。

    该选项不需要通过 mTLS 保护来自 Webex 的连接，因为验证服务会首先根据 Webex 身份服务正确验证用户令牌，然后再向用户发放长期令牌。

13. 查看最终屏幕上的条目，然后单击 Create（创建）。您应该会看到一条成功消息。

    Partner Hub 会将 URL 传递给 Webex 的各种微服务，以测试与所提供接口的连接。

14. 单击 View Clusters（查看集群）可看到新集群以及验证是否成功。

15. 在向导的最终（预览）屏幕上，Create（创建）按钮可能会禁用。如果您无法保存模板，则表明您刚刚配置的某个集成存在问题。

    我们已实施此类检查以防止后续任务发生错误。在配置部署的过程中，您可以返回向导进行配置，这可能需要对您的基础架构（例如 XSP|ADP、负载均衡器或防火墙）进行修改，如本指南中所述，然后才能保存模板。

检查与 BroadWorks 接口的连接

1. 使用合作伙伴管理员凭证登录 Partner Hub （admin.webex.com）。

2. 从侧边菜单打开 服务 页面，找到 BroadWorks 电话 卡。

3. 点击 查看 Broadworks 呼叫。

4. Partner Hub 可通过各种微服务向集群中的接口发起连接测试。

   测试完成后，集群列表页面会在每个集群旁边显示状态消息。

   您应该会看到绿色成功消息。如果您看到红色错误消息，请单击受影响的集群名称以查看导致问题的设置。

5. 可选。如果要查看集群的现有设置，例如 XSI 操作、XSI 事件、DAS URL 和 CTI 接口设置，请选择该集群。

配置您的入职模板

使用配置方法将共享配置应用于一个或多个客户，即可使用入职模板。您必须将每个模板与（在前一部分创建的）集群关联。

您可以根据需要创建任意数量的模板，但是只有一个模板可以与客户关联。

1. 登录到 合作伙伴中心 并选择 客户。

2. 点击 入职模板 按钮查看现有模板。

3. 点击 创建模板。

4. 在 模板详细信息 窗口中，添加模板名称、国家或地区以及默认电子邮件语言。

5. 点击 CCW 订阅 ID的下拉菜单，找到合作伙伴的订阅列表，然后选择适用的订阅。

   此字段仅显示从 Webex for BroadWorks 迁移到 Webex 的合作伙伴。

6. 在 服务设置 窗口中，使用集群下拉列表选择要与此模板一起使用的集群。

7. 输入 Template Name（模板名称），然后单击 Next（下一步）。

8. 使用这些建议的设置来配置预配置模式：

   表 3. 建议的针对不同预配置模式的预配置设置

   设置名称	使用受信任电子邮件的流式预配置	无需电子邮件的流式预配置	用户自行预配置
   启用 BroadWorks Flow Through 配置 （如果需要，请包含配置帐户凭据） On**)	开 根据 BroadWorks 配置提供预配置的帐户名和密码。	开 根据 BroadWorks 配置提供预配置的帐户名和密码。	关
   在 Control Hub 中自动创建新组织	在†	在†	在†
   服务商电子邮件地址	从下拉列表中选择电子邮件地址（如果列表太长，您可以输入一些字符来查找地址）。 此电子邮件地址用于标识您合作伙伴组织内的管理员，该管理员将被授予对使用“入职模板”创建的任何新客户组织的委派管理访问权限。
   国家/地区	选择使用该模板的国家/地区。 您选择的国家/地区会将使用此模板创建的客户组织与特定区域相匹配。目前，该区域可以是（欧洲、中东、非洲及俄罗斯）或（北美和世界其他地区）。请参阅“此电子表格中的国家/地区与区域的映射”。 组织所在国家/地区将决定 Webex 会议站点中 Cisco PSTN 的默认全球呼叫接入号码。有关更多信息，请参阅 帮助页面 的“国家/地区”部分。
   BroadWorks 企业模式激活	如果您使用此模板预配置的客户是 BroadWorks 中的企业，则启用此功能。 如果他们是组，则关闭该开关。 如果您在 BroadWorks 中有多个企业和组，您应针对这些不同情况创建不同的模板。

   表格注释：

   • † 此开关可确保在订阅者的电子邮件域与现有 Webex 组织不匹配时创建新的客户组织。

     除非您使用手动订购和履行流程（通过 Cisco Commerce Workspace）在 Webex 中创建客户组织（在开始预配置这些组织中的用户前），否则该项应始终处于启用状态。该选项通常称为“混合预配置”模型，不在本文档的讨论范围内。

   • ** “配置帐户”指的是 BroadWorks 系统级管理员帐户。在 BroadWorks 上，您需要一个具备以下属性的管理员帐户：行政人员 Type=Provisioning, Read-only=Off.

9. 为使用此模板的客户选择默认服务软件包（请参阅“概述”一节中的软件包）；可以是基本、标准、高级或软件电话。

   您可以通过 Partner Hub 针对个别用户覆盖此设置。

10. 可选。如果您想禁用 Cisco Webex 通话，请勾选 禁用 Cisco Webex 免费通话 。

11. 对于会议加入配置，选择以下一种方式：

    • Cisco 呼入号码 (PSTN)

    • 合作伙伴提供的呼叫接入号码 (BYoPSTN)—如果您选择此选项，请参阅 Webex for Cisco BroadWorks 自带 PSTN 解决方案指南 ，了解有关如何配置此选项的详细信息。

12. 单击下一步。

13. 对于如何验证用户身份，有两种用户配置方法——使用受信任的电子邮件或不受信任的电子邮件。

    在可信电子邮件工作流程中，用户向合作伙伴提供电子邮件地址，合作伙伴会将这些地址添加到 BroadWorks 中。作为合作伙伴，您有责任通过流程传递或 API 方法提供电子邮件地址。

    强烈建议使用受信任的配置方法，因为它能确保所有订阅者都由您作为合作伙伴完全配置，最终用户无需采取任何操作。

    在不受信任的电子邮件情况下，用户需要在配置之前验证其电子邮件，或者用户可以自行激活。

    在“不受信任”的情况下，根据下表中的验证设置，有几种配置模式：

    表 4. 针对不受信任的配置模式，推荐的用户验证设置

    设置名称	无需电子邮件的流式预配置	用户自行预配置
    先配置管理员	建议*	不适用
    允许用户自激活	不适用	必填

    • 表格注释：

    • * Webex 中的每个客户组织都必须至少有一个具有管理员角色的用户。您分配给集成即时通讯的第一个用户 & 如果在 Webex 中创建新的客户组织，BroadWorks 中的 P 将担任客户管理员角色。作为服务提供商，您可能希望控制谁能担任该角色。选中此设置会阻止其他用户完成激活，直到您配置的第一个用户激活为止。如果不选中该设置，则新组织中第一个激活的用户将成为客户管理员。

14. 单击下一步。

15. 选择 Webex 用户登录的默认身份验证模式（可以是 BroadWorks 身份验证 或 Webex 身份验证）。

    此设置对用户登录用户激活门户没有影响。无论入职模板如何配置，用户登录门户时都必须使用其 BroadWorks 用户 ID 和密码。

    此设置仅适用于新建的客户组织。如果合作伙伴管理员尝试为现有客户组织应用新的身份验证设置，则会应用现有设置，以便现有用户不会失去访问权限。要更改现有客户组织的身份验证模式，则必须使用 Cisco TAC 提交申请单。

    （请参阅“准备环境”部分的“验证模式”）。

16. 单击下一步。

17. 对于首选项，请配置以下内容：

    1. 选择是否要“在登录页中预填充用户电子邮件地址”。

       只有在选择了 BroadWorks 验证并将用户的电子邮件地址输入到 BroadWorks 的“备用 ID”属性，才能使用此选项。否则，他们需要使用其 BroadWorks 用户名。登录页面提供了更改用户的选项（如果需要），但这可能会导致登录问题。

    2. 如果要启用目录同步，将为所有新客户组织启用电话目录同步设置为打开。

       此选项允许 Webex 将 BroadWorks 联系人读入客户组织，以便用户可以从 Webex 应用程序中查找并呼叫联系人。

    3. 输入 Partner Admin（合作伙伴管理员）。

       该名称用于 Webex 自动发送的电子邮件，用于邀请用户验证其电子邮件地址。

    4. 确保“ 允许在附加到现有组织时发送管理员邀请电子邮件 ”开关处于开启状态（默认设置为开启）。

    5. 单击下一步。

18. 查看最终屏幕上的输入内容。您可以单击向导顶部的导航控件以返回并更改任何详细信息。单击创建。

    您应该会看到一条成功消息。

19. 单击 View Templates（查看模板），您应看到新模板与其他模板一起列出。

20. 如有必要，单击模板名称可修改或删除模板。

    无需重新输入预配置帐户详细信息。提供了空密码/密码确认字段用于更改凭据（如果需要），不过将其留空可保留您提供给向导的值。

21. 如果要向客户提供不同的共享配置，请添加更多模板。

    让 View Templates（查看模板）页保持打开状态，因为以下任务可能需要模板详细信息。

补丁应用服务器（仅限 R22、R23 和 R24）

1. 如果您尚未这样做，请应用以下适用于您的补丁。 release:.

   • 对于 R22： AP.as.22.0.1123.ap373197

   • 对于 R23： AP.as.23.0.1075.ap373197

   • 对于 R24： AP.as.24.0.944.ap384177

   有关部署 Webex for Cisco BroadWorks 所需的 BroadWorks 补丁的完整列表，请参阅参考部分中的 BroadWorks 软件要求 。

2. 切换到 Maintenance/ContainerOptions 上下文。

3. 启用预配置 URL 参数：

   /AS_CLI/Maintenance/ContainerOptions> add provisioning bw.imp.useProvisioningUrl true

从 Partner Hub 获取预配置 URL

请参见“Cisco BroadWorks 应用程序服务器命令行接口管理指南”，了解 AS 命令的详细信息（Interface（接口）> Messaging and Service（消息传递和服务）> Integrated IM&P（集成的 IM&P））。

1. 登录合作伙伴中心并转到 客户 > 入职模板。

2. 单击 View Templates（查看模板）。

3. 选择用于在 Webex 中预配置此企业/群组的订阅者的模板。

   模板详细信息显示在右侧浮出窗格中。如果您尚未创建模板，需要先进行创建才能获取预配置 URL。

4. 复制预配置适配器 URL。

如果您有多个模板，对其他模板重复此操作。

（选项）在应用程序服务器上配置系统范围的预配置参数

1. 登录应用程序服务器并配置消息传递接口。

   1. AS_CLI/Interface/Messaging> set provisioningUrl provisioningURL

   2. AS_CLI/Interface/Messaging> set provisioningUserId provisioning_account_name

   3. AS_CLI/Interface/Messaging> set provisioningPassword provisioning_account_password

   4. AS_CLI/Interface/Messaging> set enableSynchronization true

2. 激活集成的 IMP 接口：

   1. /AS_CLI/Service/IntegratedIMP> set serviceDomain example.com

   2. /AS_CLI/Service/IntegratedIMP/DefaultAttribute> set userAttrIsActive true

（选项）在应用程序服务器上配置每个企业的预配置参数

1. 在 BroadWorks UI 中，打开要配置的企业，然后进入 Services（服务）> Integrated IM&P（集成的 IM&P）。

2. 选择 Use service domain（使用服务域）并输入虚拟值（Webex 会忽略此参数。你可以使用 example.com）。

3. 选择 Use Messaging Server（使用消息传递服务器）。

4. 在 URL 字段中，粘贴从 Partner Hub 的模板中复制的预配置 URL。

   您必须输入 provisioningURL 参数的完整限定名称，该名称必须与合作伙伴中心中给出的名称一致。如果您的应用服务器无法访问 DNS 来解析主机名，则必须在 AS 上的 /etc/hosts 文件中创建映射。

5. 在 Username（用户名）字段中，输入预配置管理员的名称。这必须与 Partner Hub 包含的模板中的值匹配。

6. 输入预配置管理员的密码。这必须与 Partner Hub 包含的模板中的值匹配。

7. 对于 Default User Identity for IM&P ID（IM&P ID 的默认用户身份），选择 Primary（主要）。

8. 单击应用。

9. 对其他要配置流式预配置的企业重复此步骤。

用户配置数据

有关 BroadWorks 和 Webex 在用户配置期间交换的用户数据的信息，请参阅 服务提供商用户配置。