使用DocuSign API遇认证错误，凭据无误却报错求排查

问题 #

我尝试用以下代码调用DocuSign API的RequestDocumentPDFs接口获取文档PDF：

docPDFs = apiService.RequestDocumentPDFs(envelopeID);

我的认证及客户端初始化代码如下：

String auth = "<DocuSignCredentials><Username>john.connolly@lechase.com</Username><Password>password</Password><IntegratorKey>20be051c-4c25-46c1-b0f1-1f10575a2e40</IntegratorKey></DocuSignCredentials>";
DSAPIServiceSoapClient client = new DSAPIServiceSoapClient("DSAPIServiceSoap");
using (System.ServiceModel.O...

明明用户名和密码是正确的，却持续收到「用户名和密码不正确」的错误提示，请问我哪里操作有误？

回答 #

让我帮你排查几个常见的问题点，这些都可能导致你遇到的认证错误：

• 确认认证凭证已正确传递：你定义了XML格式的auth字符串，但代码片段里没看到你把这个凭证传递给SOAP客户端。DocuSign的SOAP API需要把这个凭证放在请求的SOAP头里才能生效。你可以尝试补充这部分代码，用强类型对象传递更不容易出错：

  // 创建凭证对象并添加到客户端SOAP头
  var credentialsHeader = new DocuSignCredentials();
  credentialsHeader.Username = "john.connolly@lechase.com";
  credentialsHeader.Password = "password";
  credentialsHeader.IntegratorKey = "20be051c-4c25-46c1-b0f1-1f10575a2e40";
  client.DocuSignCredentialsHeaderValue = credentialsHeader;
  

• 检查Integrator Key与账户的关联状态：你的Integrator Key必须和目标账户（john.connolly@lechase.com）绑定才能正常使用。登录DocuSign开发者后台，找到这个密钥，确认它已经关联到你的账户——新创建的密钥通常需要手动完成关联步骤。

• 排查密码的特殊字符问题：如果你的真实密码包含<、>、&这类XML特殊字符，直接把它放在XML字符串里会导致解析失败，API会判定凭证无效。这种情况下，要么对密码做XML转义（比如把&换成&），要么用上面提到的强类型凭证对象传递，让框架自动处理转义。

• 确认API环境匹配：你连接的SOAP端点必须和你的凭证环境一致。如果用生产账户的凭证连接沙箱API（https://demo.docusign.net/api/3.0/dsapi.asmx），或者反过来，都会触发认证失败。检查你的DSAPIServiceSoap配置的端点地址是否正确。

• 双因素认证的影响：如果你的DocuSign账户开启了双因素认证（2FA），仅用用户名+密码+Integrator Key是无法通过认证的。这种情况下，你需要在账户设置里生成一个应用密码，用它替换代码里的普通密码；或者考虑切换到更安全的OAuth 2.0认证方式。

内容的提问来源于stack exchange，提问作者John Connolly