教程：为 Cisco Webex 配置自动用户预配
本教程的目的是演示需要在 Cisco Webex 和 Microsoft Entra ID 中执行哪些步骤，以将 Microsoft Entra ID 配置为自动将用户预配到 Cisco Webex 以及对其取消预配。
注意
本教程介绍在 Microsoft Entra 用户预配服务之上构建的连接器。 有关此服务的功能、工作原理以及常见问题的重要详细信息，请参阅使用 Microsoft Entra ID 自动将用户预配到 SaaS 应用程序和取消预配。
此连接器目前提供预览版。 有关预览版的详细信息，请参阅联机服务的通用许可条款。
先决条件
本教程中概述的方案假定你已具有以下先决条件：
- 一个 Microsoft Entra 租户。
- Cisco Webex 租户。
- Cisco Webex 中具有管理员权限的用户帐户。
注意
此集成也可以通过 Microsoft Entra 美国政府云环境使用。 你可以在“Microsoft Entra 美国政府云应用程序库”中找到此应用程序，并以公有云相同的方式对其进行配置。
从库中添加 Cisco Webex
在使用 Microsoft Entra ID 为 Cisco Webex 配置自动用户预配之前，需要从 Microsoft Entra 应用程序库将 Cisco Webex 添加到托管的 SaaS 应用程序列表。
若要从 Microsoft Entra 应用程序库中添加 Cisco Webex，请执行以下步骤：
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。
在“从库添加”部分中，键入“Cisco Webex”，在结果面板中选择“Cisco Webex”，然后单击“添加”按钮来添加该应用程序。
将用户分配到 Cisco Webex
Microsoft Entra ID 使用名为“分配”的概念来确定哪些用户应收到对所选应用的访问权限。 在自动用户预配的上下文中，只同步“已分配到”Microsoft Entra ID 中的应用程序的用户和/或组。
在配置和启用自动用户预配之前，应确定 Microsoft Entra ID 中的哪些用户需要访问 Cisco Webex。 确定后，可以按照此处的说明将这些用户分配到 Cisco Webex：
有关将用户分配到 Cisco Webex 的重要提示
建议将单个 Microsoft Entra 用户分配到 Cisco Webex 以测试自动用户预配配置。 其他用户可以稍后分配。
如果将用户分配到 Cisco Webex，必须在分配对话框中选择任何特定于应用程序的有效角色（如果有）。 具有“默认访问权限” 角色的用户排除在预配之外。
配置 Cisco Webex 的自动用户预配
本部分介绍了如何配置 Microsoft Entra 预配服务以基于 Microsoft Entra 中的用户分配在 Cisco Webex 中创建、更新和禁用用户。
在 Microsoft Entra ID 中为 Cisco Webex 配置自动用户预配：
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“应用程序”>“企业应用程序”>“Cisco Webex”。
在应用程序列表中，选择“Cisco Webex” 。
选择“预配” 选项卡。
将“预配模式” 设置为“自动” 。
在“管理员凭据” 部分下，输入你的 Cisco Webex 帐户的“租户 URL” 和“机密令牌” 。
在“租户 URL” 字段中，以
https://api.ciscospark.com/v1/scim/[OrgId]的形式输入值。 若要获取[OrgId]，请登录到 Cisco Webex 控制中心。 单击左下角的组织名称，并复制“组织 ID”中的值 。若要获取“机密令牌” 的值，请导航到此 URL。 在出现的 webex 登录页面中，使用组织的完整 Cisco Webex 管理员帐户登录。 出现错误页面，指出无法访问站点，但这是正常情况。
复制 URL 中生成的持有者令牌的值，如下所示。 此令牌的有效期为 365 天。
填入步骤 5 中所示的字段后，单击“测试连接”以确保 Microsoft Entra ID 可以连接到 Cisco Webex。 如果连接失败，请确保 Cisco Webex 帐户具有管理员权限，然后重试。
在“通知电子邮件”字段中，输入应接收预配错误通知的个人或组的电子邮件地址，并选中复选框“发生故障时发送电子邮件通知” 。
单击“ 保存”。
在“映射”部分下，选择“将 Microsoft Entra 用户同步到 Cisco Webex”。
在“属性映射”部分，查看从 Microsoft Entra ID 同步到 Cisco Webex 的用户属性。 选为“匹配”属性的特性用于匹配 Cisco Webex 中的用户帐户以执行更新操作 。 如果选择更改匹配目标属性，则需要确保 Cisco Webex API 支持基于该属性筛选用户。 选择“保存”按钮以提交任何更改。
Attribute 类型 支持筛选 Cisco Webex 要求 userName 字符串 ✓ ✓ name.givenName 字符串 name.familyName 字符串 活动 Boolean displayName 字符串 externalId 字符串 在“映射”部分下，选择“将 Microsoft Entra 组同步到 Cisco Webex”。
在“属性映射”部分，查看从 Microsoft Entra ID 同步到 Cisco Webex 的组属性。 选为“匹配”属性的特性用于匹配 Cisco Webex 中的组以执行更新操作。 选择“保存”按钮以提交任何更改。
Attribute 类型 支持筛选 Cisco Webex 要求 displayName 字符串 ✓ ✓ members 参考 externalId 字符串 若要配置范围筛选器，请参阅范围筛选器教程中提供的以下说明。
若要为 Cisco Webex 启用 Microsoft Entra 预配服务，请在“设置”部分将“预配状态”更改为“开”。
通过在“设置”部分的“范围”中选择所需的值，定义要预配到 Cisco Webex 的用户和/或组 。
已准备好预配时，单击“保存” 。
此操作会对“设置”部分的“范围”中定义的所有用户和/或组启动初始同步 。 初始同步执行的时间长于后续同步，只要 Microsoft Entra 预配服务正在运行，则大约每隔 40 分钟就会进行一次同步。 可使用“同步详细信息”部分监视进度并跟踪指向预配活动报告的链接，该报告描述了 Microsoft Entra 预配服务对 Cisco Webex 执行的所有操作。
要详细了解如何读取 Microsoft Entra 预配日志，请参阅有关自动用户帐户预配的报告。
连接器限制
- Cisco Webex 当前处于 Cisco 的早期现场测试 (EFT) 阶段。 有关详细信息，请联系 Cisco 的支持团队。
- 有关 Cisco Webex 配置的详细信息，请参阅此处的 Cisco 文档。
更改日志
- 2023/07/02 - 添加了对组预配的支持。