应使用 $sent_http_access_control_allow_origin 而非 $http_origin,因其反映 nginx 实际发出的响应头值,真实体现浏览器校验内容,可精准审计跨域配置是否生效,避免伪造、空值或逻辑遗漏导致的误判。

直接通过 Nginx 变量 $sent_http_access_control_allow_origin 审计跨域响应头是否正确设置,是一种精准、低侵入的线上验证方式。它不依赖日志解析或人工抓包,而是利用 Nginx 在响应已发出后才可读取的“已发送响应头”变量,在真实请求生命周期中做一致性校验。
为什么用 $sent_http_access_control_allow_origin 而不是 $http_origin?
$http_origin 是请求头里的原始来源,可能被伪造或为空(如非 CORS 请求);而 $sent_http_access_control_allow_origin 是 Nginx 实际写入响应的值,反映最终生效策略——这才是浏览器真正检查的内容。审计目标是“发出去的头对不对”,不是“收到的 Origin 是什么”。
- 该变量仅在响应头已生成并准备发送时才可用(例如在
log_format或add_header ... always后的 location 块中) - 若响应未设置该头(如静态文件、404 页面、预检失败路径),该变量为空字符串
- 它天然规避了 header 被覆盖、重复添加或条件逻辑遗漏导致的“看似配置了,实则没生效”问题
在 access_log 中记录并核查实际发出的值
在 http 或 server 块中定义带该变量的日志格式:
log_format cors_audit '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_origin" "$sent_http_access_control_allow_origin" '
'"$request_method" "$http_referer"';然后在对应 server 或 location 中启用:
access_log /var/log/nginx/cors-audit.log cors_audit;
请求后查看日志,快速识别异常模式:
使用tbot机器ID身份文件配合tsh CLI,通过Teleport访问控制SSH登录托管主机或执行远程命令。
-
"https://a.com" ""→ 有 Origin 但没返回 Allow-Origin(配置缺失或未命中 location) -
"https://b.com" "*"→ 允许任意源,存在安全风险(尤其配合 credentials) -
"https://c.com" "https://c.com"→ 正常精确匹配 -
"null" "https://d.com"→ file:// 或 data:// 页面发起请求却被允许,需警惕
用 map + return 实现运行时策略合规性拦截
可在 Nginx 配置中基于该变量做动态判断,对不合规响应主动干预:
map $sent_http_access_control_allow_origin $cors_violation {
"" 1; # 未设置
"*" 1; # 通配符滥用(如同时设 credentials)
default 0;
}
server {
location /api/ {
# ……原有 CORS 配置(add_header 等)
if ($cors_violation) {
return 500 '{"error":"CORS policy violation"}';
}
}
}注意:此方式适用于调试和灰度环境,生产中建议优先修复配置而非拦截;if 在 location 内使用需确保语义清晰,避免与 rewrite 冲突。
结合 error_log 输出上下文辅助定位
在关键 location 中添加条件日志,只在异常时记录详细上下文:
if ($sent_http_access_control_allow_origin = "") {
error_log /var/log/nginx/cors-error.log warn
"MISSING CORS HEADER: $request_uri, origin=$http_origin, method=$request_method";
}
if ($sent_http_access_control_allow_origin = "*" && $http_cookie ~* "session") {
error_log /var/log/nginx/cors-error.log alert
"DANGEROUS WILDCARD + CREDENTIALS: $request_uri from $http_origin";
}这类日志能直指配置漏洞点,比如:静态资源目录意外暴露 CORS 头、登录态接口误配通配符、OPTIONS 预检未覆盖全部方法等。










