Webex for BroadWorks 故障排除指南

2021年3月29日 | 次查看 | 人认为有帮助

Webex for BroadWorks 故障排除指南

针对 Webex for BroadWorks 的故障排除建议，包括“解决办法”主题、日志文件列表及其用途，以及有关调查具体问题的提示。

Webex BroadWorks 故障诊断的疑难解答

Webex for BroadWorks 故障排除

本文档面向为自己和客户提供支持的服务商组织技术人员。我们希望您熟悉常规故障排除、阅读日志以及处理订阅者案例。

本文分为三个主要部分：

资源，其中列出了您可能需要的工具、阅读资料、日志和联系人。
过程，其中描述了对客户问题进行故障排除时可以采取的一些操作。
特定问题，其中分类并列出了已知发生过的问题、发现途径，以及可能的解决方案。

更改历史记录


日期	更改	区域
2020 年 12 月 8 日	更新文档。 Webex Teams 更名为 Webex（应用程序）。添加最终用户错误代码	特定问题
2020 年 11 月 3 日	添加呼叫设置网页视图	特定问题
2020 年 10 月 22 日	引入新文档

产品：Webex for BroadWorks

活动：Administration

- 产品：
- Webex for BroadWorksWebex for BroadWorks

2021年3月29日| 次查看 | 人认为有帮助

资源

Webex for BroadWorks 故障排除资源

联系人

我们将从 2020 年 10 月开始将 BroadSoft 客户支持迁移到 Cisco CX 支持流程和工具。这意味着，Webex for BroadWorks 的支持人员需要从使用 Xchange 进行案例管理转为使用 Support Case Manager (SCM)。

我们预计迁移将持续大约 3 个月，到 2020 日历年底。迁移完成后，BroadWorks/UCaaS TAC 团队会开始在 CSOne/Lightning 而不是 BroadSoft Jira 中支持案例。迁移期间，您可能需要同时参考两个系统的案例。

请参阅旧版 BroadSoft 支持切换了解详细信息。

有用的日志文件


登录名	来源	用于故障排除
PSLog	应用程序服务器	流式预配置
tomcat access_log	XSP	Webex 应用程序登录
XsiActionsLog	XSP	Webex 应用程序登录与 Webex IDP 代理程序交互、设备配置文件查询的客户端交互
身份验证服务日志	XSP	Webex 应用程序登录（令牌验证和颁发）
XSLog	XSP？	用于推送通知的移动订阅呼叫信令
Webex 应用程序启动日志	Windows： `\Users\{username}\AppData\Local\CiscoSpark\current_log.txt` Mac： /Users/{username}/Library/Logs/SparkMacDesktop/current_log 手机：使用发送日志	启动（序列）用户权限检查为连接到 BroadWorks 进行的 BWC 库初始化 getUserProfile 和 JwT 令牌获取日志记录
BroadWorks 呼叫 Webex 应用程序日志	客户端 Windows： \Users\{username}\AppData\Local\CiscoSpark\bwc\current_log.txt Mac： /Users/{username}/Library/Logs/SparkMacDesktop/bwc/current_log 手机：使用发送日志	注册和呼叫的所有 SIP 流量发送到 BWKS 后端的保持活跃流量需要信令的呼叫中功能（保持/恢复、转接等）
媒体（Webex 媒体引擎）日志	客户端 Windows： \Users\{username}\AppData\Local\CiscoSpark\media\*.log Mac： /Users/{username}/Library/Logs/SparkMacDesktop/media/ 手机：使用发送日志	所有媒体日志记录为呼叫协商的编解码器呼叫中功能

正在阅读列表

Webex for BroadWorks 合作伙伴知识门户： https://www.cisco.com/go/wbx4bwks。
XSP 平台配置指南 (R23)： https://xchange.broadsoft.com/node/1033484
BroadWorks 软件管理指南 (R23)： https://xchange.broadsoft.com/node/1034035
Cisco BroadWorks 设备管理配置指南 (R23)： https://xchange.broadsoft.com/node/1031995
Broadworks XSP 命令行界面管理指南： https://xchange.broadsoft.com/node/1034192
长期身份验证令牌功能说明 23.0 版 https://xchange.broadsoft.com/node/1027115
SAML 验证集成指南，R22： https://xchange.broadsoft.com/node/1031642
Cisco BroadWorks SSL 支持选项指南： https://xchange.broadsoft.com/node/1032051
Cisco CI 支持功能描述： https://xchange.broadsoft.com/node/1052408
通知推送服务器（功能描述）： https://xchange.broadsoft.com/node/485737
呼叫推送通知支持功能描述发行版 22.0
Communicator (Android) 到 Firebase 迁移方法发行版 22.4.1
BroadWorks 用于推送通知的设备令牌存储功能描述发行版 22.0
Cisco BroadWorks 系统容量规划工具（电子表格）： https://xchange.broadsoft.com/node/473873
Cisco BroadWorks 平台尺寸指南： https://xchange.broadsoft.com/node/479629
Cisco Broadworks 系统工程指南： https://xchange.broadsoft.com/node/422649
Communicator 桌面版（UC-One 桌面版）配置指南 Communicator 发行版 22.9.12 UC-One SaaS 发行版 3.9.12
CI 验证支持要求文档版本 1.0 MR-7136

产品：Webex for BroadWorks

活动：Administration

- 产品：
- Webex for BroadWorksWebex for BroadWorks

2021年3月29日| 次查看 | 人认为有帮助

进程

Webex for BroadWorks 故障排除流程

上报问题

在遵循了一些疑难解答指南后，应该对问题根源有了合理的认识。

1	从与问题相关的系统收集尽可能多的信息
2	联系 Cisco 相应团队发起专案（请参阅“联系人”部分）

要收集的客户端信息

如果您认为需要打开专案或上报问题，在与用户进行疑难解答时，请收集以下信息：

用户标识符： CI 电子邮件地址或用户 UUID（这是 Webex 标识符，但如果能获取用户的 BroadWorks 标识符也会有帮助）
组织标识符
遇到问题的大致时间范围
客户端平台和版本
从客户端发送或收集日志
记录跟踪 ID（如果显示在客户端上）

在服务台中查看用户详细信息

1	登录到 https://admin.webex.com/helpdesk。
2	搜索用户然后单击。这会打开用户摘要屏幕。
3	单击用户名以查看详细的用户配置。此视图中的有用信息包括用户 UUID、通用标识 (CI) 集群、Webex 应用程序集群、呼叫行为、BroadWorks 帐户 GUID。
4	如果您需要在另一工具中使用此信息，请单击 Copy（复制），或将其附加到 Cisco 专案。

在服务台中查看客户组织

1	登录到 https://admin.webex.com/helpdesk。
2	搜索客户组织名称然后单击。
3	向下滚动至看到 Customer Portal View（客户门户视图），单击 View CustomerName（查看客户名称）以查看客户组织的只读视图（包括用户和配置）。

从 Partner Hub 检索用户日志

对桌面和移动客户端问题进行故障排除时，合作伙伴（和 TAC）必须能够看到客户端日志。

要求用户发送日志。

要求用户导出呼叫环境，将 ced.dat 文件发送给您。

从 Partner Hub 或服务台客户端日志（见下）。

Partner Hub 选项：

登录 Partner Hub，找到用户的客户组织。
选择 Troubleshooting（故障排除）。
选择 Logs（日志）。
搜索用户（通过电子邮件）。
查看客户端日志并下载为 zip 文件。

服务台选项：

登录服务台。
搜索组织。
单击组织（打开摘要屏幕）。
向下滚动，单击 View（查看）客户。
选择 Troubleshooting（故障排除）。
选择 Logs（日志）。
搜索用户（通过电子邮件）。
查看客户端日志并下载为 zip 文件。

如何查找客户端版本

1	与用户共享此链接： https://help.webex.com/njpf8r5。
2	要求用户向您发送版本号。

呼叫服务的客户端检查

1	登录 Webex 客户端。
2	检查侧边栏上是否有呼叫选项图标（一个上方有齿轮的听筒）。如果图标不存在，用户可能尚未在控制中心中启用呼叫服务。
3	打开 Settings/Preferences（设置/首选项）菜单，然后进入 Phone Services（电话服务）部分。您应能看到您登录的 SSO 会话的状态。（如果显示其他电话服务，例如 Webex Calling，说明用户未使用 Webex for BroadWorks。）此验证意味着：客户端已成功穿越微服务 Webex 请求。用户已成功通过身份验证。客户端已由 BroadWorks 系统颁发长效 JSON Web 令牌。客户端已检索其设备配置文件，并注册到 BroadWorks。

获取客户端日志反馈

请参阅资源部分，在 Webex 桌面客户端上找到特定客户端日志，或要求用户发送日志。
要求移动客户端用户发送日志，然后您可以通过 Partner Hub 或服务台获取这些日志。

发送日志是无提示的。但是，如果用户发送反馈，它将转到 Cisco Webex 应用程序开发运营团队。如果要与 Cisco 跟进，请务必记录用户的反馈号码。例如：

获取呼叫环境数据

Webex 客户日志经过大量修改以删除个人可识别信息。您应在发现问题时从同一会话中的客户端导出呼叫环境数据。

1	在客户端中，单击档案照片，然后单击 Help（帮助）> Export Calling Environment Data（导出呼叫环境数据）。
2	保存生成的文件 ced.dat，以便对此用户的呼叫问题进行故障排除。重要：从客户端注销或重启客户端会清除内部缓存。如果之后导出 ced.dat，导出的数据不会与缓存之前发送的任何日志对应。

重设 Webex 数据库

1	在客户端上，单击帮助 > 健康检查程序。
2	选择 Reset Database（重设数据库）。这将触发客户端的完整重置并加载 Webex 应用程序登录屏幕。

验证 Webex 注册到 BroadWorks

Webex 应用程序会检查以下信息来确定是否注册到 BroadWorks：

用户对broadworks-connector 的权限
组织和用户的呼叫行为

检查用户的呼叫行为以及连接器权限

使用您的合作伙伴管理员凭证登录到帮助台 (https://admin.webex.com/helpdesk)。
搜索用户。
单击用户并检查呼叫行为条目。应为“呼入 Webex”。
单击用户名打开用户详细信息屏幕。

向下滚动至权限部分，验证是否包含 broadworks-connector。

如果 Webex for BroadWorks 用户打算使用 Webex for BroadWorks，则不应拥有 bc-sp-standard 权限。这是通过 Cisco 托管的云呼叫服务进行的 Webex 应用程序呼叫“Webex Calling (Broadcloud)”的权限。

检查组织的呼叫行为

使用您的合作伙伴管理员凭证登录到帮助台 (https://admin.webex.com/helpdesk)。
搜索组织。
单击组织并检查呼叫行为条目。应为“呼入 Webex”。

针对用户预配置问题分析 PSLog

使用应用程序服务器的 PSLog 查看发送到预配置桥接的 HTTP POST 请求以及 Webex 的响应。

在正常案例中，响应为“200 成功”，并且在几分钟后，您可以看到 Webex 中创建该用户（如果是首个用户）和新的客户组织。

您可以通过在服务台搜索您在 POST 中看到的电子邮件地址来验证。

准备工作

在使用测试用户进行流式预配置的过程中，从应用程序服务器收集 PSLog。

要检查的第一件事是 HTTP 响应代码：

除“200 成功”之外的其他代码都说明用户预配置失败。
如果订阅者档案对预配置桥接上游的 Webex 不起作用，即使响应“200 成功”，仍然可能指示故障。
400 响应中可能包含消息节点。预配置桥接无法处理 subscriberProfile 中的某些内容。订阅者详细信息可能有问题，或与模板中的某个设置不兼容。
401 表示 AS 上输入的预配置凭据与 Partner Hub 模板中输入的凭据不匹配。
403 可能表明应用程序服务器上有配置错误。检查请求的目标。它不应为 IP 地址，应为可以在合作伙伴 Hub 中的模板上看到的预配置桥接 URL。
409 表示提供的 subscriberProfile 和现有 Webex 数据冲突。可能已有使用该电子邮件地址的用户。检查响应中的消息。

您还可以检查原始 HTTP POST 中是否有可能导致预配置失败的任何可疑值。

POST 包含 subscriberProfile XML 结构。其内部，需要检查的有用节点有：

bwuserid：如果您需要在 BroadWorks 中编辑订阅者档案，请使用它查找。
群组：如果模板是“服务商模式”，此模板会小写并成为在 Partner Hub 中看到的客户组织名称。
服务商：如果模板是“企业模式”，此模板会小写并成为在 Partner Hub 中看到的客户组织名称。
primaryPhoneNumber：必须存在。如果不存在，预配置会失败。
email：会成为 Webex 中的用户 ID。必须有效且对 Webex 唯一，否则预配置会失败。

忽略服务节：该模板由 AS 创建，Webex 已接受但未使用。

分析 XSP 日志以对订阅者登录进行故障排除

本流程描述了 BroadWorks 身份验证模式。您可以在 Partner Hub 中的 BroadWorks 模板上看到身份验证模式。请参阅 https://help.webex.com/en-us/z9gt5j/Webex-for-BroadWorks-Solution-Guide#id_137726 中的配置客户模板。

以下梯形图显示了用户在 Webex 应用程序中执行 BroadWorks 身份验证时，用户、客户端、Webex 服务与 BroadWorks 系统之间的交互。此外，Webex 与 XSP 之间的连接还受到 MTLS 保护。

以下讨论说明了调查成功登录日志时会看到的内容。

用户与客户端交互，客户端与 Webex 交互：

用户向应用程序提供其电子邮件地址（图中 1）。
CI 知道要重定向此用户以输入其 BroadWorks 密码（通过 UAP）（图中 2）。
IDP 代理将获取档案请求提交到 XSP 上的 Xsi 界面。

在 tomcat access_log 中：

查找从 Webex 到 Xsi-Actions（图中 2.1）的订阅者档案 GET 请求。该请求具有 Webex 用户 ID。例如：

GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

在 XsiActionsLog 中：

查找 Webex 发出的档案 GET 请求（图中 2.1）。该请求具有 Webex 用户 ID。例如：

GET /com.broadsoft.xsi-actions/v2.0/user/webexuserid@example.com/profile

标题包括 authorization: Basic 和 user-agent: broadworksTeamsClient
然后，XSP 针对 BroadWorks 执行 OCI-P 基本身份验证（AuthenticationVerifyRequest 和 AuthenticationVerifyResponse，像通过 Xsi 进行基本验证的其他任何应用程序一样）以及 UserGetRequest 和 ServiceProviderGetRequest，以收集订阅者信息。
Xsi 对 Webex 的响应包含包含 (BroadWorks) userId 和其他详细信息的 XML 档案块（图中 2.2）。

客户端和 Webex 服务交互：

IDP 代理匹配从 BroadWorks 接收的用户档案，并向客户端发送 SAML 断言（图中 2.3）
客户端将 SAML 断言交换为 CI 令牌（图中 3）
客户端会检查已登录的用户是否具有 broadworks-connector 权限（图中 4）。您可以在服务台中检查用户权限）
客户端使用 CI 令牌从 IDP 代理请求 JSON Web Token (JWT)（图中 5）
IDP 代理在 CI 验证 CI 令牌
IDP 代理从身份验证服务请求 JWT

在身份验证服务日志中：

查找 Webex 发出的令牌请求（图中 5.2），例如：

GET /authService/token

其具有 http_bw_userid 标题和其他内容。
XSP 执行 OCI-P UserGetLoginInfoRequest 以验证提供的用户 ID 是否与 BroadWorks 用户对应（图中 5.3）。 AuthService 已通过 mTLS 连接与 Webex 建立信任，因此可以发出 LLT。
查找来自 LongLivedTokenManager 的响应（图中 5.4） - Token generated，主题： bwksUserId@example.com，颁发者： BroadWorks...

和 StatusCode=200，您可以使用 trackingid: CLIENT… 标题将其与原始请求关联。

在 XsiActionsLog 中：

客户端现在能够在 Xsi-Actions 接口出示长效令牌以获取其设备配置文件（图中 6）。例如：

GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device

使用标题 authorization: Bearer 令牌和 user-agent: WebexTeams（变体/版本）
Xsi-Actions 接口将令牌 POST 至 authservice（配置在环回接口上），例如： 127.0.0.1:80 POST http://127.0.0.1:80/authService/token

您可以将这些与 trackingid: CLIENT… 标题（GET 中）和 X-BROADSOFT-CORRELATION-ID : CLIENT… 标题（POST 中）关联。

在身份验证服务日志中：

接收来自 Xsi 的 POST（环回）
StatusCode=200 返回 Xsi
以及令牌验证响应，正文中具有“令牌“JSON 块。
使用 trackingid: CLIENT… 关联

在 XsiActionsLog 中：

从验证了客户端令牌的 authservice 收到“200 成功”之后，Xsi-Actions 应用程序现在会发送 UserPrimaryAndSCADeviceGetListRequest 的 OCI-P 请求
接收 OCI-P 用户 UserPrimaryAndSCADeviceGetListResponse（包含 accessDeviceTable XML 结构的）
OCI-P 响应编码为 Xsi 对客户端的响应，包括 AccessDevices XML 结构，其包含 deviceTypes，例如 Business Communicator - PC，以及客户端用于检索设备配置文件的 URL。

客户端继续正常工作：

选择设备条目并与 DMS 交互以获取设备配置文件（图中 6）
通过从 DMS 配置中检索到的 SBC 注册到 BroadWorks（图中 7）

产品：Webex for BroadWorks

活动：Administration

- 产品：
- Webex for BroadWorksWebex for BroadWorks

2021年3月29日| 次查看 | 人认为有帮助

特定问题

Webex for BroadWorks 故障排除具体问题

Partner Hub 问题

管理员无法查看客户组织

作为 Webex 中合作伙伴组织的管理员，您应具有完全权限管理员角色。该角色用于管理合作伙伴组织，包括为自己和其他人分配管理权限。要管理客户组织，您需要为自己（或其他人员）授予销售完全权限管理员角色或销售管理员角色。请参阅 https://help.webex.com/fs78p5。

用户预配置问题

特定企业/客户的集成 IM&P 错误

如果您有多个企业使用不同的云协作服务（例如 UC-One SaaS 和 Webex for BroadWorks），您可能已经选择逐个企业修改预配置适配器。

要检查集成式 IM&P 的配置（企业默认设置，除非存在更具体的设置），请运行 AS_CLI/Interface/Messaging> get。有关特定企业的设置参数，请打开企业并转至 Services（服务）> Integrated IM&P（集成 IM&P）。

检查该企业的集成 IM&P 配置是否与 Partner Hub 客户模板中显示的内容完全相同。以下设置必须匹配，否则企业中所有用户的预配置都会失败：


BroadWorks 企业版集成 IM&P 设置	Partner Hub 客户模板设置
消息传递服务器 URL	预配置 URL
消息传递服务器用户名	预配置帐户名称
消息传递服务器密码	设置帐户密码，确认密码

特定用户的集成 IM&P 错误

如果您使用流式预配置，并且假定某些/大多数用户可以使用预配置（以便排除配置问题），则此情况适用。

如果在 BroadWorks 中发现了集成 IM&P 错误，例如“[Error 18215] 消息传递服务器预配置错误”和“[Error 18211] 消息传递服务器通信错误”，应该调查以下潜在原因：

用户的电子邮件地址可能已经存在于 CI 中。在服务台搜索该用户，检查其电子邮件地址是否已经存在。这一操作不一定能得出结论，因为您可能没有权限在服务台查看用户所在组织的数据。
该用户在被分配集成 IM&P 服务之前已独立注册 Webex。在这种情况下，一个选项是让用户删除其免费帐户，从而成为您预配置的客户组织的一部分。说明位于 https://help.webex.com/5m4i4y。
用户档案没有分配主要电话号码（所有 Webex for BroadWorks 订阅者都必须拥有一个主 DID）。请参阅关于从 AS 分析 PSLog 的主题。

用户预配置失败，无法响应预配置桥接

如果用户没有出现在控制中心中，请在分配集成 IM&P 几分钟后查看预配置桥接服务的响应代码。运行 PSLog 即可查看 HTTP 响应代码。

200 成功

“200 成功”响应并不代表用户已成功预配置。这代表预配置服务收到请求并成功向上游服务提交了相应的用户创建请求。

预配置事务设计为异步。服务响应“200 成功”是因为用户创建过程可能需要数分钟，由于性能原因，我们不希望收到多个创建同一用户的请求。

但是，如果用户在“200 成功”响应后最终未出现在客户组织中，可能表明预配置服务上游 Webex 服务中用户创建失败。

您需要上报一个有“200 成功”响应的预配置失败。

400 错误请求

查看 HTTP 响应，其中应当更详细地说明了可能导致预配置服务发送此响应的潜在问题。 <message> 节点示例：

“无法信任使用旧有预配置 API 的 BroadWorks 电子邮件。”

失败用户预配置请求关联的电子邮件地址无效或输入错误，但您已在模板中断言该电子邮件地址可信。检查 BroadWorks 中的用户档案，特别是电子邮件 ID。
“数据库中找不到客户组织，并且未启用新的组织创建标记。”

这项失败的预配置请求本应在 Webex 中创建新的客户组织，但模板已配置为阻止创建新客户组织。如果您希望允许新组织，对于与 Webex 中现有客户不匹配的电子邮件域，可以在 Partner Hub 中重新配置模板，然后重新测试预配置请求。但是，如果您并未打算为此用户创建一个新组织，则可能是电子邮件地址输入错误（具体为域部分）。检查 BroadWorks 中用户的电子邮件 ID。

403 禁止访问

预配置请求没有成功的可能。这种情况下，需要调查请求和响应。例如，如果您看到 IP 地址是预配置请求的目标 - 而非组织相应的预配置桥接器 URL（请参阅“解决方案指南”中的防火墙配置主题），可能表明应用程序服务器缺少所需的补丁 (ap373197)。

检查是否所有所需补丁均已应用到应用程序服务器，并且已完成相关配置以成功完成流式预配置。

409 冲突

预配置请求无法继续，因为 Webex 中的现有用户与请求中的电子邮件地址匹配。

用户已在 CI 中

从 HTTP POST 请求中获取订阅者的电子邮件，然后在服务台中搜索。

如果未获得许可，您可能看不到该用户，但可能还会看到该用户在“免费”组织中，例如“消费者”。

您可要求该用户删除其免费帐户，或使用不同的电子邮件地址进行预配置。请参阅 https://help.webex.com/ndta402。

用户登录问题

用户激活门户无法加载

Webex for BroadWorks 的正常登录流程包括一个用户激活门户，用户在其中输入密码。有时，在用户通过 Webex 应用程序登录屏幕提供其电子邮件地址后，此门户无法加载。

此问题可能在客户端或服务端引起。在客户端，通常是因为客户端的本机浏览器与服务在某些方面不兼容而造成。

单点登录失败

在 BroadWorks 中，检查是否已为用户分配 Webex 应用程序的设备类型（请参阅“设备配置文件”部分，位于“解决方案指南”中的“准备您的环境”）。
检查用户使用的密码是否正确：如果您用于（在 Partner Hub 中）预配置用户客户组织的模板已配置为 BroadWorks 身份验证，则用户应输入其 BroadWorks“Web Access”密码。

呼叫配置和注册问题

在 Webex 中预配置用户并且该用户成功登录 Webex 应用程序后，应用会注册到 BroadWorks。以下是预期的注册序列以及经由该序列正常注册的标志（可从 Webex 应用程序看到）：

预期的注册序列

客户端呼叫 XSI，获取设备管理令牌以及到 DMS 的 URL
客户端通过第 1 步中的令牌向 DMS 请求其设备配置文件
客户端读取设备配置文件并检索 SIP 凭据、地址和端口
客户端使用步骤 3 中的信息向 SBC 发送 SIP 注册簿
SBC 将 SIP 注册簿发送到 AS（如果 SBC 不知道 SIP 用户，可能会在 NS 中执行查找以便找到一个 AS。）

客户注册成功的预期标志

Webex 界面中会出现呼叫选项图标。

在 Webex 应用程序电话服务标签页（例如，在 Windows 上为设置 > 电话服务，在 Mac 上为首选项 > 电话服务），消息“SSO 会话：您已登录”意味着应用已成功注册（本例为注册到 BroadWorks）。

客户端没有呼叫图标

大多数情况下，这意味着用户没有正确的许可/权限。

客户端显示电话服务标签页，但没有 SSO 会话

注册失败。 Webex 应用程序客户端与 BroadWorks 注册失败的原因有多种：

正在使用同一个客户端测试多个呼叫服务

此已知问题可能是客户端在不同回呼端间切换造成的。此问题很可能发生在试用通过（同一）Webex 应用程序客户端提供的不同呼叫时。您可以通过重设客户端数据库（链接）解决此问题。

身份验证服务配置错误

参照“解决方案指南”检查托管身份验证服务的 XSP（请参阅“在 Webex for BroadWorks XSP 上配置服务”）。具体如下：

（您在一个 XSP 上生成的）RSA 密钥会复制到所有 XSP
身份验证服务 URL 已经提供给所有 XSP 上的 Web 容器，并且已正确输入到 Partner Hub 中的集群

已配置通过证书进行外部验证：

XSP_CLI/System/CommunicationUtility/DefaultSettings/ExternalAuthentication/CertificateAuthentication>get
        
        allowUserApp = false
        allowClientApp = true

使用 MTLS 时，必须将 Webex 客户端证书上传到 XSP（可以在 BroadWorks 设置页面上从 Partner Hub 获取证书）

BroadWorks 标记配置错误

检查您是否为 Webex 应用程序配置了必要的 BroadWorks 标记（请参阅“解决方案指南”中的“Webex 需要的 BroadWorks 标记”部分），并且没有冲突或数值错误。

具体而言，%SBC_ADDRESS_WXT% 标记应该是用于 Webex 应用程序客户端的 SIP 注册簿的 SBC。

桌面客户端在 SSO 连接成功后断开电话服务

此问题可能是同一用户在同一平台类型上登录多个客户端引起的。例如，如果用户成功登录到 Windows 上的 Webex 应用程序，然后在另一台 Windows 计算机上登录 Webex 应用，则只会有其中一台机器上存在活动的 SSO 会话。设计就是如此。

如果必须克服此问题，您可以将 BroadWorks 配置为具有相同设备类型的多个实例，但是它们必须具有唯一的 SIP 地址。此配置已超出 Webex for BroadWorks 的范围。

未为用户预配置桌面设备

此签名可在客户端 (\bwc\) 日志中看到：

<Error> [0x70000476b000] BroadWorksConfigDownloader.cpp:106 onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - 未找到设备配置文件“Business Communicator - PC”。

呼叫设置网页视图问题

Webex 应用程序中未显示自助按钮/链接

此问题的另一个表现是显示按钮/链接，但单击后会打开一个外部浏览器。

验证已部署所需的客户端配置模板并正确设置 CSW 标记。（请参阅“呼叫设置网页视图”部分，位于“Webex for BroadWorks 解决方案指南”中）。
验证 Webex 应用程序已注册在 BroadWorks 中进行呼叫。
检查 Webex 应用是否为支持 CSWV 的最新版本。

单击自助按钮/链接后显示空白页面或错误

一般情况下，Webex 中这一行为表示 BroadWorks XSP 上的 CSWV 应用程序存在配置或部署问题。

收集进一步调查所需详细信息，包括 CSWV 日志、访问日志、config-wxt.xml 存储库和模板文件，然后提交案例。

最终用户错误代码

下表概述了客户端用户激活门户中可能会看到的最终用户错误代码。

本文并未详尽列出错误代码。表中只列出了 Webex 应用程序当前未向用户提供明确指示的错误代码。

表 1. 最终用户错误代码
错误代码	错误消息
200010	验证凭据失败，因为 Broadworks 用户未经授权
200018	验证凭据失败，因为用户已锁定
200019	验证凭据失败，因为自助激活添加用户失败
200022	发送电子邮件失败，因为用户未经授权
200026	验证电子邮件失败，由于以下项目预检查失败或待批准用户状态不正确：PartnerOrgUUID：{partnerOrgUUID}，BroadoworksUUID：{broadworksUUID}，ConfigSetUUID：{configSetUUID}
200039	验证电子邮件失败，因为另一组织已在使用此电子邮件 ID
200040	验证电子邮件配置失败，因为配置集与客户配置中的配置集不匹配
200041	验证电子邮件失败，因为用户已被授权使用另一个冲突服务，权限冲突
200042	验证电子邮件失败，因为电子邮件已与另一 Broadworks 用户 ID 相关联
200043	验证电子邮件失败，因为用户客户配置映射不正确
200044	验证电子邮件失败，因为此 broadworks 集群上已在使用此用户 ID
200045	通过自助激活添加用户失败，因为用户已属于另一组织
200046	通过自助激活添加用户失败，因为同一 broadworks 集群下存在多个同一 Broadworks 用户 ID 的待批准用户，
200047	通过自助激活添加用户失败，因为此 Broadworks 集群上已在使用此用户 ID
200048	通过自助激活添加用户失败，因为已使用另一 BroadWorks 用户 ID 设置电子邮件地址
200049	通过自助激活添加用户失败，因为此 Broadworks 集群上已在使用此用户 ID
200050	通过自助激活添加用户失败，因为预配置 ID 与订阅者企业预期的预配置 ID 不匹配
200051	通过自助激活添加用户失败，因为此次请求中指定的 spEnterpriseId 与已从此 BroadWorks 集群中预配置的用户服务商或企业冲突

产品：Webex for BroadWorks

活动：Administration

Webex for BroadWorks 故障排除指南

Webex for BroadWorks 故障排除指南

Webex BroadWorks 故障诊断的疑难解答

Webex BroadWorks 故障诊断的疑难解答

Webex for BroadWorks 故障排除

更改历史记录

资源

Webex for BroadWorks 故障排除资源

联系人

有用的日志文件

正在阅读列表

进程

Webex for BroadWorks 故障排除流程

上报问题

要收集的客户端信息

在服务台中查看用户详细信息

在服务台中查看客户组织

从 Partner Hub 检索用户日志

如何查找客户端版本

呼叫服务的客户端检查

获取客户端日志反馈

获取呼叫环境数据

重设 Webex 数据库

验证 Webex 注册到 BroadWorks

检查用户的呼叫行为以及连接器权限

检查组织的呼叫行为

针对用户预配置问题分析 PSLog

准备工作

分析 XSP 日志以对订阅者登录进行故障排除

用户与客户端交互，客户端与 Webex 交互：

在 tomcat access_log 中：

在 XsiActionsLog 中：

客户端和 Webex 服务交互：

在身份验证服务日志中：

在 XsiActionsLog 中：

在身份验证服务日志中：

在 XsiActionsLog 中：

客户端继续正常工作：

特定问题

Webex for BroadWorks 故障排除具体问题

Partner Hub 问题

管理员无法查看客户组织

用户预配置问题

特定企业/客户的集成 IM&P 错误

特定用户的集成 IM&P 错误

用户预配置失败，无法响应预配置桥接

用户已在 CI 中

用户登录问题

用户激活门户无法加载

单点登录失败

呼叫配置和注册问题

预期的注册序列

客户注册成功的预期标志

客户端没有呼叫图标

客户端显示电话服务标签页，但没有 SSO 会话

桌面客户端在 SSO 连接成功后断开电话服务

未为用户预配置桌面设备

呼叫设置网页视图问题

Webex 应用程序中未显示自助按钮/链接

单击自助按钮/链接后显示空白页面或错误

最终用户错误代码

这篇文章对您有帮助吗？

您认为好在哪里？

我们哪里错了？

感谢您的反馈。

Webex for BroadWorks 故障排除指南

相关文章

最近查看