教程:为 Federated Directory 配置自动用户预配

本教程的目的是演示需要在 Federated Directory 和 Microsoft Entra ID 中执行哪些步骤,以将 Microsoft Entra ID 配置为自动将用户和/或组预配到 Federated Directory 以及对其取消预配。

注意

本教程介绍在 Microsoft Entra 用户预配服务之上构建的连接器。 有关此服务的功能、工作原理以及常见问题的重要详细信息,请参阅使用 Microsoft Entra ID 自动将用户预配到 SaaS 应用程序和取消预配

先决条件

本教程中概述的方案假定你已具有以下先决条件:

将用户分配到 Federated Directory

Microsoft Entra ID 使用名为分配的概念来确定哪些用户应收到对所选应用的访问权限。 在自动用户预配的上下文中,只同步已分配到 Microsoft Entra ID 中的应用程序的用户和/或组。

在配置和启用自动用户预配之前,应确定 Microsoft Entra ID 中的哪些用户和/或组需要访问 Federated Directory。 确定后,可以按照此处的说明将这些用户和/或组分配到 Federated Directory:

有关将用户分配到 Federated Directory 的重要提示

  • 建议将单个 Microsoft Entra 用户分配到 Federated Directory 以测试自动用户预配配置。 其他用户和/或组可以稍后分配。

  • 如果将用户分配到 Federated Directory,必须在分配对话框中选择任何特定于应用程序的有效角色(如果有)。 具有“默认访问权限” 角色的用户排除在预配之外。

设置 Federated Directory 以进行预配

使用 Microsoft Entra ID 为 Federated Directory 配置自动用户预配之前,需要在 Federated Directory 上启用 SCIM 预配。

  1. 登录 Federated Directory 管理控制台

    Screenshot of the Federated Directory admin console showing a field for entering a company name. Sign in buttons are also visible.

  2. 导航到“目录”>“用户目录”,选择租户。

    Screenshot of the Federated Directory admin console, with Directories and Federated Directory Microsoft Entra ID Test highlighted.

  3. 若要生成永久持有者令牌,请导航到“目录密钥”>“创建新密钥”。

    Screenshot of the Directory keys page of the Federated Directory admin console. The Create new key button is highlighted.

  4. 创建目录密钥。

    Screenshot of the Create directory key page of the Federated Directory admin console, with Name and Description fields and a Create key button.

  5. 复制“访问令牌” 值。 在 Federated Directory 应用程序的“预配”选项卡中,该值将被输入“机密令牌”字段。

    Screenshot of a page in the Federated Directory admin console. An access token placeholder and a key name, description, and issuer are visible.

若要使用 Microsoft Entra ID 为 Federated Directory 配置自动用户预配,需要从 Microsoft Entra 应用程序库将 Federated Directory 添加到托管 SaaS 应用程序列表。

若要从 Microsoft Entra 应用程序库中添加 Federated Directory,请执行以下步骤:

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心

  2. 浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。

  3. 在“从库中添加”部分中键入“Federated Directory”,在结果面板中选择“Federated Directory”。

    Federated Directory in the results list

  4. 导航到下面单独浏览器中突出显示的 URL。

    Screenshot of a page in the Azure portal that displays information on Federated Directory. The U R L value is highlighted.

  5. 单击“登录”。

    Screenshot of the main menu on the Federated Directory site. The Log in button is highlighted.

  6. 由于 Federated Directory 是 OpenIDConnect 应用,因此请选择使用 Microsoft 工作帐户登录 Federated Directory。

    Screenshot of the S C I M A D test page on the Federated Directory site. Log in with your Microsoft account is highlighted.

  7. 身份验证成功后,请接受同意页面的同意提示。 然后,该应用程序将自动添加到你的租户,你会被重定向到你的 Federated Directory 帐户。

    federated directory Add SCIM

配置 Federated Directory 的自动用户预配

本部分逐步介绍了如何配置 Microsoft Entra 预配服务,以根据 Microsoft Entra ID 中的用户和/或组分配在 Federated Directory 中创建、更新和禁用用户和/或组。

若要在 Microsoft Entra ID 中为 Federated Directory 配置自动用户预配,请执行以下操作:

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心

  2. 浏览到“标识”>“应用程序”>“企业应用程序”

    Enterprise applications blade

  3. 在“应用程序”列表中,选择“Federated Directory”。

    The Federated Directory link in the Applications list

  4. 选择“预配”选项卡。

    Screenshot of the Manage options with the Provisioning option called out.

  5. 将“预配模式” 设置为“自动” 。

    Screenshot of the Provisioning Mode dropdown list with the Automatic option called out.

  6. 在“管理员凭据”部分下,在“租户 URL”中输入 https://api.federated.directory/v2/。 在“机密令牌”中,输入先前从 Federated Directory 检索到并保存的值。 单击“测试连接”,确保 Microsoft Entra ID 可以连接到 Federated Directory。 如果连接失败,请确保 Federated Directory 帐户具有管理员权限,然后重试。

    Tenant URL + Token

  7. 在“通知电子邮件”字段中,输入应接收预配错误通知的个人或组的电子邮件地址,并选中复选框“发生故障时发送电子邮件通知” 。

    Notification Email

  8. 单击“保存” 。

  9. 在“映射”部分下,选择“将 Microsoft Entra 用户同步到 Federated Directory”。

    Screenshot of the Mappings section. Under Name, Synchronize Microsoft Entra users to Federated Directory is highlighted.

  10. 在“属性映射”部分,查看从 Microsoft Entra ID 同步到 Federated Directory 的用户属性。 选为“匹配”属性的特性用于匹配 Federated Directory 中的用户帐户以执行更新操作。 选择“保存”按钮以提交任何更改 。

    Screenshot of the Attribute Mappings page. A table lists Microsoft Entra ID and Federated Directory attributes and the matching status.

  11. 若要配置范围筛选器,请参阅范围筛选器教程中提供的以下说明。

  12. 若要为 Federated Directory 启用 Microsoft Entra 预配服务,请在“设置”部分将“预配状态”更改为“开”。

    Provisioning Status Toggled On

  13. 通过在“设置”部分的“范围”中选择所需的值,定义要预配到 Federated Directory 的用户和/或组 。

    Provisioning Scope

  14. 已准备好预配时,单击“保存” 。

    Saving Provisioning Configuration

此操作会对“设置”部分的“范围”中定义的所有用户和/或组启动初始同步 。 初始同步执行的时间长于后续同步,只要 Microsoft Entra 预配服务正在运行,则大约每隔 40 分钟就会进行一次同步。 可使用“同步详细信息”部分监视进度并访问指向预配活动报告的链接,该报告描述了 Microsoft Entra 预配服务对 Federated Directory 执行的所有操作。

要详细了解如何读取 Microsoft Entra 预配日志,请参阅有关自动用户帐户预配的报告

其他资源

后续步骤