使用新创建的集成密钥时遇到USER_AUTHENTICATION_FAILED错误

• 检查新集成密钥的权限配置
  新创建的IK很可能没关联正确的用户权限，或是没开启传统认证的权限。进入Demo账户的集成密钥管理页面，确认该IK已将你的用户添加为授权用户，同时检查“允许传统认证（如X-DocuSign-Authentication头）”的选项是否处于开启状态。

• 核对认证头格式准确性
  确保X-DocuSign-Authentication头的格式完全正确，尤其是新IK的ID不能出错。正确格式示例：

  <DocuSignCredentials><Username>你的用户名</Username><Password>你的密码</Password><IntegratorKey>新集成密钥ID</IntegratorKey></DocuSignCredentials>
  

  注意不要遗漏XML标签，也避免出现拼写错误。

• 验证Demo账户用户状态
  确认你的Demo账户没有被锁定、暂停，密码也未过期。尽管旧IK能正常工作，但新IK可能触发了不同的认证校验逻辑，建议重置一次密码后再尝试调用API。

• 检查多重认证（MFA）设置
  如果你的账户开启了MFA，传统的X-DocuSign-Authentication认证方式可能无法适配新IK。这种情况下，要么切换到OAuth认证方式，要么为新IK配置MFA豁免权限（仅适用于Demo环境测试）。

内容的提问来源于stack exchange，提问作者Catalina S