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 应用程序看到):

预期的注册序列

  1. 客户端呼叫 XSI,获取设备管理令牌以及到 DMS 的 URL

  2. 客户端通过第 1 步中的令牌向 DMS 请求其设备配置文件

  3. 客户端读取设备配置文件并检索 SIP 凭据、地址和端口

  4. 客户端使用步骤 3 中的信息向 SBC 发送 SIP 注册簿

  5. 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 - the device profile 'Business Communicator - PC' is not found.

呼叫设置网页视图问题

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 集群中预配置的用户服务商或企业冲突