教程：为 Clarizen One 配置自动用户预配

  • 项目

本教程介绍了在 Clarizen One 和 Microsoft Entra ID 中配置自动用户预配所需的步骤。 配置后，Microsoft Entra ID 会使用 Microsoft Entra 预配服务自动将用户和组预配到 Clarizen One 以及取消预配。 有关此服务的功能、工作原理以及常见问题的信息，请参阅使用 Microsoft Entra ID 自动化服务型软件 (SaaS) 应用程序用户预配和取消预配。

支持的功能

  • 在 Clarizen One 中创建用户。
  • 在用户不再有访问需求的情况下，在 Clarizen One 中删除用户。
  • 使用户属性在 Microsoft Entra ID 和 Clarizen One 之间保持同步。
  • 在 Clarizen One 中预配组和组成员身份。
  • 建议单一登录 (SSO) 到 Clarizen One。

先决条件

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

  • 一个 Microsoft Entra 租户。
  • Microsoft Entra ID 中具有配置预配权限的用户帐户。 示例有应用程序管理员、云应用程序管理员、应用程序所有者或全局管理员。
  • Clarizen One 中拥有集成用户和精简管理员权限的用户帐户。

步骤 1：规划预配部署

  1. 了解预配服务的工作原理。
  2. 确定谁在预配范围中。
  3. 确定在 Microsoft Entra ID 与 Clarizen One 之间映射的数据。

步骤 2：将 Clarizen One 配置为支持使用 Microsoft Entra ID 进行预配

  1. 根据 Clarizen One 环境和数据中心，选择以下四个租户 URL 中的一个：

  2. 生成 API 密钥。 将在 Clarizen One 应用程序的“预配”选项卡上的“机密令牌”框中输入此值。

从 Microsoft Entra 应用程序库中添加 Clarizen One，开始管理到 Clarizen One 的预配。 如果以前为 Clarizen One 设置过 SSO，则可以使用同一应用程序。 最初测试集成时，请创建单独的应用。 若要了解有关如何从库中添加应用程序的详细信息，请参阅向 Microsoft Entra 租户添加应用程序。

步骤 4：定义谁在预配范围中

使用 Microsoft Entra 预配服务，可以根据对应用程序的分配或用户或组的属性来限定谁在预配范围内。 如果选择根据分配来限定要将谁预配到应用，请按照在 Microsoft Entra ID 中管理应用的用户分配中的步骤将用户和组分配到应用程序。 如果选择仅根据用户或组的属性来限定要对谁进行预配，请使用使用范围筛选器进行基于属性的应用程序预配所述的范围筛选器。

  • 将用户和组分配到 Clarizen One 时，必须选择“默认访问”以外的角色。 具有“默认访问”角色的用户将从预配中排除，并在预配日志中被标记为未有效授权。 如果应用程序上唯一可用的角色是默认访问角色，则可以更新应用程序清单以添加更多角色。
  • 先小部分测试。 在向所有用户推出之前，先对一小部分用户和组进行测试。 如果预配范围设置为分配的用户和组，可以通过将一两个用户或组分配到应用来维持控制。 当预配范围设置为所有用户和组时，可以指定基于属性的范围筛选器。

步骤 5：配置到 Clarizen One 的自动用户预配

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

在 Microsoft Entra ID 中为 Clarizen One 配置自动用户预配

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

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

    Screenshot that shows the Enterprise applications pane.

  3. 在应用程序列表中，选择“Clarizen One”。

    Screenshot that shows the Clarizen One link in the Applications list.

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

    Screenshot that shows the Provisioning tab.

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

    Screenshot that shows the Provisioning tab Automatic option.

  6. 在“管理员凭据”部分，输入 Clarizen One 租户 URL 和机密令牌 。 选择“测试连接”，确保 Microsoft Entra ID 可以连接到 Clarizen One。 如果连接失败，请确保 Clarizen One 帐户具有管理员权限，然后重试。

    Screenshot that shows the Secret Token box.

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

    Screenshot that shows the Notification Email box.

  8. 选择“保存”。

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

  10. 在“属性映射”部分，查看从 Microsoft Entra ID 同步到 Clarizen One 的用户属性。 选为“匹配”属性的特性用于匹配 Clarizen One 中的用户帐户以执行更新操作。 如果更改匹配目标属性，则必须确保 Clarizen One API 支持基于该属性筛选用户。 选择“保存”按钮以提交任何更改。

    Attribute 类型
    userName 字符串
    displayName 字符串
    活动 Boolean
    title 字符串
    emails[type eq "work"].value 字符串
    emails[type eq "home"].value 字符串
    emails[type eq "other"].value 字符串
    preferredLanguage 字符串
    name.givenName 字符串
    name.familyName 字符串
    name.formatted 字符串
    name.honorificPrefix 字符串
    name.honorificSuffix 字符串
    addresses[type eq "other"].formatted 字符串
    addresses[type eq "work"].formatted 字符串
    addresses[type eq "work"].country 字符串
    addresses[type eq "work"].region 字符串
    addresses[type eq "work"].locality 字符串
    addresses[type eq "work"].postalCode 字符串
    addresses[type eq "work"].streetAddress 字符串
    phoneNumbers[type eq "work"].value 字符串
    phoneNumbers[type eq "mobile"].value 字符串
    phoneNumbers[type eq "fax"].value 字符串
    phoneNumbers[type eq "home"].value 字符串
    phoneNumbers[type eq "other"].value 字符串
    phoneNumbers[type eq "pager"].value 字符串
    externalId 字符串
    nickName 字符串
    区域设置 字符串
    roles[primary eq "True".type] 字符串
    roles[primary eq "True".value] 字符串
    timezone 字符串
    userType 字符串
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department 字符串
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber 字符串
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager 参考
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter 字符串
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division 字符串
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:division 字符串

  11. 在“映射”部分下，选择“将 Microsoft Entra 组同步到 Clarizen One”。

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

    Attribute 类型
    displayName 字符串
    externalId 字符串
    members 参考

  13. 若要配置范围筛选器，请参阅范围筛选器教程中的说明。

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

    Screenshot that shows the Provisioning Status toggled On.

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

    Screenshot that shows the provisioning Scope.

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

    Screenshot that shows saving the provisioning configuration.

此操作会对“设置”部分的“范围”中定义的所有用户和组启动初始同步周期 。 初始周期执行的时间比后续周期长，只要 Microsoft Entra 预配服务正在运行，后续周期大约每 40 分钟就会进行一次。

步骤 6：监视部署

配置预配后，请使用以下资源来监视部署。

  1. 通过预配日志来确定哪些用户已预配成功或失败。
  2. 检查进度栏以查看预配周期的状态以及完成进度。
  3. 如果怀疑预配配置处于非正常状态，则应用程序将进入隔离状态。 若要了解有关隔离状态的详细信息，请参阅隔离状态下的应用程序预配。

故障排除提示

将用户分配到 Clarizen One 库应用时，请仅选择“用户”角色。 以下角色无效：

  • 管理员 (admin)
  • 电子邮件报告用户
  • 外部用户
  • 财务用户
  • 社交用户
  • 超级用户
  • 时间和支出用户

其他资源

后续步骤