教程:为 Workgrid 配置自动用户预配

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

注意

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

先决条件

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

  • 一个 Microsoft Entra 租户。
  • Workgrid 租户
  • Workgrid 中具有管理员权限的用户帐户。

将用户分配到 Workgrid

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

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

将用户分配到 Workgrid 的重要提示

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

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

设置 Workgrid 以进行预配

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

  1. 登录到 Workgrid。 导航到“用户”>“用户预配”。

    Workgrid UI 的屏幕截图,其中突出显示了“用户”和“用户预配”选项。

  2. 在“帐户管理 API”下,单击“创建凭据” 。

    “帐户管理 API”部分的屏幕截图,其中突出显示了“创建凭据”选项。

  3. 复制“SCIM 终结点”和“访问令牌”值 。 将在 Workgrid 应用程序的“预配”选项卡的“租户 URL”和“机密令牌”字段中输入这些值。

    “帐户管理 API”部分的屏幕截图,其中突出显示了“SCIM 终结点”和“访问令牌”。

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

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

  1. 至少以云应用程序管理员身份登录到 Microsoft Entra 管理中心
  2. 浏览至“标识”>“应用程序”>“企业应用程序”>“新建应用程序”。
  3. 在“从库中添加”部分的搜索框中,键入“Workgrid”,选择“Workgrid”。
  4. 从结果面板中选择“Workgrid”,然后添加该应用。 在该应用添加到租户时等待几秒钟。 结果列表中的 Workgrid

配置 Workgrid 的自动用户预配

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

提示

还可选择按照 Workgrid 单一登录教程中提供的说明为 Workgrid 启用基于 SAML 的单一登录。 可独立于自动用户预配来配置单一登录,尽管这两个功能互相补充

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

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

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

    “企业应用程序”边栏选项卡

  3. 在应用程序列表中,选择“Workgrid”

    应用程序列表中的 Workgrid 链接

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

    “管理”选项的屏幕截图,其中突出显示了“预配”选项。

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

    “预配模式”下拉列表的屏幕截图,其中突出显示了“自动”选项。

  6. 在“管理员凭据”部分中,分别在“租户 URL”和“机密令牌”中输入之前检索到的“SCIM 终结点”和“访问令牌”值 。 单击“测试连接”,确保 Microsoft Entra ID 可以连接到 Workgrid。 如果连接失败,请确保 Workgrid 帐户具有管理员权限,然后重试。

    租户 URL + 令牌

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

    通知电子邮件

  8. 单击“ 保存”。

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

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

    Attribute 类型 支持筛选 Workgrid 必需
    userName 字符串
    活动 Boolean
    displayName 字符串
    title 字符串
    emails[type eq "work"].value 字符串
    preferredLanguage 字符串
    name.givenName 字符串
    name.familyName 字符串
    phoneNumbers[type eq "work"].value 字符串
    phoneNumbers[type eq "mobile"].value 字符串
    phoneNumbers[type eq "fax"].value 字符串
    externalId 字符串
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager 字符串
    addresses[type eq "work"].locality 字符串
    addresses[type eq "work"].postalCode 字符串
    addresses[type eq "work"].formatted 字符串
    addresses[type eq "work"].region 字符串
    addresses[type eq "work"].streetAddress 字符串
  11. 在“映射”部分下,选择“将 Microsoft Entra 组同步到 Workgrid”

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

    Attribute 类型 支持筛选 Workgrid 必需
    displayName 字符串
    externalId String
    members 参考
  13. 若要配置范围筛选器,请参阅范围筛选器教程中提供的以下说明。

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

    预配状态已打开

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

    预配范围

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

    保存预配配置

此操作会对“设置”部分的“范围”中定义的所有用户和/或组启动初始同步 。 初始同步所需的时间比后续同步要长。 若要详细了解预配用户和/或组所需的时间,请参阅预配用户所需的时间

可使用“当前状态”部分监视进度并跟踪指向预配活动报告的链接,这些报告描述了 Microsoft Entra 预配服务对 Workgrid 执行的所有操作。 有关详细信息,请参阅检查用户预配状态。 若要读取 Microsoft Entra 预配日志,请参阅有关自动用户帐户预配的报告

其他资源

后续步骤