使用 Microsoft Entra ID 为 Workgrid 配置自动用户预配

本文的目的是演示在 Workgrid 和 Microsoft Entra ID 中执行的步骤,以配置 Microsoft Entra ID 以自动将用户和/或组预配到 Workgrid 和取消预配。

注意

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

先决条件

本文中概述的方案假定你已具备以下先决条件:

- 具有活动订阅的 Microsoft Entra 用户帐户。 如果还没有帐户,可以免费创建一个帐户。 - 以下角色之一: - 应用程序管理员 - 云应用程序管理员 - 应用程序所有者

将用户分配到 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. 请导航到 Entra ID>企业应用>新应用
  3. 在“从库中添加”部分的搜索框中,键入“Workgrid”,选择“Workgrid”。
  4. 从结果面板中选择“Workgrid”,然后添加该应用。 在该应用添加到租户时等待几秒钟。 结果列表中的 Workgrid

配置 Workgrid 的自动用户预配

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

提示

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

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

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

  2. 转到 Entra ID>企业应用

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

  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 中的用户帐户以执行更新操作。 选择“保存”按钮以提交任何更改。

    特征 类型 支持筛选 Workgrid 必需
    用户名 字符串
    活动 布尔型
    显示名称 字符串
    标题 字符串
    emails[type eq "工作"].value 字符串
    首选语言 字符串
    名字.给定名 字符串
    姓名.姓氏 字符串
    phoneNumbers[type eq "工作"].value 字符串
    phoneNumbers[type eq "移动"].value 字符串
    电话号码[类型 eq “传真”].值 字符串
    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 “工作”].街道地址 字符串
  11. 在“映射”部分下,选择“将 Microsoft Entra 组同步到 Workgrid”

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

    特征 类型 支持筛选 Workgrid 必需
    显示名称 字符串
    externalId 字符串
    成员 参考
  13. 若要配置范围筛选器,请参阅 范围筛选器文章中提供的以下说明。

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

    预配状态已打开

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

    预配范围

  16. 准备好预配时,选择“保存”。

    保存预配配置

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

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

其他资源