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

本教程的目标是展示为了从 Microsoft Entra ID 自动将用户帐户预配到 DocuSign 以及取消其预配,需要在 DocuSign 和 Microsoft Entra ID 中执行的步骤。

先决条件

在本教程中概述的方案假定您已具有以下各项:

  • 一个 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. 浏览到“标识”>“应用程序”>“企业应用程序”。

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

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

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

    Screenshot of the Provisioning tab for DocuSign in Azure portal. Provisioning Mode is set to Automatic and Admin Username, Password and Test Connection are highlighted.

  6. 在“管理员凭据”部分中,提供以下配置设置:

    1. 在“管理员用户名”文本框中,键入在 DocuSign.com 中已分配“系统管理员”配置文件的 DocuSign 帐户名称。

    2. 在“管理员密码”文本框中,键入此帐户的密码。

注意

如果同时设置了 SSO 和用户设置,则需要将用于预配的授权凭据配置为使用 SSO 和用户名/密码。

  1. 选择“测试连接”,确保 Microsoft Entra ID 可以连接到 DocuSign 应用。

  2. 在“通知电子邮件”字段中输入应收到预配错误通知的用户或组的电子邮件地址,并选中复选框。

  3. 单击“保存”

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

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

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

  7. 单击“保存” 。

此操作会对“用户和组”部分中分配到 DocuSign 的任何用户启动初始同步。 初始同步执行的时间比后续同步长,只要服务正在运行,大约每隔 40 分钟就会进行一次同步。 可以使用“同步详细信息”部分监视进度并跟踪指向预配活动日志的链接,这些日志描述了预配服务对 DocuSign 应用执行的所有操作。

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

疑难解答提示

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

Switch(SingleAppRoleAssignment([appRoleAssignments])," ", "DS Admin", "8032066")

其他资源