在此文章中
dropdown icon
疑难解答资源
    有用的日志文件
    阅读清单
    已知问题和限制
    Serviceability Connector
dropdown icon
故障排除流程
    问题升级
    要收集哪些客户信息
    在服务台中查看用户详细信息
    在帮助台中查看客户组织
    从 Partner Hub 检索用户日志
    如何查找客户端版本
    客户检查呼叫服务
    获取客户日志或反馈
    获取通话环境数据
    验证 Webex 是否应该注册到 BroadWorks
    分析 PSLog 以了解用户配置问题
    分析 XSP 日志以排除订阅者登录故障
dropdown icon
对特定问题进行故障排除
    合作伙伴中心问题
    用户配置问题
    用户登录问题
    呼叫配置和注册问题
    通话设置 webview 问题
    域名索赔问题
    最终用户错误代码
    目录同步的错误代码
更改历史记录
适用于思科 BroadWorks 的 Webex 故障排除指南
list-menu在此文章中
list-menu反馈?

使用日志分析、支持工作流程、故障排除指南和错误代码参考来诊断和解决 Webex for Cisco BroadWorks 客户的问题。

本文适用于为自己和客户提供支持的服务提供商组织的技术支持团队。 他们应该熟悉一般故障排除、阅读日志和处理订户案例。

本文分为三个主要部分:

  • 资源-提供您可能需要的工具、阅读材料、日志和联系人列表。
  • 流程-描述在对客户问题进行故障排除时可以采取的一些操作。
  • 特定问题-对已知发生的问题进行分类和列出、如何发现这些问题以及如何可能解决这些问题。

疑难解答资源

有用的日志文件

日志名称

Target

对故障排除很有用

PSLog

应用程序服务器

直通式配置

tomcat 访问日志

XSP

Webex 应用程序登录

xsiActionsLog

XSP

Webex 应用程序与 Webex IDP 代理的登录交互,设备配置文件查询的客户端交互

身份验证服务日志

XSP

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

xSlog

应用程序服务器

移动订阅推送通知

呼叫信令

Webex 应用程序启动日志

Windows: \ 用户\ {用户名}\ AppData\ Local\ CiscoSpark\ current_log.txt

Mac: /Users/ {用户名} /库/日志/s parkmacDesktop/current_log

移动设备:使用发送日志

对用户进行启动(顺序)权利检查

用于连接到 BroadWorks 的 BWC 库初始化

getUserProfile 和 jWT 代币提取日志

BroadWorks

Webex 应用程序日志

客户端

Windows: \ 用户\ {用户名}\ AppData\ Local\ CiscoSpark\ current_log.txt

Mac: /Users/ {用户名} /库/日志/s parkmacDesktop/current_log

移动设备:使用发送日志

用于注册和呼叫的所有 SIP 流量

保持流向 BWKS 后端的流量

需要信令的通话中期功能(保留/恢复、转接等 )。

媒体(Webex 媒体引擎)日志

客户端

Windows:\ 用户\ {用户名}\ AppData\ Local\ CiscoSpark\ media\ *.l og

Mac: /Users/ {用户名} /库/日志/sparkmacDesktop/Media/

移动设备:使用发送日志

所有媒体日志

编解码器为通话进行了协商

Mid Call 功能

阅读清单

已知问题和限制

“已知问题和限制” 一文提供了有关我们在 Webex for BroadWorks 解决方案中发现的已知问题的最新信息。

Serviceability Connector

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

有关如何部署可维护性连接器的详细信息,请参阅可维护性连接器部署指南。Cisco Webex

故障排除流程

问题升级

在遵循了一些故障排除指南之后,您应该对问题的根源有一个合理的了解。

程序

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

要收集哪些客户信息

如果您认为需要提出问题或上报问题,请在向用户进行故障排除时收集以下 信息:

  • 用户标识符:CI 电子邮件地址或用户 UUID(这是 Webex 标识符,但如果您还获得了用户的 BroadWorks 标识符,请将其包含在案例详细信息中)。
  • 组织标识符。
  • 出现问题的大概时间范围。
  • 客户平台和版本。
  • 从客户端发送或收集日志。
  • 如果客户机上显示追踪 ID,请记录下来。

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

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

程序

  1. 登录服务台。
  2. 搜索并单击该用户。 这将打开用户摘要屏幕。
  3. 单击用户名查看详细的用户配置。 此视图中的有用信息包括用户的 UUID、通用身份 (CI) 集群、Webex 应用程序集群、呼叫行为、BroadWorks 账户 GUID
  4. 如果您需要在其他工具中使用此信息, 或者将其附加到思科案例,请单击 “复制”。

在帮助台中查看客户组织

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

程序

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

从 Partner Hub 检索用户日志

在对桌面和移动客户端问题进行故障排除时,合作伙伴(和 TAC)必须能够查看客户日志。

程序

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

    合作伙伴中心选项:

    1. 登录合作伙伴中心并找到用户的客户组织。
    2. 选择疑难解答。
    3. 选择 “日志”。
    4. 搜索用户(通过电子邮件)。
    5. 以 zip 文件形式查看和下载客户端日志。

    帮助台选项:

    1. 登录服务台。
    2. 搜索该组织。
    3. 单击组织(打开摘要屏幕)。
    4. 向下滚动点击查看客户。
    5. 选择疑难解答。
    6. 选择 “日志”。
    7. 搜索用户(通过电子邮件)。
    8. 以 zip 文件形式查看和下载客户端日志。

如何查找客户端版本

程序

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

客户检查呼叫服务

程序

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

    此验证意味着:

    • 客户端已成功遍历所需的 Webex 微服务。
    • 用户已成功通过身份验证。
    • 您的 BroadWorks 系统会向客户端颁发一个有效期很长的 JSON 网络代币。
    • 客户端已检索其设备配置文件,并注册到 BroadWorks。

获取客户日志或反馈

  • 请参阅资源部分,查找 Webex 桌面客户端上的特定客户端日志,或要求 用户发送日志。 如需帮助,请参阅:Webex 应用程序 | 报告问题。
  • 要求移动客户端的用户发送日志,然后您可以通过合作伙伴中心或帮助台获取日志。

    发送日志处于静默状态。 但是,如果用户发送反馈,反馈将发送给 Webex 应用程序开发运营团队。 如果您想跟进思科,请务必记录用户的反馈号码。 例如:

    case number for submitted support case

获取通话环境数据

为了删除个人身份信息,对 Webex 客户端日志进行了大量编辑。 您 应该在发现 问题的同一会话中从客户端导出呼叫环境数据。

程序

  1. 在客户端上,单击 “帮助” > “运行状况 检查器”。
  2. 选择 “重置数据库”。 这将触发客户端的完全重置并加载 Webex 应用程序登录屏幕。

验证 Webex 是否应该注册到 BroadWorks

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

  • 用户有权使用 b roadwork s-Connector。
  • 组织和用户的呼叫行为。

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

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

    check a user's calling behavior

  4. 单击用户名打开 “用户详细信息” 屏幕。
  5. 向下滚动找到 “授权” 部分,然后验证是否包含 b roadworks- Connector

    User details screen - broadworks connector enabled

    适用于思科 BroadWorks 的 Webex 用户如果打算使用适用于思科 BroadWorks 的 Webex,则不应拥有 bc-sp 标准权限。 这是 “Webex Calling(Broadcloud)” 的权限,即通过思科管理的云呼叫服务进行通话的Webex应用程序。

检查组织的通话行为

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

分析 PSLog 以了解用户配置问题

使用应用服务器的 PSLog 查看对配置桥的 HTTP POST 请求 以及 Webex 的响应。 在正确的工作案例中,响应为 200 OK,几分钟 后您可以看到用户(如果是第一个用户,则可以看到新的客户组织) 已在 Webex 中创建。 你可以通过在服务台上搜索你在 POST 中 看到的电子邮件地址来验证这一点。

准备工作

在尝试与 测试用户进行流式配置时,从应用服务器收集 PSLog。

程序

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

      忽略服务条款: 它由 AS 创建,Webex 接受但未使用。

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

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

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

以下讨论说明了在调查日志以确定成功登录时可以看到 的内容。Analyze XSP logs to troubleshoot subscriber log in -flow

用户与客户端互动,客户端与 Webex 服务交互:

  • 用户向 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。 例如:

    GE@@ T /com.broadsoft.xsi-actions/v2.0/user/ webexuserid@example.com/profile 标题包括授权:基本版和用户代理:BroadworksteamsClient

  • 然后,XSP对BroadWorks进行OCI-P基本身份验证 (AuthenticationVerifyRequest和AuthenticationVerifyResponse,就像任何其他通过Xsi 进行基本身份验证的应用程序一样),还使用UserGetRequest和ServiceProviderGetRequest来收集订阅者信息。
  • Xsi 对 Webex 的响应包含一个 XML 配置文件块,其中包含 (BroadWorks)用户 ID 和其他详细信息(图中为 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),例如:GE T /authService/Token,其中包含 http_bw_userid 标头和其他内容。
  • XSP 执行 OCI-P UsergetLoginInfoRequ est,以验证 提供的用户 ID 是否对应于 BroadWorks 用户(图中为 5.3)。 AuthService 通过 mTLS 连接与 Webex 建立了信任,因此可以发行 LLT。
  • 查找 LonglivedTokenManager 的响应(图中为 5.4)——代币已 生成,主题: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 使用标题授权:持有者令牌和用户代理:WebexTeams(变体/ 版本)
  • Xsi-Actions 接口将令牌发布到身份验证服务(配置为在环回接口上)例如: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(环回)

  • 返回到 X si 的 StatusCode=200

  • 还有一个令牌验证响应, 正文中有一个 “令牌” JSON 块。

  • 使用 trackingID 进行关联:客户端...

在 xsiActionsLog 中:

  • Xsi-Actions 应用程序从验证了客户端令牌的 authservice 收到 200 OK 后,现在向 UserPrimaryandscadeviceGetListRequest 发送 OCI-P 请求
  • 接收包含 AccessDeviceTable XML 结构的 OCI-P userPrimaryandscadeviceGetListList
  • OCI-P 响应被编码为对客户端的 Xsi 响应,包括具有设备类型的 AccessDevices XML 结构。 例如:Business Communicator — PC 和客户端可以检索设备配置文件的 URL。

客户继续照常运行:

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

对特定问题进行故障排除

合作伙伴中心问题

1。管理员看不到客户组织

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

用户配置问题

1。特定企业/客户的综合IM&P错误

如果您的企业混合使用不同的云协作服务,例如 UC-One SaaS 和适用于思科 BroadWorks 的 Webex,则您可能选择根据每个企业修改配置适配器。

要检查为集成 IM&P(企业默认配置,除非存在更 具体的设置)的配置,请运行 as _cli/Interface/Messaging> get。 要了解 特定企业的配置参数,请打开企业并转到 服务 > 集成 IM&P。

检查该企业的集成 IM&P 配置 是否与合作伙伴中心客户模板中显示的完全匹配。 企业中所有用户的以下设置必须匹 配,否则配置将失败:

BroadWorks 企业集成 IM&P 设置 合作伙伴中心客户模板设置
消息服务器 URL 设置 URL
消息服务器用户名预置账户名称
消息服务器密码配置帐户密码,确认密码

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

这适用于您使用直通式配置,并假设配置适用于某些/大多数用户(因此您可以排除配置问题)。 如果您在 BroadWorks 中看到集成 IM&P 错误,例如 “[错误 18215] 消息服务器配置错误” 和 “[错误 18211] 消息服务器通信错误”,则应调查以下潜在原因:

  • 用户的电子邮件地址可能已经存在 CI。 在服务台中搜索用户,检查他们的电子邮件地址是否已经存在。 这不一定是决定性的,因为该用户可能存在于不允许您在帮助台中查看其数据的组织中。
  • 在分配集成 IM&P 服务之前,用户独立注册了 Webex。 在这种情况下,一种选择是让用户删除他们的免费帐户,这样他们就可以成为您配置的客户组织的一部分。 说明请访问 https://help.webex.com/5m4i4y
  • 用户没有为其个人资料分配主电话号码(所有 Webex for Cisco BroadWorks 订阅者都必须有主 DID)。 请参阅有关分析 AS 的 PSlog 的主题。

3.来自配置桥的响应中出现用户配置失败

如果用户没有出现在 Control Hub 中,请在分配集成 IM&P 后的几分钟内查看配置桥接服务的响应代码。 运行 PSLog 来查看 HTTP 响应代码。

200 OK

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

400 错误的请求

查看 HTTP 响应,其中应包含有关可能导致配置服务响应 的潜在问题的更多详细信息。 该节点的一些示例:

  • “无法信任带有旧版配置 API 的 BroadWorks 电子邮件。”与失败的用户配置请求 关联的电子邮件地址无效或输入错误,但 您在模板中断言该电子邮件地址是可信的。 在 BroadWorks 中查看 用户的个人资料,特别是电子邮件ID。
  • 在数据库中找不到客户组织,也未启用新的组织创建标志。” 此失败的配置请求应在 Webex 中创建新的客户组织, 但您的模板已配置为防止创建新的客户组织。 如果您想允许新组织使用与 Webex 中现有 客户不匹配的电子邮件域,则可以在 Partner Hub 中重新配置模板并重新测试配置请求。 但是,如果您不希望 为该用户创建新组织,则可能是电子邮件地址输入错误(特别是域部分)。 在 BroadWorks 中检查用户的电子邮件 ID。

403 禁止的

在您修复配置之前,配置请求无法成功。 在这种情况下,你需要调查请求和回应。 例如,如果您将 IP 地址视为配置请求的目标,而不是组织相应的配置网桥 URL(请参阅解决方案指南中的防火墙配置主题),则可能表明您的应用服务器缺少所需的补丁 (ap373197)。

检查所有必需的补丁是否已应用于应用程序服务器,以及是否 已完成相关配置,以成功进行直通式配置。

409 冲突

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

4。用户已经在 CI 中

从 HTTP POST 请求中获取订阅者电子邮件并在帮助台中进行搜索。 如果您未被允许,您 可能看不到该用户,但您也可能会看到该用户处于 “免费” 组织中,例如 “消费者”。 您可以要求该用户删除他们的免费帐户, 也可以使用其他电子邮件地址进行设置。 请参阅 https://help.webex.com/ndta402。

用户登录问题

1。用户激活门户无法加载

适用于 Cisco BroadWorks 的正常 Webex 登录流程包括用户激活门户,用户可以在其中输入密码。 有时,用户在 Webex 应用程序登录屏幕中提供电子邮件地址后,此门户无法加载。 此问题可能在客户端或服务端引起。 在客户端,这通常是由于客户端的本机浏览器在某种程度上与服务不兼容造成的。

2。单点登录失败

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

呼叫配置和注册问题

在 Webex 中配置用户并成功登录 Webex 应用程序后,该应用程序将注册到 BroadWorks。 以下是预期的注册顺序和由此产生的注册正常迹象(从 Webex 应用程序中可以看出):

1。预期的注册顺序

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

2。成功注册客户的预期迹象

呼叫选项图标显示在 Webex 界面中。

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

3.客户端没有 “呼叫” 图标

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

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

Webex client shows phone services tab but no SSO session

这是一次不成功的注册。 Webex 应用程序客户端无法向 BroadWorks 注册的原因有多种:

4。正在使用相同的客户端测试多种呼叫服务

此已知问题可能是由于客户端在不同的呼叫后端之间切换引起的。 它最有可能发生在试用通过(相同的)Webex 应用程序客户端提供的不同呼叫服务时。 您可以重置客户端数据库(链接)来解决此问题。

5。身份验证服务配置错误

参照《解决方案指南》查看托管身份验证服务的 XSP(请参阅在 Webex 上为思科 BroadWorks XSP 配置服务)。 具体而言:

  • RSA 密钥(在一个 XSP 上生成)将复制到所有 XSP 上
  • 身份验证服务 URL 已提供给所有 XSP 上的 Web 容器,并在 Partner Hub 的集群中正确输入
  • 配置了通过证书进行外部身份验证:

    xsp_cli/system/CommunicationUtility/默认设置/外部身份验证/证书身份验证>GET

    allowUserApp = false

    allowClientApp = true

  • 使用 MTLS 时,您必须将 Webex 客户端证书上传到 XSP(您可以在 BroadWorks 设置页面上从 Partner Hub 获取证书)。

6。BroadWorks 标签的配置错误

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

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

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

8。未为用户配置桌面设备

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

[0x70000476b000] BroadworksConfigDownloader.cpp: 106 <Error>

onAccessDeviceListSucceded: bwc: SCF: configDownload——找不到设备配置文件 “Business Communicator-PC”。

9。入站手机呼叫一次或无法接听

Webex 移动电话的入站呼叫只能响一次,否则用户无法接听来电。 同一用户的其他端点可能会继续响铃。

如何识别?

在 Webex 移动客户端日志中,在推送呼叫流中查找 XSI 错误代码 101002。 例如:

响应码:400

<callID>HandlePushCallInfoFailure: bwc: internal: Push 呼叫:callId 的 xsi 状态:xsi 错误代码:101002

<callID>closePushCallWithReason: bwc: internal:尝试使用 id = 关闭推送呼叫,原因 = callAbandoned

原因:错误代码 101002 可能表示在 Loc ateUser 响应中返回了错误的应用程序服务器 (AS)。 当用户迁移到辅助 AS 时,可能会发生这种情况。

推荐的检查:

在部署 Push 的 ADP 或 XSP 中,为受影响的用户运行 LocateUser:

<FQDN or IP address of NS Server>curl 'http: //:80/servlet/locateUser?<BW userID @domain >url=&returncompatiblexsp=true&callprequest=true'

示例:curl 'http://1.1.1.1:80/servlet/LocateUser?url = 9721112222@gmail.com &returnCompatiblexsp=true&callprequest=Tru e'

解决方法:如果 LocateUser 为用户返回辅助 AS,请在主 NS 服务器上运行 M igrateUserToDefaultNode.pl 脚本,将用户迁移回群集的主应用服务器。

通过 SSH 登录 NS 服务器,前往 /usr/local/broadworks/bw_base/bin 目录,然后运行:migrateUserToDefaultNodef aultNode.pl <hostingNE>

示例:将用户迁移到 DefaultNode.pl bwas1

要获取 HostingNE 值,请运行:ns_cli/syst em/device/Hostingne> get

该脚本首先检查它是否可以找到你作为参数提供的主机 NE。 在验证托管 NE 有效后,它会将托管 NE 的 DN、扩展和 URL 更新为该托管 NE 的默认节点。

尽可能在低流量时段运行脚本。 但是,如果需要为受影响用户恢复服务,随时运行脚本通常是可以接受的。

该脚本不能仅为单个用户运行。 它会迁移 Locate User 输出中列出的所有用户。 如果您无法运行脚本,请在 BroadWorks 中删除并重建受影响的用户,以便在正确的 AS 上重建该用户。

从用户设备到辅助 AS 的任何 SIP 消息都可能导致用户迁移。 除非传入请求继续到达辅助 AS,否则用户通常会在默认 15 分钟间隔后回滚到主 AS。 例如,如果 SBC 无法连接到 AS1 并递归到辅助 AS,则受影响的用户可能会转移到辅助 AS。 根据部署情况,如果 SBC 在到达主 AS 时仍然出现问题,则单个中继组或用户可以继续固定到辅助 AS。

有关详细信息,请参阅以下文档:

9。电话服务已断开

如果用户登录 Webex 应用程序后电话服务显示为已断开连接,或者如果用户使用客户端时电话服务断开连接,请检查客户端类型和注册流程。

对于 Windows 和 Mac 客户端,Webex 应用程序会注册 SIP,并在用户登录时保持有效的 SIP 注册。

检查以下内容:

1. 确认 config-wxt.xml 已成功下载。

在客户端日志中,搜索 ConfigDownload。

成功下载显示:

配置下载-成功完成

如果日志显示以下错误,请检查 AuthService 日志中是否存在与令牌相关的错误:

ConfigDownload-失败,错误代码:1511

2. 确认找到 Webex 设备配置文件。

在客户端日志中,确认已找到接入设备并且 used_value 为 1。 如果 used_value 为 0,请检查主线路是启用还是禁用了,并验证标签值。 有关更多详细信息,请参阅《Webex for BroadWorks 配置指南》中的 6.1.44 节 “主要配置文件”。

示例日志条目:

:BWC: SCF: ConfigDownload-已找到访问设备

:BWC: SCF: ConfigDownload-访问设备:deviceType=Business Communicator-PC,deviceLevel=Group,allownerTermination=1,isDeviceOwner [has_value: 0,used_value: 1],hasOwnerDeviceDevice: 1,终端类型:共享呼叫外观

:BWC: SCF: ConfigDownload-访问设备:deviceType=Connect-移动设备,deviceLevel=Group,allowTermination=1,isDeviceOwner [has_value: 0,used_value: 1],hasOwnerDeviceDevice: 1,终端类型:共享呼叫外观

:BWC: SCF: ConfigDownload-访问设备:deviceType=Connect-平板电脑,deviceLevel=Group,allowTermination=1,isDeviceOwner [has_value: 0,used_value: 1],hasOwnerDeviceDevice: 1,终端类型:共享呼叫外观

3. 解析 SIP 代理地址时检查 DNS 是否出现故障。

有关 SIP 代理发现的详细信息,请参阅《Webex for BroadWorks 配置指南》中的 6.1.6 动态 SIP 代理发现部分。

成功的代理服务器发现显示:

代理发现已完成,得到<number>结果

4. 检查 SIP 注册是否失败。

如果日志显示 mRegistration: tcpTimeout 或原因:SIP;cause=200;text= “last=TCP-Timeout”,则 Webex 客户端无法与 SBC 建立低级 TCP 连接。 发生此错误时,SIP 注册未完成。 检查用户网络上的 TCP 是否被阻止,或者 SBC 是否拒绝 TCP 连接。

如果 SIP REGISTER 请求被拒绝或未收到响应,请在日志中搜索 REGISTER SIP 并验证是否返回 SIP/2.0 200 OK。 如果未返回,请检查用户的网络是否阻塞了 SIP 或 SBC 是否拒绝了请求。

在 BroadWorks 管理员中,转到用户 > 实用工具 > 注册,然后验证 Webex 客户端是否存在有效的 SIP 注册。

对于安卓和 iOS 移动客户端,Webex 应用程序只有在拨出或接听电话后才会注册 SIP。 通话完成后,注册将被删除。 移动客户端注册接收推送通知。

对于移动客户端,请检查以下内容:

1. 按照 Windows 和 Mac 客户端的说明,验证 config-wxt.xml 是否成功下载并找到了设备配置文件。

2. 验证推送注册是否成功。

在 Webex 日志中,查找推送注册状态:

onPushRegistrationStateChanged:: 推送注册状态已更改,状态 = 未注册

onPushRegistrationStateChanged:: 推送注册状态已更改,状态 = 已注册

在 BroadWorks 管理员中,转到用户 > 实用工具 > 推送通知注册,并验证 Webex 客户端是否存在有效的推送注册。

通话设置 webview 问题

1。Webex 应用程序中未显示 Self Care 按钮/链接

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

2。单击 Self Care 按钮/链接后出现空白页或错误

通常,Webex 应用程序中的这种行为表明 BroadWorks XSP 上的 CSWV 应用程序存在配置或部署问题。 收集详细信息以供进一步调查,包括 CSWV 日志、访问日志、config-wxt.xml 存储库和模板文件,然后提起诉讼。

域名索赔问题

用户注册错误可能是由于在申请域名时犯下的错误造成的。 在申领域之前,务必要了解以下内容:

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

    如果您错误地申领了任何域名并需要删除 索赔,请参阅 “管理您的域名” Webex 文章。

最终用户错误代码

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

本文并未详尽列出错误代码。该表格仅列出 Webex 应用目前无法向用户提供明确指导的现有错误代码。

表 1。表 1:最终用户错误代码

错误代码

错误消息

建议的行动

100006

登录失败:用户 ID/密码不正确。

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

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

200010

验证凭据失败,因为 BroadWorks 用户未经授权。

用户应尝试不同的用户名和密码组合。

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

200013

抱歉,您现在无法<name of SP offer>加入 Webex。 请过几分钟再 试一次。 如果问题仍然存在,请联系您的 <客户 组织管理员>。

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

200014

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

检查以确保您的配置准确无误且请求中的 配置 ID 正确无误。
200016由于未找到会话,验证凭据失败。用户应刷新浏览器并重试用户名/密码。
200018由于用户被锁定,验证凭据失败。用户应等待 10 分钟,然后重试。
200019验证凭据失败,因为添加用户无法自行激活。管理员应检查 Control Hub 中的自激活设置。
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验证电子邮件失败,因为此 Broad Works 集群已使用用户 ID。用户应使用不同的电子邮件地址重试。 否则,管理使用此 电子邮件地址的现有用户帐户的客户 组织管理员必须删除该用户帐户。
200045由于用户已经属于 另一个组织,因此无法通过自激活添加用户。用户应使用不同的电子邮件地址重试登录。 否则,管理不同组织的 客户组织管理员应删除 现有帐户。
200046无法通过自激活添加用户,因为同一 BroadWorks 集群下存在多个 具有相同 BroadworksUserID 的待处理用户。管理员应将待处理的用户从 Control Hub 中删除。
200047无法通过自激活添加用户,因为此 BroadWorks 集群上已经使用了 userID。用户应使用不同的电子邮件地址重试。 否则,管理现有用户帐户的客户 组织管理员应删除该 现有用户帐户或移除其他权限。
200048无法通过自激活添加用户,因为电子邮件地址已经 设置了不同的 BroadWorks 用户 ID。用户应使用不同的电子邮件地址重试。
200049无法通过自激活添加用户,因为此 BroadWorks 集群上已经使用了 userID。用户应使用不同的电子邮件地址重试。 否则,管理现有用户帐户的客户 组织管理员应删除该 现有用户帐户或移除其他权限。
200050无法通过自激活添加用户,因为 provisioningID 与订阅者企业的 预期配置 ID 不匹配。管理员应将用户使用的验证链接与在 Control Hub 中配置的 链接进行比较。 这两个链接和配置集必须匹配。
200051无法通过自激活添加用户,因为此 请求中指定的 spEnterpriseID 与已经从 此 BroadWorks 集群配置的服务提供商或企业相冲突。管理员应检查 Control Hub 中的现有组织,并确保他们创建的 不是使用已经存在的名称的组织。
200054由于客户组织和合作伙伴组织的区域不匹配,验证电子邮件 失败。管理员应在 Control Hub 中检查合作伙伴组织和客户组织设置, 并确保区域匹配。
200056正在使用同一封电子邮件进行用户注册时失败使用相同的电子邮件地址的用户注册已经在进行中。 用户应等待几分钟,然后重试。 如果问题仍然存在,管理员应检查该电子邮件地址的待处理或重复的入职记录,并在重试之前清除待处理用户状态。
300005由于用户已经在队列中并且正在进行配置,因此预检查失败。用户配置仍在进行中。 请等待几分钟, 然后再次检查。
300006你<name of SP offer>现在无法加入。 请过几分钟再 试一次。 如果问题仍然存在,请联系您的 <客户 组织管理员>。 参考编号:<reference ID>用户应在几分钟后重试。 如果这不起作用,请通过 https://developer.webex.com/ 与 Cisco API 支持团队联系

目录同步的错误代码

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

错误代码

错误消息

600000

BroadWorks 外部目录用户同步意外错误。

600001

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

BroadWorks 外部目录用户同步必须在完成之前终止。

600003

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

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

更改历史记录

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

日期更改
2026年7月28日
  • 在 “呼叫配置和注册问题” 部分下添加了新的小节 “来电手机呼叫一次或无法接听”。

  • 添加了新的错误代码详细信息:200056 和 300006。

2025 年 10 月 29 日更新了有用日志文件表 xSlog 源列。
2025年4月23日从 B roadWorks Calling Webex 应用程序日志源中移除了 bw c 文件夹。
2023 年 7 月 29 日在 “从合作伙伴中心 检索用户日志” 和 “获取客户日志或反馈 ” 部分添加了对 Webex 应用程序 | 报告问题(生成日志)的引用。
2022 年 6 月 27 日更新了阅读清单,其中缺少关于连接(安卓)迁移 到Firebase程序方法的链接。
2022年6月21日更新了阅读清单链接,指向 Cisco.com 上的新 URL。 通过添加有关 BroadWorks 标签问题的 Webex for Cisco BroadWorks 配置指南的链接,更新了呼叫配置和注册问题。
2022年4月14日在 “帮助台” 中的 “查看用户详细信息” 和 “在帮助台中查看 客户组织” 中添加了上下文陈述,以阐明服务台的 角色要求。
2022年3月26日为目录同步的错误代码添加了新的错误代码。
11 月 15,2021在最终用户错误代码中添加了错误代码 200013、200014、200025 和 300005。
2021 年 9 月 28 日为目录同步添加了错误代码。
2021 年 7 月 15 日在最终用户错误代码中添加了错误消息 100006。 还更新了 用户登录问题。
2021 年 7 月 14 日添加了主题,其中包含指向 “已知问题和限制” 文章的链接。
2021 年 7 月 2 日更新了 Webex 品牌重塑的产品名称。
2021 年 6 月 18 日更新了图形中的 Webex 徽标。
6 月 8,2021在 “最终用户错误代码” 表中添加了 “建议操作” 列。
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 日引入了新文件。
这篇文章对您有帮助吗?
这篇文章对您有帮助吗?