使用 REST API,我一直在尝试为嵌入式签名创建收件人,但仍然需要 ID 检查。我似乎无法让它工作。嵌入式签名部分工作正常,但没有提示我进行 ID 检查。
我知道通过嵌入式签名,我的应用程序可以处理用户身份验证职责,但我们的企业仍然希望让签名者使用 ID 检查功能进行身份验证。
那么,是否可以将 ID 检查功能与嵌入式签名一起使用?
使用 REST API,我一直在尝试为嵌入式签名创建收件人,但仍然需要 ID 检查。我似乎无法让它工作。嵌入式签名部分工作正常,但没有提示我进行 ID 检查。
我知道通过嵌入式签名,我的应用程序可以处理用户身份验证职责,但我们的企业仍然希望让签名者使用 ID 检查功能进行身份验证。
那么,是否可以将 ID 检查功能与嵌入式签名一起使用?
使用 DocuSign REST API 创建信封时如何指定收件人身份验证方法取决于您是否:
1) 使用 DocuSign 模板创建信封或 2) 通过提供文档作为创建信封 API 调用的一部分来创建信封。
在第一种情况下(使用 DocuSign 模板创建信封),您可以在 Create Envelope API 调用中使用复合模板来指定 ID 检查作为收件人身份验证的形式(即使您的模板没有指定任何形式的收件人身份验证) . 例如,此请求将创建一个信封(使用模板),为嵌入式收件人指定 ID 检查:
发布 https://{{env}}.docusign.net/restapi/{{version}}/accounts/{{acctId}}/envelopes
{
"emailSubject": "Please sign",
"emailBlurb": "Please sign...thanks!",
"status": "sent",
"compositeTemplates": [
{
"serverTemplates": [
{
"sequence": 1,
"templateId": "YOUR_TEMPLATE_ID"
}
],
"inlineTemplates": [
{
"sequence": 2,
"recipients": {
"signers": [
{
"email": "test@test.com",
"name": "Sally Adamson",
"recipientId": "1",
"clientUserId": "YOUR_CLIENT_USER_ID_VALUE",
"roleName": "Signer 1",
"requireIdLookup": "true",
"idCheckConfigurationName": "ID Check $"
}
]
}
}
]
}
]
}
请注意,您必须将requireIdLookup属性设置为true并将idCheckConfigurationName属性设置为收件人的ID Check $,以将 ID Check 指定为收件人身份验证方法。
在后一种情况下(通过提供文档作为创建信封 API 调用的一部分来创建信封),您只需将requireIdLookup属性设置为true并将idCheckConfigurationName属性设置为收件人的ID Check $。例如,此收件人结构(当包含在 Create Envelope API 请求的上下文中时)指定收件人将通过 ID 检查进行身份验证:
"recipients": {
"signers": [
{
"email": "test@test.com",
"name": "Bob Adamson",
"recipientId": "1",
"routingOrder": "1",
"idCheckConfigurationName": "ID Check $",
"requireIdLookup": "true",
"tabs": {
"signHereTabs": [
{
"recipientId": "1",
"tabLabel": "Customer_Signature",
"documentId": "1",
"pageNumber": "1",
"xPosition": "100",
"yPosition": "100"
}
]
}
}
]
}
这里可能有一个错误,但我通过在模板收件人身份验证设置中指定 RDA ID 检查来使其工作,然后当我在嵌入式签名 API 调用中引用该模板时,它在允许访问之前在 ID 检查开始信封。
这样做可以确认您可以将 RSA ID 检查与嵌入式签名相结合,这就是该部分的答案。但是,我必须在控制台中的模板级别设置 RSA 身份验证,并且我的请求中的requireIdLookup属性似乎被忽略了,这让我认为存在错误。
我将跟进 DocuSign 关于该属性对信封没有影响的问题,但是现在您应该能够按照上面的说明让它工作。如果您有时使用该模板并且不希望对收件人进行 RSA ID 检查,那么您可以简单地制作另一个完全相同但添加 ID 签入的模板,并在您的 API 调用中引用该新模板并在以下情况下使用第一个模板你不想要 RSA ID 检查。