Embedded Signing场景下如何启用收件人身份验证？

嵌入式签名流程本身完全支持收件人身份验证，配置逻辑和远程签名（Remote Signing）基本一致，未触发验证通常是配置位置错误或者字段混淆导致的，按以下步骤配置即可：

• 身份验证规则必须在创建信封/添加收件人阶段配置，不要等到生成签名URL的时候再加。只要在收件人对象中正确写入验证规则，即使用clientUserId标记为嵌入式签名场景，DocuSign也会强制触发验证流程，不会跳过。
  常用验证方式的收件人配置示例如下：

  {
    "signers": [
      {
        "email": "signer@example.com",
        "name": "签名人姓名",
        "recipientId": "1",
        "clientUserId": "your_system_user_id", // 嵌入式签名必填字段，填写你自有系统内的用户唯一标识
        // 以下为身份验证配置，和远程签名配置规则完全相同，按需选择即可
        "accessCode": "custom_secure_access_code", // 访问码验证：签名人必须输入正确的预设访问码才能进入签名页
        "smsAuthentication": {
          "senderProvidedNumbers": ["+8613xxxxxxxx"] // 短信验证：签名人输入手机号收到的验证码完成校验
        },
        "identityVerification": {
          "workflowId": "account_available_workflow_id" // 高级身份核验（人脸、证件比对等）：填写账号后台已开通的验证工作流ID即可
        }
      }
    ]
  }
  

• 生成嵌入式签名URL的环节不需要额外添加身份验证参数。调用生成收件人视图（Recipient View）接口时，仅需传入常规的returnUrl（签名完成后的回跳地址）、clientUserId、authenticationMethod（标记你自有系统侧的用户登录方式，比如Password/SMS，这个字段不控制DocuSign侧的验证逻辑，不要混淆）即可，接口会自动继承收件人上绑定的验证规则。

常见踩坑提醒：如果配置后验证环节未触发，优先检查两个点：一是确认你的DocuSign账号已经开通对应验证方式的权限（比如高级身份核验需要额外开通服务，未开通时配置不会生效）；二是检查收件人配置中没有开启跳过校验相关的异常参数。

• 配置完成后直接访问生成的签名URL测试即可，正常流程为：打开链接后首先触发你配置的身份验证环节，校验通过后才会加载签名文档，体验和远程签名的验证流程完全一致。

内容的提问来源于stack exchange，提问作者Mohammed Gamal