管理 Webex for BroadWorks

预配置客户组织

在当前模型中,当您通过本文所述的任何方法添加首个用户时,我们会自动预配置客户组织。 每个客户只能进行一次预配置。

管理用户

要管理 Webex for BroadWorks 中的用户,请记住该用户同时存在于 BroadWorks 和 Webex 中。 呼叫属性和用户的 BroadWorks 身份保存在 BroadWorks 中。 而 Webex 中保留了用户的独有电子邮件身份及其 Webex 功能的许可。

预配置用户

您可以用以下方式对用户进行预配置:

  • 使用 API 创建 Webex 帐户

  • 使用可信电子邮件分配集成的 IM&P(流式预配置)以创建 Webex 帐户

  • 不使用可信电子邮件分配集成的 IM&P(流式预配置)。 用户提供并验证电子邮件地址以创建 Webex 帐户

  • 允许用户自激活(您向用户发送链接,他们创建 Webex 帐户)

公共预配置 API

Cisco Webex 会公开公共 API,以允许服务商将 Webex for BroadWorks 订阅者集成到其现有预配置工作流中。 这些 API 的规范在 developer.webex.com 中提供。 如果希望使用这些 API 进行开发,请联系您的 Cisco 代表获取 Webex for BroadWorks。

流式预配置

在 BroadWorks 上,您可以为用户提供预配置 Enable Integrated IM&P(启用集成的 IM&P)选项。 此操作将允许 BroadWorks 预配置适配器进行 API 调用,以在 Cisco Webex 上预配置用户。 我们的预配置 API 向后兼容 UC-One SaaS API。 BroadWorks AS 无需更改代码,只需对预配置适配器的 API 端点进行配置更改。


在 Cisco Webex 上进行订阅方预配置可能需要大量时间(对于企业内的初始用户可能需要几分钟时间)。 Webex 会作为后台任务执行预配置。 因此,流式预配置成功表示该预配置已开始。 不表示完成。

要确认已在 Cisco Webex 中完全预配置的用户和客户组织,您必须登录到 Partner Hub 并查看客户列表。

用户自激活

要在 Webex 中预配置 BroadWorks 用户,而不分配集成的 IM&P 服务:

  1. 登录 Partner Hub 并找到 BroadWorks Settings(BroadWorks 设置)页面。

  2. 单击 View Templates(查看模板)

  3. 选择要应用于此用户的预配置模板。

    请记住,每个模板都与集群和您的合作伙伴组织关联。 如果用户不在与此模板关联的 BroadWorks 系统中,则用户无法通过链接自激活。

  4. 复制预配置链接并发送给用户。

    您可能还希望包含软件下载链接,并提醒用户需要提供并验证其电子邮件地址以激活其 Webex 帐户。

  5. 您可以在所选模板上监控用户的激活状态。

有关详细信息,请参阅“用户预配置和激活流程”

更改用户 ID 或电子邮件地址

用户 ID 和电子邮件地址更改

电子邮件 ID 和备用 ID 是用于 Webex for BroadWorks 的 BroadWorks 用户属性。 BroadWorks 用户 ID 仍是 BroadWorks 中用户的主标识符。 下表描述了这些不同属性的用途,以及需要更改这些属性时应执行的操作:

BroadWorks 中的属性 Webex 中的对应属性 目的 说明
BroadWorks 用户 ID 没有 主标识符 您无法更改此标识符,并仍会将用户连接到 Webex 中的同一帐户。 您可以删除用户,然后重新创建(如果有误)。
电子邮件 ID 用户 ID

如果声明信任电子邮件,则必须为流式预配置(创建 Webex 用户 ID)提供

如果不声明信任电子邮件,则不需要在 BroadWorks 中提供

如果允许订阅者自激活,则不需要在 BroadWorks 中提供

如果为用户预配置了错误的电子邮件地址,有一个手动过程可以在这两个位置进行更改:

  1. 在控制中心中更改用户的电子邮件地址

  2. 在 BroadWorks 中更改电子邮件 ID 属性

请勿更改 BroadWorks 用户 ID。 此操作不受支持。

备用 ID 没有 通过电子邮件和密码针对 BroadWorks 用户 ID 启用用户验证 应与电子邮件 ID 相同。 如果您无法将电子邮件置于备用 ID 属性中,用户在验证时必须输入其 BroadWorks 用户 ID。

在 Partner Hub 中更改用户软件包

1

登录 Partner Hub 并单击 Customers(客户)

2

查找并选择用户所属的客户组织。

组织概述页面将在屏幕右侧的面板中打开。

3

单击 View Customer(查看客户)

客户组织将在控制中心中打开,显示“概述”页面。
4

单击 Users(用户),然后查找并单击受影响的用户。

用户详细信息面板将在屏幕右侧打开。

5

在用户的 Services(服务)中,单击 Webex for BroadWorks Packages (Subscriptions)(Webex for BroadWorks 软件包(订阅))

随即将打开用户的软件包面板,您可以查看当前分配给用户的软件包。

6

为此用户选择所需的软件包(基本标准高级软件电话)。

控制中心会显示用户正在更新的消息。

7

您可以关闭用户详细信息和控制中心标签页。


标准软件包和高级软件包拥有与每个软件包相关联的独有会议站点。 如果拥有管理员权限的订阅者将这两种软件包之一迁移到另一种软件包,Control Hub 中会显示此订阅者拥有两个会议站点。 此订阅者的主持人会议功能和会议站点与他们当前的软件包一致。 会议站点管理员依然可以访问上一个软件包的会议站点以及以前在此站点上创建的任何内容,例如录制文件。

重新配置系统

可按照以下方式重新配置系统:

  • 在 Partner Hub 中添加 BroadWorks 集群 -

  • 在 Partner Hub 中编辑或删除 BroadWorks

  • 在 Partner Hub 中添加客户模板 -

  • 在 Partner Hub 中编辑或删除客户模板

在 Partner Hub 中编辑或删除 BroadWorks

您可以在 Partner Hub 中编辑或删除 BroadWorks 集群。

1

https://admin.webex.com 上,使用您的合作伙伴管理凭证登录到 Partner Hub。

2

进入 Settings(设置),找到 BroadWorks Calling 部分。

3

单击 View Clusters(查看集群)

4

单击要编辑或删除的集群。

集群详细信息显示在右侧浮出窗格中。
5

您有以下选择:

  • 更改您需要变更的任何详细信息,然后单击 Save(保存)
  • 单击 Delete(删除)移除集群,然后确认。

     

    如果模板与集群关联,则不能删除集群。 在删除集群之前需要删除关联的模板。 请参阅“在 Partner Hub 中编辑或删除客户模板”

集群列表会随更改更新。

在 Partner Hub 中编辑或删除客户模板

您可以在 Partner Hub 中编辑或删除客户模板。

1

https://admin.webex.com 上,使用您的合作伙伴管理凭证登录到 Partner Hub。

2

进入 Settings(设置),找到 BroadWorks Calling 部分。

3

单击 View Templates(查看模板)

4

单击要编辑或删除的模板。

5

您有以下选择:

  • 编辑您需要更改的任何详细信息,然后单击 Save(保存)
  • 单击 Delete(删除)移除模板,然后确认。

设置

价值

说明

预配置帐户名/密码

用户提供的字符串

编辑模板时无需重新输入预配置帐户详细信息。 提供了空密码/密码确认字段用于更改凭据(如果需要),不过将其留空可保留最初提供的值。

在登录页面中预填用户电子邮件地址

打开/关闭

在此设置中所做的更改最多需要 7 小时才能生效。 也就是说,在您启用后,用户可能仍然需要在登录屏幕上输入其电子邮件地址。

集群列表会随更改更新。

增加容量

XSP 场

我们建议您使用容量规划器来确定建议的订阅者数量增加所需的额外 XSP 资源数量。 对于用于 BroadWorks 场的专用 NPS 或专用 Webex,您具有以下可伸缩性选项:

  • 扩展专用场: 在需要额外容量的场中添加一台或多台 XSP 服务器。 安装并激活与场现有节点相同的应用程序和配置。

  • 添加专用场: 添加新的专用 XSP 场。 您需要在 Partner Hub 中创建新集群和新模板,只有这样才能开始在新场中添加新客户,从而缓解现有场的压力。

  • 添加专业场: 如果您遇到特定服务的瓶颈,您可能需要为此创建单独的 XSP 场,同时考虑本文档中列出的共驻要求。 如果您更改了具有新场的服务的 URL,您可能需要重新配置控制中心集群和 DNS 条目。

在任何情况下,您都有责任对 BroadWorks 环境进行监控和资源配置。 如果希望获得 Cisco 的协助,您可以联系客户安排专业服务。

管理 HTTP 服务器证书

您必须在 XSP 上管理经 mTLS 验证的这些 Web 应用程序的证书:

  • 我们的来自 Cisco Webex Cloud 的信任链证书

  • 您 XSP 的 HTTP 服务器接口的证书

信任链

您可以从控制中心下载信任链证书,并在初始配置期间将其安装到 XSP 上。 我们希望在证书过期之前更新证书,并通知您更改证书的方式和时间。

HTTP 服务器接口

XSP 必须按“订单证书”中的描述向 Webex 提供公开签名的服务器证书。 当您首次获得接口时,系统会为接口生成一个自签名证书。 该证书自该日期起一年内有效。 必须使用公开签名的证书替换自签名证书。 您负责在证书过期前申请新证书。

Webex for BroadWorks 故障排除

订阅 Webex 状态页

当您遇到服务意外中断时,请首先检查 https://status.webex.com。 如果在中断前未在控制中心或 BroadWorks 中更改配置,请检查状态页。 请访问 Webex 帮助中心,阅读有关订阅状态和事件通知的更多信息。

使用控制中心分析

Webex 会跟踪您所在组织和客户组织的使用情况和质量数据。 在 Webex 帮助中心,阅读有关控制中心分析的更多信息。

网络问题

未使用流式预配置在控制中心中创建客户或用户:

  • 应用程序服务器能否访问预配置 URL?

  • 预设置的帐户和密码正确吗?BroadWorks 中是否存在该帐户?

集群一直无法进行连接测试:


在 Partner Hub 中创建第一个集群时,mTLS 与验证服务的连接预计会失败,因为您需要创建集群才能访问 Webex 证书链。 否则,您将无法在验证服务 XSP 上创建信任定位点,因此来自 Partner Hub 的测试 mTLS 连接将不会成功。

  • XSP 接口可以公开访问吗?

  • 使用的端口是否正确? 您可以在集群的接口定义中输入端口。

接口验证失败

Xsi-Actions 和 Xsi-Events 接口:

  • 检查是否在 Partner Hub 中的集群上正确输入了接口 URL,包括 URL 末尾的/v2.0/
  • 检查防火墙是否允许 Webex 与这些接口之间的通信。

  • 查看本文档中的接口配置建议。

验证服务接口:

  • 检查是否在 Partner Hub 中的集群上正确输入了接口 URL,包括 URL 末尾的/v2.0/
  • 检查防火墙是否允许 Webex 与这些接口之间的通信。

  • 查看本文档中的接口配置建议,特别注意:

    1. 确保在所有 XSP 之间共享 RSA 密钥。
    2. 确保已在所有 XSP 上向 Web 容器提供 AuthService URL。
    3. 如果编辑了 TLS 密码配置,请检查是否使用了正确的命名约定。 XSP 需要您为 TLS 密码输入 IANA 名称格式。 本文档的早期版本在 OpenSSL 命名约定中错误地列出了所需的密码套件。
    4. 如果您将 mTLS 与验证服务一同使用,则 Webex 客户端证书是否已加载到 XSP/ADP 信任库中? 应用程序(或接口)是否配置为需要客户端证书?

    5. 如果您将 CI 令牌验证与身份验证服务一同使用,应用程序(或接口)是否配置为需要客户端证书?

客户端问题

验证客户端是否已连接到 BroadWorks

  1. 登录到 Webex 应用程序。

  2. 检查侧边栏上是否有呼叫选项图标(一个上方有齿轮的听筒)。

    如果图标不存在,用户可能尚未在控制中心中启用呼叫服务。

  3. 打开 Settings/Preferences(设置/首选项)菜单,然后进入 Phone Services(电话服务)部分。 您应能看到您登录的 SSO 会话的状态。

    如果显示了其他电话服务,如 Webex Calling,则用户未使用 Webex for BroadWorks。

此验证意味着:

  • 客户端已成功通过所需的 Webex 微服务。

  • 用户已成功通过身份验证。

  • 客户端已由 BroadWorks 系统颁发长效 JSON Web 令牌。

  • 客户端已检索其设备配置文件,并注册到 BroadWorks。

客户端日志

所有 Webex 应用程序客户端均可将日志发送给 Webex。 这是移动客户端的最佳选项。 如果您寻求 TAC 的协助,还应该记录用户的电子邮件地址和问题发生的大致时间。 要了解更多信息,请参阅“在哪里可以找到 Cisco Webex 的有关支持?”

如果您需要从 Windows PC 手动收集日志,这些日志位于如下位置:

Windows PCC:\Users\{username}\AppData\Local\CiscoSpark

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

用户登录问题

错误配置了 mTLS 验证

如果所有用户都受到影响,请检查从 Webex 到验证服务 URL 的 mTLS 连接:

  • 检查验证服务应用程序或其使用的接口是否针对 mTLS 进行了配置。

  • 检查 Webex 证书链是否作为信任定位点安装。

  • 检查接口/应用程序上的服务器证书是否有效,并由知名 CA 签名。

已知 BroadWorks 错误配置

chainDepth 过低

  • 条件: 您按照该过程将证书链复制到 XSP,并用其创建用于验证 Cisco Webex 客户端连接的定位点。 XSP 正在运行 R21 SP1。

  • 症状: 在 R21 中,XSP_CLI/Interface/HttpClientAuthentication/Trusts> get未显示颁发者链中预期的所有证书。

  • 原因: 在 R21 中,有一个chainDepth参数,如果设置太低的话,该参数会阻止将整个证书颁发者链添加至信任锚。

  • 解决/XSP_CLI/Interface/Http?ClientAuthentication> set chainDepth 3


    在编写本文时,Webex 客户端证书链有 2 个中间颁发者。 请勿将此参数设置为低于 2,尤其当参数较高时。 如果 chainDepth 不低于 2,这些症状可能表明链文件已损坏。

支持

稳定状态支持策略

服务商是最终客户(企业)支持的第一联系人。 将 SP 无法解决的问题上报给 TAC。 BroadWorks 服务器版本支持遵循当前版本和上两个主要版本 (N-2) 的 BroadSoft 策略。 请在 https://xchange.broadsoft.com/php/xchange/support/maintenancesupport/softwaremaintenancepolicies/lifecyclepolicy/broadworksservers 上阅读更多信息。

上报策略

  • 您(服务商/合作伙伴)是最终客户(企业)支持的第一个联系人。

  • SP 无法解决的问题将上报给 TAC。

BroadWorks 版本

自支持的资源

  • 用户可通过 Webex 帮助中心获取支持,该站点包含一个特定于 Webex for BroadWorks 的页面,其中列出了常见的 Webex 应用程序的帮助和支持主题。

  • 可以使用此帮助 URL 和问题报告 URL 自定义 Webex 应用程序。

  • Webex 应用程序用户可以直接从客户端发送反馈或日志。 日志会传至 Webex 云,在那里由 Cisco Webex DevOps 进行分析。

  • 我们还提供一个帮助中心页面,专用于为 Webex for BroadWorks 提供管理员级别的帮助。

收集提交服务请求的信息

当您在控制中心中发现错误时,它们可能附带了一些信息,可以帮助 TAC 调查您的问题。 例如,如果您看到特定错误的跟踪 ID 或者错误代码,请保存文本以与我们共享。

在您提交查询或创建案件时,请至少包含以下信息:

  • 客户组织 ID 和合作伙伴组织 ID(每个 ID 是由 32 个十六进制数字组成的字符串,由连字符隔开)

  • 如果接口或错误消息提供跟踪 ID(也是一个 32 位的十六进制字符串)

  • 用户电子邮件地址(如果特定用户遇到问题)

  • 客户端版本(如果问题有通过客户端注意到的症状)