共驻要求

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

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

• 您可以根据规模要求分离其他服务/应用程序（例如，专用设备管理XSP| <UNK> P场）。

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

• 请勿在用于将BroadWorks与Webex集成的XSP | <UNK> P上安装其他应用程序或服务。

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

Xsi 接口

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

仅应在用于CTI接口的XSP | <UNK> P上部署一个Xsi-Events应用程序实例。

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

ADP_CLI/Applications/Xsi-Events/GeneralSettings> get

callControlApplicationName = com.broadsoft.xsi-events

当用户加入Webex时，Webex会在AS上为用户创建订阅，以便接收在线状态和呼叫历史记录的电话事件。 订阅与callControlApplicationName关联，AS使用该订阅来了解将电话事件发送到哪个Xsi-Events。

更改callControlApplicationName，或者在所有Xsi-Events Web应用程序中使用不相同的名称，将会影响订阅和电话活动功能。

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

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

相互 TLS (mTLS) 可以作为身份验证服务的替代验证方法。 如果您有多个Webex组织运行同一XSP| <UNK> P服务器，则必须使用mTLS身份验证，因为CI令牌验证不支持与同一XSP| <UNK> P Auth服务的多个连接。 要针对身份验证服务配置 mTLS 身份验证而不是 CI 令牌验证，请参阅附录（配置服务（为身份验证服务使用 mTLS）的附录）。

如果您当前将 mTLS 用于身份验证服务，则重新配置以通过 TLS 使用 CI 令牌验证并非强制性的。

1. 获取Webex for Cisco BroadWorks的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. 将 AuthenticationService 每个XSP ADP服务| 应用程序。

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

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

   2. 运行此命令以在XSP | <UNK> P上部署 Service：

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

4. 从Broadworks Build 2022.10开始，当切换到新版本的java时，Java附带的证书颁发机构不再自动包含在BroadWorks信任存储中。 Service打开与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 <alias> <trustAnchorFile>

   如果从以前的发行版升级了ADP，则旧发行版中的证书颁发机构将自动导入到新发行版中，并将继续导入，直到手动删除。

   Service应用程序不受ADP_ <UNK> I/System/SSLCommonSettings/GeneralSettings下的validatePeer 设置的约束，并且始终验证对等身份。 有关此设置的详细信息，请参阅 isco Broadworks X509证书验证FD。

5. 通过在每个XSP| <UNK> P服务器上运行以下命令来配置身份提供程序：

   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> —对于 URL ，输入应用于 CI 集群的 IssuerName URL。 见下表。

   • set issuerUrl <URL> —对于 URL ，输入应用于 CI 集群的 IssuerUrl。 请参阅下表。

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

   表 1. 设置 Name和 URL

   如果 CI 集群是...	将 Name和 URL设置为…
   US-A	https://idbroker.webex.com/idb
   EU	https://idbroker-eu.webex.com/idb
   US-B	https://idbroker-b-us.webex.com/idb
   如果您不知道CI集群，可以从Control Hub的帮助台视图中的客户详细信息获取信息。

   表 2. 设置令牌信息URL

   如果 Teams 集群是...	将tokenInfoURL设置为…（IdP代理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
   如果您不知道 Teams集群，可以从Control Hub的帮助台视图中的客户详细信息获取信息。 要进行测试，您可以通过替换" idp/authenticate ”部分替换为” ping ”来验证 URL 是否有效。

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

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

7. 在每个XSP| <UNK> P服务器上使用以下命令配置Cisco联合的身份提供程序：

   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| <UNK> P服务器上使用以下命令配置令牌管理：

   • XSP|ADP_CLI/Applications/AuthenticationService/TokenManagement>

   • set tokenIssuer BroadWorks

   • set tokenDurationInHours 720

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

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

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

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

    1. 选择用于生成密钥对的XSP| <UNK> P。

    2. 使用客户端从客户端浏览器请求以下URL，从该XSP| <UNK> P请求加密令牌：

       https://<XSP|ADP-IPAddress>/authService/token?key=BASE64URL(clientPublicKey)

       （如果没有私钥/公钥对，则会在XSP|ADP上生成私钥/公钥对）

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

       XSP|ADP_CLI/Applications/authenticationService/KeyManagement> exportKeys

    4. 将导出的文件 /var/broadworks/tmp/authService.keys 到其他XSP | <UNK> P的相同位置，覆盖较旧的 .keys 文件解压（如有必要）。

    5. 导入其他每个XSP| <UNK> P上的密钥：

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

11. 向 Web 容器提供 authService URL。 XSP | <UNK> P的Web容器需要authService URL，以便能够验证令牌。 在每个XSP| <UNK> P上：

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

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

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

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

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

    3. 用下列命令检查参数： get 。

    4. 重新启动XSP | <UNK> P。

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

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

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

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

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

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

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

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

1. 登录到XSP| <UNK> P并导航至 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| <UNK> P并导航至 XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Protocols>

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

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

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

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

1. 登录到XSP| <UNK> P并导航至 XSP|ADP_CLI/Interface/Http/HttpServer/SSLSettings/Ciphers>

2. 输入命令 get <interfaceIp> 443 以查看已在此接口上使用的密码。 必须至少有一个来自Cisco推荐套件的套件（请参阅“概述”部分中的 XSP|ADP标识和安全要求）。

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

   XSP| <UNK> P 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| <UNK> P、应用程序服务器和配置文件服务器上配置设备管理

配置文件服务器和XSP| <UNK> P对于设备管理是必需的。 必须按照 BroadWorks 设备管理配置指南中的说明进行配置。

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

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

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

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

Webex for Cisco BroadWorks 客户端证书的公用名是 bwcticlient.webex.com 。

在 CTI 接口上配置 TLS 和密码

XSP| <UNK> P CTI接口的可配置性级别如下：

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

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

在全新安装中，以下密码在系统级别默认安装。 如果在接口级别（例如在CTI接口或HTTP接口）未配置任何内容，则应用此密码列表。 请注意，此列表可能会随时间发生变化： 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

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

1. 登录到XSP| <UNK> P并导航至 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 接口

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

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

1. 登录到XSP| <UNK> P并导航至 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Protocols>

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

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

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

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

1. 登录到XSP| <UNK> P并导航至 XSP|ADP_CLI/Interface/CTI/CTIServer/SSLSettings/Ciphers>

2. 输入 get 命令以查看已在此接口上使用的密码。 必须至少有一个来自Cisco推荐套件的套件（请参阅“概述”部分中的 XSP|ADP标识和安全要求）。

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

   XSP| <UNK> P 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| <UNK> P面向互联网或通过直通代理面对互联网。 桥接代理的证书配置不同（请参阅“TLS 桥接代理的 TLS 证书要求”）。

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

1. 登录合作伙伴中心。

2. 转至设置 > BroadWorks Calling，然后单击下载 Webex CA 证书以将 CombinedCertChain2023.txt 下载至您的本地计算机。

   这些文件包含两组证书，每组两个证书。 您需要在将文件上传到XSP | <UNK> P之前拆分文件。 所有文件为必填项。

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

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

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

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

   4. 将原始文件另存为 issuing2023.txt 。 原始文件现在应只包含一个文本块，周围环绕着行 -----BEGIN CERTIFICATE----- 和 -----END CERTIFICATE----- 。

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

5. 登录到XSP| <UNK> P并导航至 /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 | <UNK> P。

在 Webex 上启用 BroadWorks CTI 事件访问

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

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

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

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

用户体验

• Windows 用户： 单击 呼叫设置，然后单击 呼叫首选项 > 呼叫设置。

• Mac 用户： 单击档案照片，然后 项 > 呼叫设置。

在XSP ADP上安装呼叫设置| 视图

CSWV应用程序必须位于环境中托管Xsi|-Actions接口的XSP ADP上。 它是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. 根据适用于XSP ADP版本的Cisco BroadWorks X 服务平台配置指南安装、激活和部署Web存档。| （R24版本是 https://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/broadworks/Design/XSP/BW-XtendedServicesInterfaceConfigGuide.pdf）。

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

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

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

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

   3. [可选]删除 /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://<XSP|ADP-FQDN>/callsettings/

   注：

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

   • XSP | <UNK> P-FQDN必须与Xsi-ActionsFQDN匹配，因为CSWV需要使用Xsi-Actions，且不支持CORS。

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

呼叫设置网页视图应用程序现在在XSP| <UNK> P上处于活动状态。

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软件和补丁，请参阅一节 Webex for Cisco BroadWorks的NPS。

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

• 有关 ADP 服务器的更多信息，请访问 https://www.cisco.com/c/en/us/support/unified-communications/broadworks-application-delivery-platform/model.html。

配置 BroadWorks 集群

[每个集群一次]

进行此操作的原因如下：

• 要启用Webex云根据BroadWorks验证您的用户（通过XSP| <UNK> P托管的验证服务）。

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

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

集群向导会在添加接口时自动进行验证。 如果任何接口未能成功验证，您可以继续编辑集群，但是如果存在无效条目，则不能保存集群。 我们阻止保存是因为配置错误的集群可能会导致问题难以解决。

需要采取的行动

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

2. 从侧边菜单中打开 Settings（设置）页面，找到 BroadWorks Calling 设置。

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

   这将启动一个向导，您可以在其中提供XSP| <UNK> P接口(URL)。 如果您使用非标准端口，可以将端口添加到接口 URL。

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

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

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

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

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

7. 可选。 使用设备激活服务的URL更新 DAS 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. 单击下一步。

11. 添加验证服务 URL。

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

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

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

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

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

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

    我们已实施此类检查以防止后续任务发生错误。 您可以在配置部署时返回向导，这可能需要按照本指南中的说明修改基础设施（例如XSP| <UNK> P、负载平衡器或防火墙），然后才能保存模板。

检查与 BroadWorks 接口的连接

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

2. 从侧边菜单中打开 Settings（设置）页面，找到 BroadWorks Calling 设置。

3. 单击 View Clusters（查看集群）。

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

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

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

5. 可选。 如果要查看该群集的现有设置，例如XSI-Actions、XSI-Events、DAS URL和CTI接口设置，请选择一个群集。

配置您的加入模板

加入模板是指您通过预配置方法将共享配置应用于一个或多个客户的方式。 您必须将每个模板与（在前一部分创建的）集群关联。

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

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

2. 从侧边菜单中打开 Settings（设置）页面，找到 BroadWorks Calling 设置。

3. 单击 Add Template（添加模板）。

   这将启动一个向导，您可以在其中为使用此模板的客户提供配置。

4. 使用 Cluster（集群）下拉列表选择要用于此模板的集群。

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

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

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

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

   表格注释：

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

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

   • **“预配置帐户”是指BroadWorks系统级管理员帐户。 在BroadWorks上，您需要具有以下属性的管理员帐户： 管理员类型=预配置，只读=关闭。

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

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

8. 可选。 如果要禁用Webex呼叫， 禁用Cisco Webex免费呼叫 。

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

   • Cisco 呼入号码 (PSTN)

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

10. 单击下一步。

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

    在受信任电子邮件工作流中，用户向在BroadWorks中添加电子邮件地址的合作伙伴提供电子邮件地址。 作为合作伙伴，您负责将电子邮件地址作为流式传输或API方法的一部分。

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

    在不受信任的电子邮件案例中，用户需要在预配置前验证其电子邮件，或者用户可以自行激活。

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

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

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

    • 表格注释：

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

12. 单击下一步。

13. 选择用于用户登录Webex的缺省身份验证模式（BroadWorks身份验证或 Webex身份验证）。

    此设置对用户登录“用户激活门户”不起作用。 无论如何配置加入模板，用户在登录门户时都必须使用其BroadWorks用户ID和密码。

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

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

14. 单击下一步。

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

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

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

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

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

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

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

    4. 确保预配置现有组织开关开启（默认设置为开启）。

    5. 单击下一步。

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

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

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

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

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

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

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

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

1. 如果您尚未执行此操作，请对您的发行版应用以下补丁： 。

   • 对于 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. 登录到 Partner Hub 并转至设置 > BroadWorks Calling。

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

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

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

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

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

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

如果使用的是 UC-One SaaS，您可能不想设置系统范围的预配置和服务域。 请参阅“准备环境”部分的“决策点”。

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

必须输入 provisioningURL 参数的完全限定名称，正如在 Control Hub 中提供的。 如果应用程序服务器无法访问 DNS 来解析主机名，那么必须在 AS 上的 /etc/hosts 文件中创建映射。

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

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 参数的完全限定名称，正如在 Partner Hub 中提供的。 如果应用程序服务器无法访问 DNS 来解析主机名，那么必须在 AS 上的 /etc/hosts 文件中创建映射。

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

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

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

8. 单击 Apply（应用）。

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

用户预配置数据

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

将 Webex 应用程序配置模板添加到 BroadWorks 应用程序服务器

Webex 应用程序配置有 DTAF 文件。 客户端通过XSP ADP上的设备管理服务从应用程序服务器下载配置XML文件|。

1. 获取所需的 DTAF 文件（请参阅“准备环境”部分中的“设备档案”）。

2. 确认是否在 BroadWorks System（BroadWorks 系统）> Resources（资源）> Device Management Tag Sets（设备管理标记集）中正确设置了标记集。

3. 对于您正在预配置的每个客户端：

   1. 下载并解压特定客户端的 DTAF zip 文件。

   2. 在 System（系统）> Resources（资源）> Identity/Device Profile Types（身份/设备档案类型）处将 DTAF 文件导入 BroadWorks

   3. 打开新添加的设备配置文件进行编辑，然后：

      • 输入XSP ADP| 场FQDN和设备访问协议。

      • 选中支持远程用户信息复选框。 桌面共享需要此支持才能运行。

        您还可以在应用程序服务器上运行以下 CLI 命令，以便启用“远程用户”支持： AS_CLI/System/DeviceType/SIP> set <device_profile_type> supportRemotePartyInfo true

   4. 根据环境修改模板（见下表）。

   5. 保存该档案。

4. 单击 Files and Authentication（文件和验证），然后选择用于重新构建所有系统文件的选项。

自定义Webex应用程序的外观方案

• 合作伙伴自定义—合作伙伴管理员可以应用适用于合作伙伴组织和/或合作伙伴管理的客户的高级定制自定义。 请参阅配置高级定制定制。

• 客户定制-如果合作伙伴允许客户应用自己的品牌定制，客户管理员可以按照将贵公司的品牌添加到Webex中的程序操作。

用户激活门户使用您为客户端定制添加的相同徽标。

自定义问题报告和帮助 URL

要自定义这些选项，管理员可以按照“添加反馈和帮助站点URL”的步骤操作，该步骤可以在上述两篇品牌文章中找到。