如何通过Power Automate对接DocuSign OAuth2并配置重定向URI

第一步：正确配置Power Automate HTTP触发流（重定向目标） #

• 创建即时云流，选择HTTP触发器，请求方法设置为GET
• 调整流的权限设置：进入流的“设置”→“安全性”，将“谁可以触发此流”改为“任何人”（DocuSign的OAuth服务需要无权限访问该端点传递授权码）
• 保存流后，复制完整的HTTP触发URL（包含所有后缀查询参数，比如https://prod-xx.westus.logic.azure.com:443/workflows/xxxx/triggers/manual/paths/invoke?api-version=2016-06-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=xxxx），确保完整无截断

第二步：在DocuSign演示环境配置重定向URI #

• 登录DocuSign演示平台（demo.docusign.net），进入你的应用后台
• 在“应用设置”→“OAuth”板块，粘贴刚才复制的完整HTTP流URL作为重定向URI，确保和流的URL完全匹配（包括https协议、所有查询参数，无空格或多余字符）
• 保存配置后等待5-10分钟（DocuSign的配置缓存需要时间刷新）

第三步：构造正确的DocuSign授权请求 #

• 你的授权流需要生成符合要求的授权URL，必须包含以下核心参数：
  • response_type=code（固定使用授权码模式）
  • client_id=你的DocuSign应用ID
  • redirect_uri=和DocuSign配置一致的完整HTTP流URL
  • scope=所需权限（比如signature%20impersonation，需URL编码）
  • state=随机字符串（用于CSRF校验，重定向后必须验证该值）

第四步：在重定向流中处理授权码 #

• 用户完成DocuSign授权后，会被重定向到HTTP流，此时请求查询参数会包含code和state
• 先验证state参数是否和授权请求中发送的一致，防止恶意请求
• 调用DocuSign演示环境的令牌端点https://account-d.docusign.com/oauth/token，发送POST请求获取access_token，请求参数需包含：
  • grant_type=authorization_code
  • code=重定向获取的授权码
  • redirect_uri=一致的HTTP流URL
  • client_id=你的应用ID
  • client_secret=你的应用密钥

常见坑点排查 #

• 重定向URI不匹配：DocuSign要求URI完全一致，哪怕多一个斜杠、参数顺序变化都会失败，务必复制完整流URL
• 流权限错误：若流设置为仅组织内用户可触发，DocuSign的请求会被拒绝，必须设为匿名访问
• 授权参数错误：scope需正确编码，state必须存在且验证，否则DocuSign会拒绝授权
• 端点混淆：演示环境的授权端点是https://account-d.docusign.com/oauth/auth，令牌端点是https://account-d.docusign.com/oauth/token，不要混用生产环境端点

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