教程：为 Playvox 配置自动用户预配
本教程介绍了在 Playvox 和 Microsoft Entra ID 中配置自动用户预配时需执行的步骤。 配置后，Microsoft Entra ID 会使用 Microsoft Entra 预配服务自动将用户或组预配到 Playvox 以及取消预配。 有关此服务的功能、工作原理的重要详细信息以及常见问题解答，请参阅使用 Microsoft Entra ID 为 SaaS 应用程序自动化用户预配和取消预配。
支持的功能
- 在 Playvox 中创建用户。
- 当用户不再有访问需求时，在 Playvox 中删除用户。
- 使用户属性在 Microsoft Entra ID 和 Playvox 之间保持同步
先决条件
本教程中的方案假定你已满足下列先决条件：
- 一个 Microsoft Entra 租户。
- Microsoft Entra ID 中具有配置预配权限的用户帐户。 例如，帐户可能有应用程序管理员、云应用程序管理员、应用程序所有者或全局管理员角色。
- Playvox 中具有超级管理员权限的用户帐户。
步骤 1：规划预配部署
步骤 2：将 Playvox 配置为支持通过 Microsoft Entra ID 进行预配
登录到 Playvox 管理控制台，转到“设置”“API 密钥”。
选择“创建 API 密钥”。
为 API 密钥输入一个有意义的名称，然后选择“保存”。 生成 API 密钥后，选择“关闭”。
在你创建的 API 密钥上，选择“详细信息”图标。
复制并保存“BASE64 密钥”值。 稍后，在 Azure 门户中，你将在 Playvox 应用程序的“预配”选项卡的“机密令牌”文本框中输入此值。
步骤 3：从 Microsoft Entra 应用程序库添加 Playvox
若要开始管理 Playvox 的预配，请从应用程序库中将 Playvox 添加到你的 Microsoft Entra 租户。 若要了解详细信息，请参阅快速入门：向 Microsoft Entra 租户添加应用程序。
如果以前已为 Playvox 设置过单一登录 (SSO)，则可以使用同一应用程序。 但是，我们建议你在初次测试集成时创建一个单独的应用。
步骤 4：定义谁在预配范围中
使用 Microsoft Entra 预配服务根据对应用程序的分配或用户或组的属性来限定谁在预配范围内。 若要根据分配来限定要将谁预配到应用，请参阅在 Microsoft Entra ID 中管理应用的用户分配，了解如何将用户或组分配到应用程序。 若要仅根据用户或组的属性来限定要对谁进行预配，请使用使用范围筛选器进行基于属性的应用程序预配所述的范围筛选器。
请记住以下几点：
将用户分配到 Playvox 时，必须选择“默认访问权限”以外的角色。 具有“默认访问”角色的用户将从预配中排除，并在预配日志中被标记为未有效授权。 如果“默认访问权限”是应用程序上唯一可用的角色，则可以更新应用程序清单来添加其他角色。
先小部分测试。 在向所有用户推出之前，请先在少量用户或组中进行测试。 如果预配作用域是基于分配的用户或组，则可以通过仅向应用分配一两个用户或组来控制集的大小。 如果预配作用域包括所有用户和组，则可以指定基于属性的作用域筛选器来限制测试集的大小。
步骤 5：配置 Playvox 的自动用户预配
本部分逐步介绍了如何配置 Microsoft Entra 预配服务，以根据 Microsoft Entra ID 中的用户或组分配创建、更新、禁用用户或组。
若要在 Microsoft Entra ID 中为 Playvox 配置自动用户预配：
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
浏览到“标识”>“应用程序”>“企业应用程序”。
在应用程序列表中，搜索并选择“Playvox”。
选择“预配” 选项卡。
将“预配模式” 设置为“自动” 。
在“管理员凭据”部分，输入你的 Playvox 租户 URL，如下所示：
https://{tenant}.playvox.com/scim/v1输入先前在步骤 2 中复制的“机密令牌”。 然后，选择“测试连接”以确保 Microsoft Entra ID 可以连接到 Playvox。 如果连接失败，请确保 Playvox 帐户具有管理员权限，然后重试。
在“通知电子邮件”文本框中，输入将接收预配错误通知的人员或组的电子邮件地址。 然后，选中“发生故障时发送电子邮件通知”复选框。
选择“保存”。
在“映射”部分，选择“将 Microsoft Entra 用户同步到 Playvox”。
在“属性映射”部分，查看从 Microsoft Entra ID 同步到 Playvox 的用户属性。 选为“匹配”属性的属性用于匹配 Playvox 中的用户帐户以执行更新操作。 如果你选择更改匹配的目标属性，请确保 Playvox API 支持基于该属性筛选用户的功能。 选择“保存”，提交所有更改。
属性 类型 支持筛选 userName 字符串 ✓ 活动 Boolean displayName 字符串 emails[type eq "work"].value 字符串 name.givenName 字符串 name.familyName 字符串 name.formatted 字符串 externalId 字符串 若要配置范围筛选器，请参阅范围筛选器教程中的说明。
若要为 Playvox 启用 Microsoft Entra 预配服务，请在“设置”部分将“预配状态”更改为“开”。
仍然在“设置”中，通过在“作用域”中选择所需的值，定义要预配到 Playvox 的用户或组。
准备好预配时，选择“保存”。
此操作会对“设置”部分的“范围”中定义的所有用户和组启动初始同步周期 。 初始周期比后续周期花费的时间要长。 只要 Microsoft Entra 预配服务正在运行，后续周期就会大约每 40 分钟出现一次。
步骤 6：监视部署
配置预配后，请使用以下资源来监视部署：
- 通过预配日志来确定哪些用户已预配成功或失败。
- 检查进度栏以查看预配周期的状态以及完成进度。
- 如果怀疑预配配置处于非正常状态，则应用程序将进入隔离状态。 若要了解有关隔离状态的详细信息，请参阅隔离状态下的应用程序预配。