Higress ai-proxy 内部信号头可伪造:客户端提供 x-higress-fallback-from 令伪装的 X-HI-ORIGINAL-AUTH 透传到下游
ai-security/gateway-security · verified
一句话结论
Higress v2.2.4 的 ai-proxy 把客户端可传入的 x-higress-fallback-from 当作“本网关内部重定向”的信号:只要该头非空,插件就跳过从当前 Authorization 重新锚定原始凭证的分支;随后因上下文为空又跳过覆盖 X-HI-ORIGINAL-AUTH 的步骤,客户端伪造的原始凭证头因此原样透传到下游,并在下游取值函数中优先于真实 Authorization。
原理
plugins/wasm-go/extensions/ai-proxy/main.go:161-197先用headerToOriginalHeaderMapping清掉映射中的头,然后读取x-higress-fallback-from:- 为空:视为“首次进入网关”,删除
X-HI-ORIGINAL-AUTH,从当前Authorization取出值并写入ctxOriginalAuth; - 非空:视为“内部重定向回入”,整段重锚定逻辑跳过。
main.go:199-217的saveContextsToHeaders只有在ctxOriginalAuth非空时才ReplaceHttpRequestHeader覆盖X-HI-ORIGINAL-AUTH。重锚定被跳过时ctxOriginalAuth未被赋值,取到默认空串,覆盖步骤也随之跳过,客户端给的值保留。util/http.go:204-212的GetOriginalRequestAuth先读X-HI-ORIGINAL-AUTH,非空直接返回;否则才回退到Authorization。因此伪造头在下游的“原始凭证”语义中优先级更高。- 代码注释本身写明了安全依赖:该信号可靠的前提是“外部调用者无法提供
x-higress-fallback-from”;保障方法是把x-higress-fallback-from与x-hi-original-auth列入 HCM 的internal_only_headers,但注释把它归为 defense-in-depth,默认部署并不满足这个前提。 - 这不是单个函数写错,而是四步各自正确的逻辑串起来形成的凭证注入:客户端带信号头 → 重锚定分支跳过 → 上下文为空 → 覆盖分支跳过 → 伪造头活到下游。任何下游消费者使用
GetOriginalRequestAuth(例如注释点名的 key-auth 在重定向后的重新认证)都会拿到攻击者给的值。
触发条件
- Higress v2.2.4 部署启用 ai-proxy 插件(原文以 openai 类型、customDomain/customPath 指向 mock 上游验证);
- HCM 未把
x-higress-fallback-from与x-hi-original-auth列入internal_only_headers(默认部署如此); - 攻击者能向网关路由发送请求,并可自带上述两个请求头;
- 下游存在使用
GetOriginalRequestAuth或直接读取X-HI-ORIGINAL-AUTH做鉴权/记账的消费者。
利用步骤
- 确认目标网关运行 Higress ai-proxy,且请求可到达插件处理链路。
- 发送两组请求做差分:A 组只带伪造的
X-HI-ORIGINAL-AUTH;B 组同时带x-higress-fallback-from: 1。 - 观察下游收到的头:A 组的伪造值应被替换为当前
Authorization(防护生效);B 组的伪造值应原样保留。 - 若下游有基于
X-HI-ORIGINAL-AUTH的鉴权、限流或记账逻辑,则攻击者可用 B 组构造任意“原始凭证”身份;具体能否接管身份取决于该消费者的实现。
PoC
# A 组:伪造 X-HI-ORIGINAL-AUTH,不带 fallback-from
curl -X POST http://<gateway>/v1/chat/completions \
-H 'Host: mock.local' \
-H 'Authorization: Bearer CLIENT-REAL-AUTH' \
-H 'X-HI-ORIGINAL-AUTH: FORGED-AAA' \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"hi"}]}'
# B 组:同样两个头,加上内部信号头
curl -X POST http://<gateway>/v1/chat/completions \
-H 'Host: mock.local' \
-H 'Authorization: Bearer CLIENT-REAL-AUTH' \
-H 'X-HI-ORIGINAL-AUTH: FORGED-BBB' \
-H 'x-higress-fallback-from: 1' \
-H 'Content-Type: application/json' \
-d '{"model":"gpt-4o","messages":[{"role":"user","content":"hi"}]}'
下游记录头部的 mock 预期结果:
A 组:x-hi-original-auth = Bearer CLIENT-REAL-AUTH
x-higress-fallback-from = (absent)
B 组:x-hi-original-auth = FORGED-BBB
x-higress-fallback-from = 1
原文还观察到插件会把 Authorization 替换为自己的 provider token;因此 B 组下游同时能看到 provider token(Authorization)与攻击者伪造的原始凭证头(X-HI-ORIGINAL-AUTH)。
变体与关联
- 变体:级联网关。上游网关自身可能处于 internal_redirect 链中再转发到本网关,此时更应把内部信号头列为 internal-only,否则级联链路上的任意客户端都可能注入。
- 变体:任何把“某个请求头是否存在”当作内部信号的实现。信号头一旦可被外部提供,依赖它的分支就会被外部控制。
- 关联 [[ai-security-gateway-security-kong-ai-proxy-upstream-template-key-leak]](密钥去向可被请求控制)与 [[ai-security-gateway-security-apisix-kong-secret-at-rest-audit]](密钥存放声明的落盘核查),本卡对应密钥/凭证在网关内部的“归属”环节。
- 证据边界:原文实测确认伪造的
X-HI-ORIGINAL-AUTH能活到下游;从“头透传”到“下游身份被换掉”还依赖下游消费者读取该头,原文未搭建完整的 key-auth 链路,因此本卡按 confidence: medium 标注,不把下游接管写成已实测。
检测与防御
- 配置修复:把
x-higress-fallback-from和x-hi-original-auth同时列入 HCM 的internal_only_headers,让外部请求无法提供;这应成为默认配置而不是可选加固。 - 代码/设计:不要用客户端可达的请求头作为“内部信号”;若必须使用,应在入口默认剥离,或改用不可伪造的签名/上下文标记。
- 下游排查:审计所有调用
GetOriginalRequestAuth或直接读取X-HI-ORIGINAL-AUTH的消费者(key-auth 重认证、审计、计费),确认其是否会把该头当作可信身份。 - 检测:在网关日志中标记同时出现
x-higress-fallback-from与外部来源的请求;对携带内部头的外部请求告警;检查 ai-proxy 上游请求中X-HI-ORIGINAL-AUTH与当前Authorization不一致的情况。