Dify中调用多级权限API需构建分层鉴权链路:先确认API是否支持多级鉴权语义,再配置主OAuth连接,最后通过HTTP/JS/KV方式实现二级凭证注入与动态上下文传递。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Dify工作流中调用需多级权限控制的第三方API(如企业微信通讯录+自建SSO联合鉴权、GitHub私有仓库+组织策略拦截)时,单层OAuth2.0无法满足嵌套身份校验与动态scope升降级需求,必须构建分层凭证传递与上下文感知的鉴权链路。
确认目标API是否支持多级鉴权语义
打开目标服务的OpenAPI文档,搜索authorization、scope、on_behalf_of、sub_scopes或delegated_token字段;若文档中明确出现“delegate”、“impersonate”、“nested token”或“secondary authorization”等关键词,则该API原生支持多级鉴权流程。
若未找到上述关键词,但API同时接受Authorization: Bearer xxx和X-Secondary-Token: yyy两个Header,说明其采用双Token显式模式——这是可手动编排的多级鉴权信号。
不支持多级语义的API(例如仅校验单一Access Token且无scope继承机制)不可强行配置多级流程,否则将返回403 insufficient_scope或401 invalid_token错误。
在Dify中配置主OAuth连接(第一级)
进入Dify控制台 → 【Settings】→【Connections】→【+ New Connection】→ 选择【OAuth 2.0】。
填写以下必填项:【Client ID】、【Client Secret】、【Authorization URL】、【Token URL】、【Redirect URI】(必须与你在第三方平台注册的完全一致,大小写敏感)。
在【Scopes】栏输入基础权限,例如user:read org:read;注意:此处不能填写动态变量或LLM生成的scope,Dify会将其作为静态初始请求参数发送至授权URL。
保存后,Dify会生成一个Connection ID(形如conn_abc123),后续所有工具必须引用该ID才能复用此连接的令牌生命周期管理能力。
实现第二级鉴权:通过HTTP节点注入委托凭证
方法一:使用Dify内置HTTP节点发起二次令牌交换
在工作流中添加一个【HTTP Request】节点,Method选POST,URL填写目标服务提供的委托令牌端点(例如https://qyapi.weixin.qq.com/cgi-bin/service/token或https://api.github.com/applications/{client_id}/token)。
在Headers中添加:Authorization: Bearer {{connections.conn_abc123.access_token}},Body使用JSON格式,包含grant_type、subject_token、subject_token_type等字段(具体字段名以目标API文档为准)。
方法二:调用自定义JavaScript节点生成JWT委托令牌
添加【JavaScript】节点,在代码中调用crypto.subtle.importKey加载私钥(需提前存入Dify密钥管理服务KMS并绑定到该节点),再用jwt.sign生成符合RFC 7523标准的JWT,其中sub设为用户唯一标识,aud设为目标服务的委托端点URL,scope填入运行时动态计算的二级权限(如contacts:write:dept_456)。
【注意:私钥绝对不可硬编码在JS脚本中,必须通过secrets.get("wecom_jwt_key")方式安全读取】
方法三:复用已缓存的Secondary Token(适用于高频低变更场景)
在首次成功获取二级Token后,将其写入Dify内置KV存储:kv.set("wecom_dept_456_token", response.access_token, { expire: 3600 });后续调用前先kv.get("wecom_dept_456_token"),命中则跳过交换步骤,直接注入Header。
将多级凭证注入最终API请求
第一步:在最终调用目标API的【HTTP Request】节点中,禁用自动认证(取消勾选“Use connection authentication”)。
第二步:手动设置Headers:
- Authorization: Bearer {{connections.conn_abc123.access_token}}
- X-Delegated-Token: {{http_node_2.response.access_token}}(若用方法一)
- X-JWT-Assertion: {{js_node_3.output.jwt}}(若用方法二)
- X-Cached-Secondary-Token: {{kv.get("wecom_dept_456_token")}}(若用方法三)
第三步:检查目标API文档是否要求特定Header顺序或签名时间戳。若要求X-Request-Time,需在JavaScript节点中生成当前毫秒时间戳并注入;缺失该Header将导致签名验证失败,返回401 signature_invalid。
第四步:在Body或Query参数中传入impersonate_user_id或as_user字段(如有),值来自工作流上游变量,确保操作上下文与委托意图一致。


















