在docusign中实现多因子身份验证

Question

我正在寻找docusign node sdk中以下问题的解决方案。1.如何使用docusgin node sdk实现多因子认证。2.如何使用嵌入式签名在模板中显示用户信息。

Answer 1

DocuSign目前提供多达九(9)种不同形式的收件人身份验证，您可以阅读文档和网站查看完整列表。在使用该应用程序接口时，两个比较流行的收件人身份验证流是Access Code和。在这两种方法中，都使用唯一的代码来访问信封。

使用Access Code时，如何将发送者定义的代码传递给接收者取决于发送者(即，他们可以打电话并将代码交给他们、通过电子邮件发送或通过其他方式发送)。短信身份验证是相同的概念，除了DocuSign平台生成唯一的代码而不是发送者定义的代码，代码通过短信发送到他们的手机。

要为收件人添加访问代码身份验证，请执行以下操作：

{
    "status": "sent",
    "emailSubject": "Envelope with Access Code Auth",
    "documents": [{
        "documentId": "1",
        "name": "contract.pdf",
        "documentBase64": "base64 document bytes...",
    }],
    "recipients": {
        "signers": [{
            "email": "john@email.com",
            "name": "John Doe",
            "accessCode": "99999",
            "recipientId": "1",
            "clientUserId": "100"
        }]
    }
}

访问代码的最大长度为50个字符。请注意，上面的接收者将被设置为以嵌入方式签名，因为他们的clientUserId已设置。

要添加短消息，您需要使用复合模板功能(请注意，如果不想包含实际模板，则不需要包含实际模板，在这种情况下，只需删除serverTemplates节点)：

{
    "status": "sent",
    "emailSubject": "Please sign this for me",
    "compositeTemplates": [{
        "serverTemplates": [{
            "sequence": "1",
            "templateId": "[TEMPLATE_ID]"
        }],
        "inlineTemplates": [{
            "sequence": "1",
            "recipients": {
                "signers": [{
                    "name": "[SIGNER_NAME]",                
                    "email": "[SIGNER_EMAIL]",              
                    "routingOrder": "1",
                    "requireIdLookup": true,
                    "recipientId": "1",
                    "idCheckConfigurationName": "SMS Auth $",
                    "smsAuthentication": {
                        "senderProvidedNumbers": [
                            "1234567890"
                        ]
                    }
                }]
            }
        }]
    }]
}

将"1234567890"替换为收件人的移动电话号码。请注意，idCheckConfigurationName属性必须设置为"SMS Auth $"。

Answer 2

当您说多因素身份验证时，您指的是“接入码”、“电话”、“短信”或“基于知识的”身份验证？如果是这样，请查看API文档中的EnvelopeRecipients Create，特别是签名者定义。我要查看的属性是"requireIdLookup“、"accessCode”、"idCheckConfigurationName“、"idCheckInformationInput”、"phoneAuthentication“、"smsAuthentication”和"socialAuthentications“。

实现这一点的另一种方法是使用SSO，并让您的身份提供者要求多因素身份验证。