应该如何将标头 X-DocuSign-Authentication 用于 REST 和 SOAP？答案

【问题标题】：How should the header X-DocuSign-Authentication be used for REST and SOAP?应该如何将标头 X-DocuSign-Authentication 用于 REST 和 SOAP？
【发布时间】：2014-02-25 23:02:04
【问题描述】：

当用于 REST 和 SOAP 时，使用标头“X-DocuSign-Authentication”的选项和格式是什么？

【问题讨论】：

标签： rest soap docusignapi

【解决方案1】：

X-DocuSign-Authentication [HTTP 标头]

最佳实践： 在 api 身份验证标头中使用经过混淆的用户名和密码
定义： 代表权利发送 (API) 是 SOBO。

给定以下值：

用户名 == API 服务用户 == “service.account.user.member@domain.com” == USERID “cdcd3fc7-2b3c-40d4-98ed-ff90add317ca”
密码 == “你的密码” = EncryptedAPIPassword == “/A5hpPhSczID+JNEKZbg5mYf7+7=”
SOBOUser == “user.member@domain.com” == USERID “eacd3fc7-2b3c-40d4-98ed-ff90add317ff”
Integratorkey == “YDMN-339fa93c-fcf0-4390-8141-2e0f071ffa2e”

您的代码需要为 HTTP 标头生成一个 http 标头值 X-DocuSign-身份验证：

XML 格式：

非 SOBO

<DocuSignCredentials><Username>cdcd3fc7-2b3c-40d4-98ed-ff90add317ca</Username><Password>/A5hpPhSczID+JNEKZbg5mYf7+7=</Password><IntegratorKey>YDMN-339fa93c-fcf0-4390-8141-2e0f071ffa2e </IntegratorKey></DocuSignCredentials>

SOBO

<DocuSignCredentials><Username>cdcd3fc7-2b3c-40d4-98ed-ff90add317ca</Username><Password>/A5hpPhSczID+JNEKZbg5mYf7+7=</Password><IntegratorKey>YDMN-339fa93c-fcf0-4390-8141-2e0f071ffa2e</IntegratorKey><SendOnBehalfOf>eacd3fc7-2b3c-40d4-98ed-ff90add317ff </SendOnBehalfOf></DocuSignCredentials>

JSON 格式：

非 SOBO

{"Username":"cdcd3fc7-2b3c-40d4-98ed-ff90add317ca","Password":"/A5hpPhSczID+JNEKZbg5mYf7+7=","IntegratorKey":"YDMN-339fa93c-fcf0-4390-8141-2e0f071ffa2e"}

SOBO

{"Username":"cdcd3fc7-2b3c-40d4-98ed-ff90add317ca","Password":"/A5hpPhSczID+JNEKZbg5mYf7+7=","SendOnBehalfOf":"eacd3fc7-2b3c-40d4-98ed-ff90add317ff","IntegratorKey":"YDMN-339fa93c-fcf0-4390-8141-2e0f071ffa2e"}

API 服务用户 服务帐户不需要是管理员，除非您要创建用户，但必须具有 SOBO 和帐户范围权限。

SOBO 用户 SOBO用户不需要是Admin，但必须有发送权限，并且是Service Account用户的账户中的用户。仅当您执行该用户的操作（例如发送或作废）时，您才使用此用户 ID。

Here is a link to the full sized Infographic I created to assist with this shown below

【讨论】：

非常详细的答案 Grigs！
如何生成“混淆用户名”和“加密密码”？
我应该使用什么加密？
使 api 调用 /restapi/v2/login_information?api_password=true （注意 api_password=true 的参数。并在响应底部查找节点“apiPassword”：“encrpytedpassword”