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

时间:2016-09-15 17:51:59

标签: docusignapi

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

2 个答案:

答案 0 :(得分:0)

当您说多因素身份验证时,您指的是"访问代码","手机","短信"或"基于知识&# 34;认证?如果是这样,请查看API文档中的EnvelopeRecipients Create,特别是签名者定义。我要看的属性是" requireIdLookup"," accessCode"," idCheckConfigurationName"," idCheckInformationInput"," phoneAuthentication&#34 ;," smsAuthentication",& " socialAuthentications"

实现此目标的另一种方法是使用SSO并让您的身份提供商需要多因素身份验证。

答案 1 :(得分:0)

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

使用访问代码,由发件人决定如何将发件人定义的代码传递给收件人(即他们可以调用并将其提供给他们,通过电子邮件发送或通过其他方式发送)。 SMS Auth是相同的概念,除了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

要添加SMS,您需要使用复合模板功能(请注意,如果您不想要,则不需要包含实际模板,只需在此情况下删除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 $"