在此文章中
Webex for Cisco BroadWorks 故障排除
dropdown icon
Webex for Cisco BroadWorks 故障排除资源
    有用的日志文件
    阅读清单
    已知问题和限制
    Serviceability Connector
dropdown icon
Webex for BroadWorks 故障排除流程
    问题升级
    需要收集哪些客户信息
    请在帮助中心查看用户详细信息
    在帮助台查看客户组织
    从合作伙伴中心检索用户日志
    如何查找客户端版本
    客户检查是否正在呼叫服务
    获取客户端日志或反馈
    获取呼叫环境数据
    确认 Webex 是否已注册到 BroadWorks。
    分析 PSLog 以查找用户配置问题
    分析 XSP 日志以排查用户登录问题
dropdown icon
Webex for BroadWorks 故障排除特定问题
    合作伙伴中心问题
    用户配置问题
    用户登录问题
    调用配置和注册问题
    通话设置网页视图问题
    域名声明问题
    最终用户错误代码
    目录同步错误代码
更改历史记录

Webex for Cisco BroadWorks 故障排除指南

list-menu在此文章中
list-menu反馈?

服务提供商机构中负责自身及客户技术支持的技术人员需要这份指南。您应该熟悉一般故障排除、阅读日志和处理用户案例。

Webex for Cisco BroadWorks 故障排除

本文分为三个主要部分:

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

Webex for Cisco BroadWorks 故障排除资源

有用的日志文件

登录名

来源

用于故障排除

PSLog

应用服务器

流式预配置

汤姆猫 access_log

XSP

Webex App 登录

XsiActionsLog

XSP

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

身份验证服务日志

XSP

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

XSLog

应用服务器

用于推送通知的移动订阅

呼叫信令

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

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

Webex for 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 日志以排查订阅者登录流程问题

用户与客户端交互,客户端与 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 代理(图中的 5)请求 JSON Web Token (JWT)。
  • 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 到身份验证服务(配置为位于回环接口上)。例如:你可以将它与127.0.0.1:80 POST http://127.0.0.1:80/authService/tokenGET 中的 trackingid: CLIENT… 标题和 POST中的 X-BROADSOFT-CORRELATION-ID : CLIENT… 标题关联起来。

在身份验证服务日志中:

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

  • StatusCode=200 返回Xsi

  • 并且响应中包含一个“token”JSON块,用于验证令牌。

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

在 XsiActionsLog 中:

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

客户端继续正常工作:

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

Webex for BroadWorks 故障排除特定问题

合作伙伴中心问题

管理员无法查看客户组织

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

用户配置问题

集成 IM & 特定企业的P误差 / 顾客

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

要检查集成即时通讯的配置情况。 & P(企业默认值,除非存在更具体的设置),运行 AS_CLI/Interface/Messaging> get。要查看特定企业的配置参数,请打开该企业并转到 服务 > 集成 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 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 向 AS 发送 SIP REGISTER 请求(如果 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.

通话设置网页视图问题

自理 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>。

更新通用身份信息中的用户信息失败。请使用用户 API 再次更新用户信息。

200014

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

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

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

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

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

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

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

200043电子邮件验证失败,因为用户客户配置映射不正确。用户应使用不同的电子邮件地址重试。否则,管理员必须删除使用此电子邮件地址的其他用户。
200044验证电子邮件失败,因为 userId 在此 BroadWorks 集群上已被使用。用户应使用不同的电子邮件地址重试。否则,管理现有用户帐户(其使用此电子邮件地址)的客户组织管理员必须删除该用户帐户。
200045通过自助激活添加用户失败,因为用户已属于另一组织。用户应使用不同的电子邮件地址重新尝试注册。否则,管理不同组织的客户组织管理员应删除现有帐户。
200046通过自助激活添加用户失败,因为在同一个 BroadWorks 集群下存在多个具有相同 broadworksUserId 的待处理用户。管理员应从控制中心删除待处理用户。
200047通过自助激活添加用户失败,因为该用户 ID 已在此 BroadWorks 集群上使用。用户应使用不同的电子邮件地址重试。否则,管理现有用户帐户的客户组织管理员应该删除该现有用户帐户或删除其他授权。
200048通过自助激活添加用户失败,因为已使用另一 BroadWorks 用户标识预配置电子邮件地址。用户应使用不同的电子邮件地址重试。
200049通过自助激活添加用户失败,因为该用户 ID 已在此 BroadWorks 集群上使用。用户应使用不同的电子邮件地址重试。否则,管理现有用户帐户的客户组织管理员应该删除该现有用户帐户或删除其他授权。
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年10月29日更新了 有用的日志文件XSLog 源列。
2025年4月23日BroadWorks Calling Webex 应用程序日志 源中删除 bwc 文件夹。
2023年7月29日“从合作伙伴中心检索用户日志 ”和 “获取客户端日志或反馈 ”部分中,添加了对 “ Webex 应用 | ”的“报告问题 ” (以生成日志)的引用
2022 年 6 月 27 日已更新 阅读列表 ,缺少 Connect (Android) 迁移到 Firebase 方法的链接。
2022年6月21日更新了 阅读列表 链接,使其指向 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 Serviceability Connection 的信息。
2020 年 12 月 8 日更新文档。Webex Teams 更名为 Webex(应用程序)。新增最终用户错误代码。
2020 年 11 月 3 日新增通话设置网页视图。
2019 年 10 月 22 日新文件已发布。
这篇文章对您有帮助吗?
这篇文章对您有帮助吗?