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

本文的目的是说明您需要在 DocuSign 和 Microsoft Entra ID 中执行的步骤,以便从 Microsoft Entra ID 自动预配和撤销预配用户帐户到 DocuSign。

先决条件

本文中概述的方案假定你已具有以下项:

  • Microsoft Entra 租户。
  • 已启用 DocuSign 单一登录的订阅。
  • 具有团队管理员权限的 DocuSign 用户帐户。

将用户分配到 DocuSign

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

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

向企业应用分配用户或组

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

  • 建议将单个 Microsoft Entra 用户分配到 DocuSign 以测试预配配置。 其他用户可以稍后分配。

  • 将用户分配到 DocuSign 时,必须选择有效的用户角色。 “默认访问权限”角色不可用于预配。

注意

Microsoft Entra ID 不支持使用 Docusign 应用程序进行组预配,只能预配用户。

启用用户预配

本部分介绍了如何将 Microsoft Entra ID 连接到 DocuSign 的用户帐户预配 API 并配置预配服务,以便在 DocuSign 中根据 Microsoft Entra ID 中的用户和组分配创建、更新、禁用分配的用户帐户。

提示

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

配置用户帐户预配:

本部分的目的是概述如何对 DocuSign 启用 Active Directory 用户帐户的用户预配。

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

  2. 浏览到 Entra ID>企业应用

  3. 如果已为 DocuSign 配置单一登录,请使用搜索字段搜索 DocuSign 实例。 否则,请选择“添加”,然后在应用程序库中搜索“DocuSign”。 从搜索结果中选择 DocuSign,并将其添加到应用程序列表。

  4. 选择 DocuSign 实例,然后选择“预配”选项卡。

  5. 选择 + 新建配置

    “预配”选项卡的屏幕截图(自动)。

  6. “租户 URL ”字段中,输入 DocuSign 租户 URL 和机密令牌。 选择测试连接以确保Microsoft Entra ID可以连接到 DocuSign。 如果连接失败,请确保 DocuSign 帐户具有所需的管理员权限,然后重试。

  7. “概述”页上选择“属性”。

  8. 选择 “创建 ”以创建配置。

  9. 选择 “编辑” 图标以编辑属性。 启用通知电子邮件并提供电子邮件以接收隔离通知。 启用 意外删除防护。 选择“应用”保存更改。

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

    配置属性的屏幕截图。

  11. 在左侧面板中选择 “属性映射 ”,然后选择 用户

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

  13. 若要配置范围筛选器,请参阅 范围筛选器文章中提供的说明。

  14. 在组织中更广泛地部署之前,使用 按需预配 来验证与少数用户的同步。

  15. 准备好预配后,从“概述”页中选择“开始预配”。

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

故障排查提示

  • 通过 switchsingleAppRoleAssignment 函数在属性映射中使用表达式,可以实现在 Docusign 中为用户预配角色或者权限配置文件。 例如,当用户在 Microsoft Entra ID 中分配了“DS Admin”角色时,以下表达式将预配 ID“8032066”。 如果用户在 Microsoft Entra ID 端未被分配角色,则不会预配任何权限配置文件。 可从 DocuSign 门户检索该 ID。

Switch(SingleAppRoleAssignment([appRoleAssignments]),“、”DS Admin“、”8032066“)

其他资源