REST API を使用して、埋め込み署名用の受信者を作成しようとしましたが、ID チェックが必要です。私はそれを機能させることができないようです。埋め込まれた署名部分は正常に動作しますが、ID チェックのプロンプトは表示されません。
埋め込み署名を使用すると、ユーザー認証の義務をアプリで処理できることはわかっていますが、私たちのビジネスでは、署名者に ID チェック機能で認証してもらいたいと考えています。
では、署名付きの ID チェック機能を使用することは可能ですか?
REST API を使用して、埋め込み署名用の受信者を作成しようとしましたが、ID チェックが必要です。私はそれを機能させることができないようです。埋め込まれた署名部分は正常に動作しますが、ID チェックのプロンプトは表示されません。
埋め込み署名を使用すると、ユーザー認証の義務をアプリで処理できることはわかっていますが、私たちのビジネスでは、署名者に ID チェック機能で認証してもらいたいと考えています。
では、署名付きの ID チェック機能を使用することは可能ですか?
DocuSign REST API を使用してエンベロープを作成する際に受信者認証方法を指定する方法は、次のいずれかによって異なります。
1) DocuSign テンプレートを使用して Envelope を作成する、または 2) Create Envelope API 呼び出しの一部としてドキュメントを提供して Envelope を作成する。
最初のケース (DocuSign テンプレートを使用してエンベロープを作成する) では、作成エンベロープ 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 $"
}
]
}
}
]
}
]
}
受信者の認証方法として ID チェックを指定するには、 requireIdLookupプロパティをtrueに設定し、idCheckConfigurationNameプロパティを受信者のID チェック $に設定する必要があることに注意してください。
後者の場合 (Create Envelope API 呼び出しの一部としてドキュメントを提供して Envelope を作成する)、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 チェックは必要ありません。