本文旨在演示如何在 Reward Gateway 和 Microsoft Entra ID 中执行步骤，以配置 Microsoft Entra ID，实现用户和/或组自动同步和取消同步到 Reward Gateway。
注意
本文介绍基于 Microsoft Entra 用户预配服务构建的连接器。 有关此服务的功能、工作原理以及常见问题的重要详细信息，请参阅使用 Microsoft Entra ID 自动将用户预配到 SaaS 应用程序和取消预配。
此连接器目前提供公共预览版。 有关预览版的详细信息，请参阅联机服务的通用许可条款。
先决条件
本文中概述的方案假定你已具备以下先决条件：
- 具有活动订阅的 Microsoft Entra 用户帐户。 如果还没有帐户，可以免费创建一个帐户。 - 以下角色之一： - 应用程序管理员 - 云应用程序管理员 - 应用程序所有者。
- Reward Gateway 租户。
- 在 Reward Gateway 中具有管理员权限的用户帐户。
将用户分配到 Reward Gateway
Microsoft Entra ID 使用名为分配的概念来确定哪些用户应收到对所选应用的访问权限。 在自动用户预配的上下文中，只同步已分配到 Microsoft Entra ID 中的应用程序的用户和/或组。
在配置和启用自动用户预配之前，应确定 Microsoft Entra ID 中需要访问 Reward Gateway 的用户和组。 确定后，可遵照将用户或组分配到企业应用中的说明，将这些用户和组分配到 Reward Gateway。
有关将用户分配到 Reward Gateway 的重要提示
建议将单个 Microsoft Entra 用户分配到 Reward Gateway 以测试自动用户预配配置。 其他用户和/或组可以稍后分配。
如果将用户分配到 Reward Gateway，必须在分配对话框中选择任何特定于应用程序的有效角色（如果有）。 具有“默认访问权限” 角色的用户排除在预配之外。
设置 Reward Gateway 用于预配
在使用 Microsoft Entra ID 为 Reward Gateway 配置自动用户预配之前，需要在 Reward Gateway 上启用 SCIM 预配。
登录到 Reward Gateway 管理员控制台。 选择 集成。
选择我的集成。
复制 SCIM URL (v2) 和 OAuth 持有者令牌的值。 这些值在 Reward Gateway 应用程序的“预配”选项卡中的“租户 URL”和“机密令牌”字段中输入。
从库中添加 Reward Gateway
要配置 Reward Gateway 以使用 Microsoft Entra ID 实现自动用户预配，需要从 Microsoft Entra 应用程序库将 Reward Gateway 添加到托管 SaaS 应用程序列表。
要从 Microsoft Entra 应用程序库中添加 Reward Gateway，请执行以下步骤：
- 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
- 请导航到 Entra ID>企业应用>新应用。
- 在“从库中添加”部分的搜索框中，键入 Reward Gateway，然后选择 Reward Gateway。
- 在结果面板中选择“Reward Gateway”，然后添加该应用。 在该应用添加到租户时等待几秒钟。
配置 Reward Gateway 的自动用户预配
本部分逐步介绍了如何配置 Microsoft Entra 预配服务，以根据 Microsoft Entra ID 中的用户和/或组分配在 Reward Gateway 中创建、更新和禁用用户和/或组。
提示
还可以选择按照 Reward Gateway 单一登录文章中提供的说明为 Reward Gateway 启用基于 SAML 的单一登录。 可独立于自动用户预配来配置单一登录，尽管这两个功能互相补充。
要在 Microsoft Entra ID 中为 Reward Gateway 配置自动用户预配，请执行以下操作：
至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心。
转到 Entra ID>企业应用
在应用程序列表中，选择“Reward Gateway” 。
选择“预配”选项卡。
将“预配模式”设置为“自动”。
在管理员凭据部分中，分别在租户 URL 和机密令牌中输入之前检索到的 SCIM URL (v2) 和 OAuth 持有者令牌值。 选择 “测试连接 ”，确保Microsoft Entra ID 可以连接到奖励网关。 如果连接失败，请确保 Reward Gateway 帐户具有管理员权限，然后重试。
在“通知电子邮件”字段中，输入应接收预配错误通知的个人或组的电子邮件地址，并选中复选框“发生故障时发送电子邮件通知” 。
选择“保存”。
在“映射”部分下，选择“将 Microsoft Entra 用户同步到 Reward Gateway”。
在“特性映射”部分，查看从 Microsoft Entra ID 同步到 Reward Gateway 的用户特性。 选为匹配属性的特性用于匹配 Reward Gateway 中的用户帐户以执行更新操作。 选择“保存”按钮以提交任何更改。
若要配置范围筛选器，请参阅 范围筛选器文章中提供的以下说明。
要为 Reward Gateway 启用 Microsoft Entra 预配服务，请在“设置”部分将“预配状态”更改为“开”。
通过在设置部分的范围中选择所需的值，定义要预配到 Reward Gateway 的用户和/或组。
准备好预配时，选择“保存”。
此操作会对“设置”部分的“范围”中定义的所有用户和/或组启动初始同步 。 初始同步执行的时间长于后续同步，只要 Microsoft Entra 预配服务正在运行，则大约每隔 40 分钟就会进行一次同步。 可使用“同步详细信息”部分监视进度并跟踪指向预配活动报告的链接，该报告描述了 Microsoft Entra 预配服务对 Reward Gateway 执行的所有操作。
要详细了解如何读取 Microsoft Entra 预配日志，请参阅有关自动用户帐户预配的报告。
连接器限制
Reward Gateway 目前不支持组预配。