Webex 中的 Cisco BroadWorks 故障排除

本文主要分为三个部分:

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

Webex for Cisco BroadWorks 故障排除资源

有用的日志文件

登录名

来源

用于故障排除

PSLog

应用程序服务器

流式预配置

雄猫 access_log

XSP

Webex 应用程序登录

XsiActionsLogXSP

Webex App 登录与 Webex IDP 代理的交互,以及设备配置文件查询的客户端交互

身份验证服务日志

XSP

Webex 应用程序登录(令牌验证和颁发)

XSLogXSP?

用于推送通知的移动订阅

呼叫信令

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\current_log.txt

Mac:/Users/{username}/Library/Logs/SparkMacDesktop/current_log

手机:使用发送日志

注册和呼叫的所有 SIP 流量

发送到 BWKS 后端的保持活跃流量

需要信号传输的通话中功能 (Hold/Resume, 转帐等等。)

媒体(Webex 媒体引擎)日志

客户端

Windows: \Users\{username}\AppData\Local\CiscoSpark\media\*.log

Mac: /Users/{username}/Library/Logs/SparkMacDesktop/media/

手机:使用发送日志

所有媒体日志记录

为呼叫协商的编解码器

呼叫中功能

阅读清单

已知问题和限制

已知问题和限制 文章包含有关我们在 Webex for BroadWorks 解决方案中发现的已知问题的最新信息。

Serviceability Connector

Webex 可服务性服务提高了思科技术支持人员诊断基础设施问题的速度。它可以自动执行查找、检索和存储诊断日志以及 SR 案例中的信息的任务。该服务还会触发针对诊断签名的分析,以便 TAC 更有效地识别并解决本地设备的问题。

有关如何部署 Serviceability 连接器的详细信息,请参阅 Cisco Webex Serviceability Connector 部署指南

Webex BroadWorks 故障排除流程

升级问题

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

步骤

  1. 从与该问题相关的系统中收集尽可能多的信息。
  2. 联系思科的相应团队来开立案例。

收集哪些客户信息

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

  • 用户标识符:CI 电子邮件地址或用户 UUID(这是 Webex 标识符,但如果您还获得用户的 BroadWorks 标识符,那会有所帮助)。
  • 组织标识符。
  • 出现该问题的大致时间范围。
  • 客户端平台和版本。
  • 从客户端发送或收集日志。
  • 如果客户端显示,请记录跟踪 ID。

在帮助台检查用户详细信息

拥有帮助台管理员(基本或高级)角色权限的合作伙伴管理员可以使用此过程通过帮助台视图检查用户详细信息。

步骤

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

在帮助台中查看客户组织

拥有帮助台管理员(基本或高级)角色权限的合作伙伴管理员可以使用此过程在帮助台视图中查看客户组织详细信息。

步骤

  1. 登录到 帮助台
  2. 搜索客户组织名称然后单击。
  3. 向下滚动直到看到 客户门户视图 ,然后单击 查看客户名称 以查看客户组织的只读视图 - 包括用户和配置。

从合作伙伴中心检索用户日志

在解决桌面和移动客户端问题时,合作伙伴(和 TAC)能够查看客户端日志非常重要。

步骤

  1. 要求用户发送日志。要获取帮助,请参阅:Webex 应用程序 | 报告问题
  2. 要求用户导出调用环境并向您发送 ced.dat 文件。
  3. 从合作伙伴中心或帮助台获取客户端日志。

    Partner Hub 选项:

    1. 登录 Partner Hub,找到用户的客户组织。
    2. 选择 Troubleshooting(故障排除)
    3. 选择 Logs(日志)
    4. 搜索用户(通过电子邮件)。
    5. 查看客户端日志并下载为 zip 文件。

    服务台选项:

    1. 登录服务台。
    2. 搜索组织。
    3. 单击组织(打开摘要屏幕)。
    4. 向下滚动以单击 查看客户
    5. 选择 Troubleshooting(故障排除)
    6. 选择 Logs(日志)
    7. 搜索用户(通过电子邮件)。
    8. 查看客户端日志并下载为 zip 文件。

如何查找客户端版本

步骤

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

客户端检查调用服务

步骤

  1. 登录 Webex 客户端。
  2. 检查侧边栏上是否有呼叫选项图标(一个上方有齿轮的听筒)。如果图标不存在,用户可能尚未在控制中心中启用呼叫服务。
  3. 打开 Settings/Preferences(设置/首选项)菜单,然后进入 Phone Services(电话服务)部分。您应能看到您登录的 SSO 会话的状态。(如果显示了其他电话服务,如 Webex Calling,则表明用户未使用 Webex for Cisco BroadWorks。)

    此验证意味着:

    • 客户端已成功穿越微服务 Webex 请求。
    • 用户已成功通过身份验证。
    • 您的 BroadWorks 系统会向客户端颁发一个长效 JSON Web 令牌。
    • 客户端已检索其设备配置文件,并注册到 BroadWorks。

获取客户日志或反馈

  • 请参阅资源部分,在 Webex 桌面客户端上找到特定客户端日志,或要求用户发送日志。要获取帮助,请参阅:Webex 应用程序 | 报告问题
  • 要求移动客户端用户发送日志,然后您可以通过 Partner Hub 或服务台获取这些日志。

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

    已提交支持案例的案例编号

获取呼叫环境数据

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

步骤

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

验证 Webex 是否应注册到 BroadWorks

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

  • 用户对 broadworks-connector的授权。
  • 组织和用户的呼叫行为。

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

  1. 使用您的合作伙伴管理员凭据登录 帮助台
  2. 搜索用户。
  3. 单击用户并检查呼叫行为条目。应为“呼入 Webex”。

    检查用户的呼叫行为

  4. 单击用户名打开用户详细信息屏幕。
  5. 向下滚动找到 entitlements 部分,并验证是否包含 broadworks-connector

    用户详细信息屏幕 - broadworks 连接器已启用

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

检查组织的呼叫行为

  1. 使用您的合作伙伴管理员凭据登录 帮助台
  2. 搜索组织。
  3. 点击组织并检查 呼叫行为 条目。应为“呼入 Webex”。

分析 PSLog 中的用户配置问题

使用应用程序服务器的 PSLog 查看发送到预配置桥接的 HTTP POST 请求以及 Webex 的响应。在正常案例中,响应为“200 成功”,并且在几分钟后,您可以看到 Webex 中创建该用户(如果是首个用户)和新的客户组织。您可以通过在服务台搜索您在 POST 中看到的电子邮件地址来验证。

准备工作

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

步骤

  1. 要检查的第一件事是 HTTP 响应代码:
    • 除“200 成功”之外的其他代码都说明用户预配置失败。
    • 如果用户配置文件中的某些内容在配置桥的 Webex 服务上游不起作用,则 200 OK 仍可能表示失败。
    • 400 响应中可能包含 message 节点。配置桥无法处理 subscriberProfile中的某些内容。订阅者详细信息可能有问题,或与模板中的某个设置不兼容。
    • 401 表示 AS 上输入的预配置凭据与 Partner Hub 模板中输入的凭据不匹配。
    • 403 可能表明应用程序服务器上有配置错误。检查请求的目标。它不应为 IP 地址,应为可以在合作伙伴 Hub 中的模板上看到的预配置桥接 URL。
    • 409 表示提供的 subscriberProfile 与现有的 Webex 数据存在冲突。可能已有使用该电子邮件地址的用户。检查响应中的 message
  2. 您还可以检查原始 HTTP POST 中是否有可能导致预配置失败的任何可疑值。POST 包含一个 subscriberProfile XML 结构。其内部,需要检查的有用节点有:
    • bwuserid: 如果您需要在 BroadWorks 中编辑订阅者档案,请使用它查找。
    • group: 如果模板处于“服务提供商模式”,则该名称将小写并成为您在合作伙伴中心看到的客户组织的名称。
    • serviceProvider: 如果模板是“企业模式”,此模板会小写并成为在 Partner Hub 中看到的客户组织名称。
    • primaryPhoneNumber: 必须存在。如果不存在,预配置会失败。
    • email: 会成为 Webex 中的用户 ID。必须有效且对 Webex 唯一,否则预配置会失败。

      忽略 services 节:该模板由 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 保护。

以下讨论说明了调查成功登录日志时会看到的内容。 分析 XSP 日志以排除订户登录故障 -flow

用户与客户端交互,客户端与 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: Basicuser-agent: broadworksTeamsClient

  • 然后,XSP 针对 BroadWorks 执行 OCI-P 基本身份验证(AuthenticationVerifyRequest 和 AuthenticationVerifyResponse,像通过 Xsi 进行基本验证的其他任何应用程序一样)以及 UserGetRequest 和 ServiceProviderGetRequest,以收集订阅者信息。
  • Xsi 对 Webex 的响应包含一个 XML Profile 块,其中包含 (BroadWorks) userId 和其他详细信息(图中的 2.2)。

客户端和 Webex 服务交互:

  • IDP 代理匹配从 BroadWorks 收到的用户配置文件并向客户端发出 SAML 断言(图中的 2.3)。
  • 客户端用 SAML 断言交换 CI 令牌(图中的 3)。
  • 客户端会检查已登录的用户是否具有 broadworks-connector 权限(图中 4)。您可以在帮助台检查用户权限。
  • 客户端使用 CI 令牌从 IDP 代理请求 JSON Web 令牌 (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 - Token generated, subject: bwksUserId@example.com, issuer: BroadWorks …StatusCode=200 的响应(图中的 5.4),您可以使用 trackingid: CLIENT… 标头将其与原始请求关联起来。

在 XsiActionsLog 中:

  • 客户端能够在 Xsi-Actions 接口上出示长效令牌以获取其设备配置文件(图中的 6)。例如:GET /com.broadsoft.xsi-actions/v2.0/user/bwksUserId%40example.com/profile/device 带有标题 authorization: Bearer tokenuser-agent: WebexTeams (variant/version)
  • Xsi-Actions 接口将令牌 POST 到 authservice(配置为在环回接口上)例如:127.0.0.1:80 POST http://127.0.0.1:80/authService/token 您可以将其与 GET 中的 trackingid: CLIENT… 标题以及 POST中的 X-BROADSOFT-CORRELATION-ID : CLIENT… 标题关联起来。

在身份验证服务日志中:

  • 接收来自 Xsi 的 POST(环回)

  • A StatusCode=200 回到 Xsi

  • 以及令牌验证响应,其主体中有一个“token” JSON 块。

  • 已关联,通过使用 trackingid: CLIENT…

在 XsiActionsLog 中:

  • 收到来自 authservice 的 200 OK 消息后,Xsi-Actions 应用程序现在发送 OCI-P 请求 UserPrimaryAndSCADeviceGetListRequest
  • 接收包含 accessDeviceTable XML 结构的 OCI-P UserPrimaryAndSCADeviceGetListResponse
  • OCI-P 响应被编码为 Xsi 响应给客户端,包括 AccessDevices XML 结构,其中有 deviceTypes。例如:Business Communicator – PC 以及客户端可从中检索设备配置文件的 URL。

客户端继续正常工作:

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

Webex BroadWorks 特定问题故障排除

合作伙伴中心问题

管理员无法查看客户组织

作为 Webex 中合作伙伴组织的管理员,您应该拥有 完全管理员角色。该角色用于管理合作伙伴组织,包括为自己和其他人分配管理权限。要管理客户组织,您需要授予自己(或其他人) 销售完全管理员 角色或 销售管理员 角色。有关详细信息,请参阅 在 Control Hub 中分配组织帐户角色

用户配置问题

集成即时通讯 & 特定企业的P误差 / 顾客

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

检查集成 IM 的配置 & P (企业默认设置,除非存在更具体的设置),运行 AS_CLI/Interface/Messaging> get。对于特定企业的配置参数,请打开该企业并转到 服务 > 集成即时通讯 & P

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

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

集成即时通讯 & 特定用户的 P 错误

如果您使用流式预配置,并且假定某些/大多数用户可以使用预配置(以便排除配置问题),则此情况适用。如果在 BroadWorks 中发现了集成 IM&P 错误,例如“[Error 18215] 消息传递服务器预配置错误”和“[Error 18211] 消息传递服务器通信错误”,应该调查以下潜在原因:

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

配置桥接器响应用户配置失败

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

200 成功

200 OK 响应 并不意味着用户已成功配置。这代表预配置服务收到请求并成功向上游服务提交了相应的用户创建请求。预配置事务设计为异步。服务响应“200 成功”是因为用户创建过程可能需要数分钟,由于性能原因,我们不希望收到多个创建同一用户的请求。但是,如果用户在“200 成功”响应后最终未出现在客户组织中,可能表明预配置服务上游 Webex 服务中用户创建失败。您需要上报一个有“200 成功”响应的预配置失败。

400 错误请求

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

  • “无法信任使用旧有预配置 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 Cisco BroadWorks 的正常登录流程包括一个用户激活门户,用户在其中输入密码。有时,在用户通过 Webex 应用程序登录屏幕提供其电子邮件地址后,此门户无法加载。此问题可能在客户端或服务端引起。在客户端,通常是因为客户端的本机浏览器与服务在某些方面不兼容而造成。

单点登录失败

  • 在 BroadWorks 中,检查是否已为用户分配 Webex 应用程序的设备类型(请参阅“设备配置文件”部分,位于“解决方案指南”中的“准备您的环境”)。
  • 检查用户是否使用了正确的密码。如果您用于配置用户客户组织(在合作伙伴中心)的模板配置了 BroadWorks 身份验证,则用户应该输入他们的 BroadWorks“Web 访问”密码。如果用户的电子邮件地址未配置为备用用户 ID,则用户可能还需要输入其 BroadWorks 用户 ID。确保用户正确输入了大写和小写字符。

呼叫配置和注册问题

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

预期注册顺序

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

客户注册成功的预期迹象

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

在 Webex 应用程序电话服务选项卡中(例如 设置 > Windows 上的 电话服务偏好设置 > 电话服务 (在 Mac 上),消息“SSO 会话:您已登录”意味着应用已成功注册(本例为注册到 BroadWorks)。

客户端没有呼叫图标

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

客户端显示“电话服务”选项卡,但没有 SSO 会话

Webex 客户端显示电话服务选项卡,但没有 SSO 会话

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

使用相同的客户端测试多个呼叫服务

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

身份验证服务配置错误

参照“解决方案指南”检查托管身份验证服务的 XSP(请参阅在 Webex for Cisco 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 设置页面上获取证书)。

BroadWorks 标记配置错误

检查您是否已为 Webex 应用配置所需的 BroadWorks 标签。有关配置标签的信息,请参阅 Webex for Cisco BroadWorks 配置指南 。确保没有冲突或不正确的值。具体来说, %SBC_ADDRESS_WXT% 标签应该是面向 Webex 应用程序客户端的 SIP 注册器的 SBC。

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

此问题可能是同一用户在同一平台类型上登录多个客户端引起的。例如,如果用户在 Windows 上成功登录 Webex 应用程序,然后在另一台 Windows 计算机上登录 Webex 应用程序,则其中一台计算机上只有一个活动的 SSO 会话。设计就是如此。如果必须克服此问题,您可以将 BroadWorks 配置为具有相同设备类型的多个实例,但是它们必须具有唯一的 SIP 地址。此配置已超出 Webex for Cisco BroadWorks 的范围。

未为用户配置桌面设备

在客户端日志中可以看到此签名:

[0x70000476b000] BroadWorksConfigDownloader.cpp:106

onAccessDeviceListSucceeded:BWC:SCF: ConfigDownload - the device profile 'Business Communicator - PC' is not found.

呼叫设置 webview 问题

自理 button/link 未显示在 Webex 应用程序中

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

  • 验证所需的客户端配置模板是否已部署以及 CSW 标签是否已正确设置。(请参阅 Webex for Cisco BroadWorks 解决方案指南中的 呼叫设置 Webview 部分)。
  • 验证 Webex 应用程序已注册在 BroadWorks 中进行呼叫。
  • 检查 Webex 应用是否为支持 CSWV 的最新版本。

单击“自助服务”后出现空白页或错误 button/link

一般情况下,Webex 中这一行为表示 BroadWorks XSP 上的 CSWV 应用程序存在配置或部署问题。收集进一步调查所需详细信息,包括 CSWV 日志、访问日志、config-wxt.xml 存储库和模板文件,然后提交案例。

域名声明问题

域申领时发生的错误可能导致用户注册错误。在申领域之前,务必要了解以下内容:

  • 服务提供商不应声明其所管理的客户组织的域名。他们只能申领服务提供商内部组织中的用户的域。用户身份验证请求通过服务提供商而非客户组织路由时,申领独立组织的用户的域(即使是服务提供商管理的组织)可能导致客户组织中用户的注册错误。
  • 如果两个客户组织(公司 A 和公司 B)共享同一个域,而公司 A 已申领了域,则公司 B 用户可能会注册失败,原因是用户身份验证请求通过的是已申领该域的组织(公司 A)路由。

    如果您在申领域时出现有误,需要删除申领,请参阅“管理您的域” Webex 文章。

最终用户错误代码

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

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

表 1. 表 1 最终用户错误代码

错误代码

错误消息

推荐的操作

100006

登录失败:用户 ID/Password 是不正确的。

检查用户是否使用了正确的密码。如果您用于配置用户客户组织(在合作伙伴中心)的模板配置了 BroadWorks 身份验证,则用户应该输入他们的 BroadWorks“Web 访问”密码。如果用户的电子邮件地址未配置为备用用户 ID,则用户可能还需要输入其 BroadWorks 用户 ID。

确保用户正确输入了大写和小写字符。

200010

由于 BroadWorks 用户未经授权,因此无法验证凭据。

用户应尝试其他用户名和密码组合。

否则,管理员必须在 BroadWorks 中重设密码。

200013

抱歉,您现在无法通过 Webex 加入 <name of SP offer> 。请在几分钟后重试。如果问题仍然存在,请联系您的 <customer organization administrator>。

无法更新 Common Identity 中的用户信息。请使用用户 API 再次更新用户。

200014

请联系您的 <Service Provider> 管理员。

检查以确保您的配置准确并且请求中的配置 ID 正确。
200016由于未找到会话,因此验证凭据失败。用户应刷新浏览器,并重试用户名/密码。
200018由于用户被锁定,因此无法验证凭据。用户应等待 10 分钟,再重试。
200019由于添加用户自我激活失败,因此验证凭据失败。管理员应检查控制中心中的自激活设置。
200022由于用户未经身份验证,因此无法发送电子邮件。用户应重新尝试加入和输入凭证。
200025抱歉,您现在无法加入自我激活。请几分钟后再试。如果问题仍然存在,请联系您的系统管理员。让用户几分钟后再试一次。如果这不起作用,请咨询思科支持。
200026由于预检查失败或待处理用户的 PartnerOrgUUID 状态不正确,导致电子邮件验证失败 : {partnerOrgUUID} ,BroadoworksUUID : {broadworksUUID} ,配置设置UUID : {configSetUUID}管理员应通知用户输入的电子邮件地址错误,因为电子邮件地址与另一组织关联。
200039验证电子邮件失败,因为 emailId 已在其他组织中使用。用户应尝试再次加入同一验证链接,但使用不同的 BroadWorks 用户 ID。

否则,不同组织的客户组织管理员应删除现有的用户帐户。

200040由于 configSet 与 customerConfig 中的 configSet 不匹配,因此验证电子邮件失败。管理员应该将用户所使用的验证链接与 Control Hub 中配置的链接进行比较。两个链接和配置集必须一致。
200041验证电子邮件失败,因为用户已获得另一项冲突服务的授权,即权利冲突。用户应尝试使用不同的 BroadWorks 用户 ID 重新加入同一验证链接。

否则,管理冲突服务的客户组织管理员应删除冲突的服务或授权。

200042验证电子邮件失败,因为电子邮件已与另一个 BroadWorks UserId 关联。用户应使用不同的电子邮件地址重试。

否则,管理员必须删除使用此电子邮件地址的其他用户。

200043由于用户客户配置映射不正确,因此验证电子邮件失败。用户应使用不同的电子邮件地址重试。否则,管理员必须删除使用此电子邮件地址的其他用户。
200044由于该 BroadWorks 集群上已使用 userId,因此验证电子邮件失败。用户应使用不同的电子邮件地址重试。否则,管理现有用户帐户(其使用此电子邮件地址)的客户组织管理员必须删除该用户帐户。
200045通过自助激活添加用户失败,因为用户已属于另一组织。用户应使用不同的电子邮件地址重新尝试加入。否则,管理不同组织的客户组织管理员应删除现有帐户。
200046通过自我激活添加用户失败,因为同一 BroadWorks 集群下存在多个具有相同 broadworksUserId 的待处理用户。管理员应从 Control Hub 中删除待处理的用户。
200047由于该 BroadWorks 集群上已使用 userId,因此无法通过自我激活添加用户。用户应使用不同的电子邮件地址重试。否则,管理现有用户帐户的客户组织管理员应该删除该现有用户帐户或删除其他授权。
200048通过自助激活添加用户失败,因为已使用另一 BroadWorks 用户标识预配置电子邮件地址。用户应使用不同的电子邮件地址重试。
200049由于该 BroadWorks 集群上已使用 userId,因此无法通过自我激活添加用户。用户应使用不同的电子邮件地址重试。否则,管理现有用户帐户的客户组织管理员应该删除该现有用户帐户或删除其他授权。
200050由于 provisioningID 与订阅者企业的预期 provisioningID 不匹配,因此无法通过自我激活添加用户。管理员应该将用户所使用的验证链接与 Control Hub 中配置的链接进行比较。两个链接和配置集必须一致。
200051通过自我激活添加用户失败,因为此请求中指定的 spEnterpriseId 与已从此 BroadWorks 集群配置的服务提供商或企业冲突。管理员应该检查 Control Hub 中的现有组织,并确保它们没有创建名称已存在的组织。
200054由于客户组织和合作伙伴组织的区域不匹配,因此验证电子邮件失败。管理员应在 Control Hub 中检查合作伙伴组织和客户组织设置,并确保区域匹配。
300005预检失败,因为用户已在队列中并处于配置过程中。用户配置仍在进行中。请等待几分钟后再检查。

目录同步的错误代码

以下错误代码适用于目录同步。

错误代码

错误消息

600000

发生 Broadworks 外部目录用户同步意外错误。

600001

Broadworks 外部目录用户同步失败。
600002

Broadworks 外部目录用户同步尚未完成,但必须终止。

600003

Broadworks 外部目录用户同步仅部分成功。部分客户组织同步失败。

600004没有为配置集启用 Broadworks 外部目录用户同步。
600005正在进行配置集的 Broadworks 外部目录用户同步。
600006Broadworks 外部目录用户同步线程正忙或已关闭,因此不会接受其他同步请求,请稍后重试。
600007找不到客户配置的身份组织。
600008在合作伙伴组织中找不到客户配置。
600009由于与 CustomerConfig 关联的 Broadworks 集群正忙,因此无法运行 Broadworks 外部目录用户同步。
600010由于没有与 CustomerConfig 关联的 Broadworks 集群,因此无法运行 Broadworks 外部目录用户同步。
600011没有为客户配置启用 Broadworks 外部目录用户同步。
600012无法运行 Broadworks 外部目录用户同步,因为已为客户配置启用混合目录同步。
600013Broadworks 外部目录用户同步无法将用户和计算机帐户添加到身份存储库。
600014尝试连接到 Broadworks 集群时,Broadworks 外部目录用户同步失败。Broadworks 发生错误 - %s。
600015Broadworks 外部目录用户同步在身份存储库中找不到任何匹配的用户。
600017BroadWorks 电话列表同步无法同步所有用户和企业/组织联系人。
600018对于企业/组织中的用户,BroadWorks 电话列表同步失败。
600019BroadWorks 电话列表同步无法同步企业/组织联系人。
600020正在进行 CustomerConfig sync,因此无法禁用 BroadWorks 外部目录用户同步。
600022无法进行 BroadWorks 外部目录单用户同步,因为企业没有设置用户。
600023BroadWorks 外部目录单用户同步无法进行,因为该组织中已经存在该用户。
600024BroadWorks 外部目录单用户同步无法进行,因为 BroadWorks 中找不到匹配的用户。
600025BroadWorks 外部目录用户同步在 CI 用户帐户同步失败。
600026BroadWorks 外部目录用户同步在 CI 中更新机器帐户失败。
600027BroadWorks 外部目录单用户同步无法进行,因为在 BroadWorks 中发现多个用户。
600028BroadWorks 外部目录单用户同步无法实现,因为至少应该完成一个企业目录同步。
600029BroadWorks 外部目录用户同步失败,因为企业没有设置用户。

变更历史记录

该表包含本指南的变更历史记录。

日期更改
2025年4月23日BroadWorks Calling Webex 应用程序日志 源中删除了 bwc 文件夹。
2023年7月29日从合作伙伴中心检索用户日志 获取客户端日志或反馈 部分中添加了对 Webex 应用程序 | 报告问题 (以生成日志)的引用。
2022 年 6 月 27 日已更新 阅读列表 ,其中缺少有关 Connect (Android) 迁移到 Firebase 程序方法的链接。
2022年6月21日更新了 ReadingList 链接以指向 Cisco.com 上的新 URL。更新了 呼叫配置和注册问题 ,添加了指向 Webex for Cisco BroadWorks 配置指南 的链接,以解决 BroadWorks 标签的问题。
2022 年 4 月 14 日“检查帮助台中的用户详细信息”和“查看帮助台中的客户组织 ”添加了上下文语句,以阐明帮助台的角色要求。
2022年3月26日目录同步的错误代码中添加了新的错误代码。
2021年11月15日最终用户错误代码中添加了错误代码 200013、200014、200025 和 300005。
2021 年 9 月 28 日添加了 个目录同步错误代码。
2021 年 7 月 15 日最终用户错误代码中添加了错误消息 100006。还更新了 用户登录问题。
2021 年 7 月 14 日添加了指向 已知问题和限制 文章的链接主题。
2021 年 7 月 2 日更新了 Webex 更名的产品名称。
2021 年 6 月 18 日更新了图形中的 Webex 徽标。
2021 年 6 月 8 日最终用户错误代码 表中添加了“建议的操作”列。
2021 年 6 月 4 日更正 最终用户错误代码 表。
2021 年 5 月 19 日添加了 域名声明问题 部分。
2021 年 4 月 22 日更新了 最终用户错误代码 ,添加了两个附加代码:200016 和 200054。
2021 年 4 月 13 日添加了有关 Webex 可服务性连接的信息。
2020 年 12 月 8 日更新文档。Webex Teams 更名为 Webex(应用程序)。添加了最终用户错误代码。
2020 年 11 月 3 日添加了呼叫设置 Webview。
2019 年 10 月 22 日引入了新文件。