用户管理

在 Control Hub 的底层有一个集中式的用户管理系统，其中的用户在整个组织（以及整个 Webex）中都是独一无二的。 在站点管理中，每个会议站点的用户档案都不同。

具有自动帐户创建的单点登录 (SSO)

站点管理提供“自动创建帐户”功能，在用户通过 SSO 进行身份验证时会创建用户。

此功能在 Control Hub 中不可用，因为有更可靠的方法可以添加新用户。 在将站点更新至 Control Hub 前，必须在站点管理中禁用此功能。

许多使用 SSO 的组织可能更希望通过外部目录工具（例如 Microsoft ^® Active Directory 和 Microsoft Azure）集中管理用户，并要求使用外部身份提供商进行身份验证。

了解以下详细信息：

• 将用户添加到 Control Hub： https://help.webex.com/nj34yk2/

• 将 Control Hub 组织与身份提供商集成： https://help.webex.com/lfu88u/

必填档案数据和跟踪代码

站点管理允许您指定新用户所需的档案字段（之前的屏幕截图）。 您可以将其扩展为需要跟踪代码才能创建用户（请参考以下屏幕截图）。 如果配置这些额外的要求，则无法在条件不符合的情况下将用户添加到站点。

Control Hub 只需要显示名和电子邮件地址即可创建用户。

在 Control Hub 中创建新用户时，所有其他用户字段都是可选项，因此我们不会强制要求为 Control Hub 托管的站点添加其他档案数据。

在将站点更新至 Control Hub 前，必须禁用必填档案字段和跟踪代码。

密码管理和锁定

站点管理有一个功能，如果用户在多次尝试后未能登录，可以将该用户暂时锁定。

Control Hub 包含以下防止未授权访问的选项：

• 在前几次尝试失败后自动超时。

• CAPTCHA 机制（完全自动化的公共图灵测试，可以分辨计算机和人类）。

• 合法用户有一个自助服务选项来更改忘记的密码。

主持人许可

主持人必须在 Control Hub 组织中

在站点管理中，您可以将主持人许可证分配给任何用户。 在 Control Hub 中管理站点时，您只能将主持人许可证（和与会者角色）分配给同一 Control Hub 组织中的用户。

自助注册主持人帐户

在站点管理中，您可以选择允许用户申请站点上的（主持人）帐户。 您还可以允许拥有帐户的用户在站点上申请其他服务。（请参阅屏幕截图）。

在 Control Hub 中管理会议站点时，用户无法针对该站点申请自己的主持人帐户。

Control Hub 提供了一种集中的自动化方式，允许您将会议许可证分配给新用户。 请参阅 https://help.webex.com/n3ijtao。

您还可以通过 API 或批量使用 CSV 来管理用户许可证。

如果您希望用户申请其主持人帐户，可以使用指向管理员的指针或指向其他工具的链接来配置站点帮助/支持。

将站点更新至 Control Hub 前，必须在站点管理中禁用“允许注册主持人帐户”和“允许用户请求其他服务”。

Control Hub 具有其他许可证管理选项，例如自动分配模板。 您可以获取非活动主持人的报告，以帮助您单独、批量或通过 API 删除这些用户的许可证。

如果您需要此自动停用选项，并且 Control Hub 中的其他选项不适用于您，则此时应该避免将站点更新至 Control Hub。

为新用户自动创建帐户

如果您的Webex 站点在站点管理中启用了自动创建帐户，您可以在 Control Hub 中启用类似的功能： SAML 自动创建帐户。 确保同时设置自动许可证模板以便新用户在 Control Hub 组织中创建帐户后自动获得分配的许可证。

目录同步的组织

如果您的组织已配置为目录同步，那么请确保希望位于您的组织中的所有用户都存在于该站点中。 这应在站点更新过程之前 24 小时完成，以便站点上的用户可以链接到 Control Hub 组织中新用户。

如果站点上的活动用户无法链接到 Control Hub 用户，更新将失败。

XML API

XML API 现在可以转发至 Control Hub 管理的站点。 您可以在 XML API 41.11.0 更新中阅读详细信息和警告。

将站点从站点管理更新为 Control Hub 管理的站点后，XML API 服务 URL 没有变化。 相同的 API URL 将继续有效。 Cisco建议所有 API 集成使用 OAUTH 进行身份验证。

XML API 中的验证

不使用的集成用于验证的 Webex OAUTH在站点更新到 Control Hub 后，该操作可能会失败。 下表显示更新站点后仍可使用的管理员验证类型。

表 1. 站点更新后将在 XML API 中使用的管理员身份验证类型

站点更新前 XML API 中的管理员验证类型	站点更新后 SSO 组织中的管理员	站点更新后管理员不在 SSO 组织中
用户名 (webExID)/密码	将工作*	将工作*
用户名 (webExID)/sessionTicket	可行	可行
用户名/OAUTH (webExAccessToken)	可行	可行
电子邮件/密码	将工作*	将工作*
电子邮件/sessionTicket	可行	可行
电子邮件/OAUTH (webExAccessToken)	可行	可行

* 向后兼容性Cisco已启用用户名/密码验证，以便在站点更新后在 XML API 中正常工作，即使用户名与电子邮件不匹配（仅为非 SSO 组织）。 兼容性仅在以下情况下适用： 用户凭证是在站点更新之前创建的。 不允许更改用户名，否则之前的凭证将失效。 当在“站点管理”中管理用于 API 验证的凭证时，在 Control Hub 和站点中，用于 API 验证的凭证具有不同的密码。 您可以了解有关 Control Hub 托管站点上 XML API 集成的更多信息，包括 OAUTH 身份验证，与本指南。

当站点更新为 Control Hub 时，所有用户的用户名设置为电子邮件。 如果将 username 用于 API 负载，则在站点更新后负载必须使用电子邮件代替。

API 集成的 Control Hub 中的管理员角色

仅具有站点管理员角色的管理员可能无法使用 XML API 执行某些操作，例如在站点更新为 Control Hub 站点后更改用户的电子邮件地址或显示名称。 对于凭证用于 API 集成的管理员，我们建议您在 Control Hub 中将这些管理员提升为组织的完全权限管理员（最好是在将站点更新到 Control Hub 之前）。

作为最佳实践，我们建议您先更新测试站点，以确认 API 集成在更新到 Control Hub 后不会更改。

根据集成的执行情况，可能还需要在 Control Hub 站点上为管理员分配 Meetings主持人帐户，以便集成正常工作（站点管理站点中的管理员不需要执行此操作）。

同时添加（不在 SSO 部分中）。

用户名设置为当站点转换为 CH 时所有用户的电子邮件。

因此，如果用户名是 API 负载，则必须在站点转换后提供用户的电子邮件。

Control Hub 中 XML API 的差异

更新站点后，大多数 XML API 集成应该可以正常工作，无需任何更改。 但是，下表详述了一些例外情况：

• 创建用户- 在 Control Hub 托管的站点上，此操作还可能在分配许可证之前在站点拥有组织中创建用户。 如果用户已存在于其他组织中，此操作将会失败。 PMR ID parameter 对于没有 的用户，不会生效 活动中Control Hub 中的状态。

  createuser 在 Control Hub 托管的站点上完成 API 需要更长的时间。 为了获得更好的性能，您可以添加额外的线程来并行化 createuser 呼叫

• 设置用户- 可能导致向用户分配或删除会议站点许可证（取决于 API 参数或负载）。
• DelUser - 删除会议站点许可证，但不会从 Control Hub 组织中删除用户。
• LssummaryUser - 同时返回用户的 objectGUID 。
• 验证用户—在 Control Hub 托管的站点上，我们建议通过以下方式创建会话票证： AuthenticateUser 而不是对每个 XML API 使用用户名和密码。 对于 Control Hub 托管的站点，此调用不支持在正文内容中使用 SAML 响应。

REST API

Control Hub 有自己的 API，包括用于创建和许可以下用户的 People and License REST API：

• https://developer.webex.com/docs/api/v1/people

• https://developer.webex.com/docs/api/v1/licenses

还可通过 REST API 获取会话类型和跟踪代码，网址为：

• https://developer.webex.com/docs/api/v1/session-types
• https://developer.webex.com/docs/api/v1/tracking-codes

但是，上述 REST API 不支持 XML API 中提供的所有用户管理功能。 例如，您仍需使用 XML API 将会议许可证分配给拥有站点的组织以外的用户。 People API 不支持站点管理员角色的分配给用户。 如果要通过 API 分配站点管理员角色，仍需要使用 XML API。

您可以使用 People API 创建具有完全（或只读）权限的组织管理员，并且这些管理员还可以管理（或查看）您的 Control Hub 托管的会议站点。

Control Hub 具有特定于 Webex 站点的管理员角色，但 People API 目前无法分配此角色。

未来的计划（可能会发生变化）

• 新的许可证 API 还可将会议地点许可证授予与创建站点的组织不同的外部用户。 可手动获得外部用户许可现在在 Control Hub 中。
• 用于在组织中创建和删除用户的 SCIM API。
• Cisco 的长期发展方向是仅使用 REST API（用于用户和会议站点上的所有操作）。 在 REST API 可专用于所有用户管理操作之前，我们将继续支持用于用户管理的 XML API。 用户管理 XML API 也将被弃用（日期 TBD）。

如何检查将阻止站点更新的用户

1. 登录 站点管理并打开“更新管理 ” 页。

2. 打开查看更新管理的前提条件控件，然后单击导出 CSV 中受影响的用户。

3. 等待导出完成。 完成此过程可能需要一段时间，取决于开始时间和站点中的用户数。 在整点整点（在 xx:57 和 xx:03 之间），导出将暂停 6 分钟。

4. 完成导出后，单击下载 CSV。

   浏览器会下载 users-to-review.csv 。

5. 打开 CSV 文件，并选中建议的操作列（最后一列）。 对文件中的每个用户执行建议的操作。

电子邮件地址不匹配的用户

某些用户在站点管理和 Control Hub 中可能有不同的电子邮件地址。 如果将用户从此站点链接到 Control Hub 后，仅在两个位置中的一个位置更改了用户的电子邮件，则会出现这种情况。

请尝试以下操作来修复电子邮件地址不匹配的用户：

• 在站点管理中更改用户的电子邮件地址，以匹配 Control Hub 电子邮件地址

  用户可以编辑其站点管理档案： https://help.webex.com/nmi58lk/

• 在 Control Hub 中更改用户的电子邮件地址，以匹配站点管理的电子邮件地址： https://help.webex.com/nti2f6w/

  用户可以在 Control Hub 组织中更改自己的电子邮件地址： https://help.webex.com/nmdp0hq/

如果您将站点更新至 Control Hub，但不纠正用户电子邮件地址不匹配的问题，受影响的用户必须使用其 Control Hub 电子邮件地址登录会议地点。 这些用户可能无法登录，如果他们尝试使用 站点管理中的电子邮件地址登录，或者他们的 Control Hub电子邮件地址在其 IdP（适用于 SSO 组织）中不再有效。 他们不会阻止您更新站点，但最好在开始更新之前修复电子邮件地址。

拥有基本会议许可证的外部用户

具有以下权限的外部用户基本会议许可证将站点从站点管理更新为 Control Hub 之前，需要将其停用或升级为付费Webex Meetings许可证。

如何取消激活用户

停用用户时，用户将失去主持人许可证或与会者权限（取决于其在活动期间的角色）。 在将站点更新至 Control Hub 后，停用的用户仍将出现在站点 CSV 导出文件中。

对于站点管理中的单个用户停用：

1. 转至 用户管理 > 编辑用户。

2. 使用索引、搜索和过滤控件来查找用户。

3. 取消选中活动框。

4. 提交更改。

   请参阅在 Webex站点管理中管理用户帐户了解更多信息。

对于站点管理中的批量用户停用：

1. 将用户导出为 CSV 文件。

2. 打开 CSV 文件并修改 Active 列的值为 N （针对所有受影响的用户）。

3. 导入修改后的 CSV 文件。

   您更改的用户现在为非活动状态。

   请参阅在 Webex 站点管理中批量导入和导出 Webex 用户了解详细信息。

具有目录同步的组织中用户

如果有未关联用户应位于您的组织中，但尚未添加，您必须先将其添加到您的组织。 这对于已配置为目录同步（通过 目录连接器 或 Azure AD）的组织尤为重要，因为目录同步不允许站点更新过程添加用户。

如果站点上的任何活动用户无法链接到 Control Hub 组织，站点更新将失败。 如果您的组织已配置为目录同步，请确保在开始更新前先将站点中必须属于 Control Hub 组织的所有用户添加到 目录连接器 或 Azure AD。

在开始更新之前解决用户问题

如果您尝试将站点更新到 Control Hub，而不为站点中的用户解决问题， users-to-review 文件，则更新管理过程可能会失败。 在开始最终更新之前，工具不会检查您是否已经更正了这些问题。