| name | php-ssrf-audit |
| description | PHP Web 源码 SSRF 审计工具。识别用户可控 URL/地址进入网络请求 Sink，追踪内网/协议/端口限制与回显，输出可利用性分级、PoC 与修复建议（禁止省略）。 |
PHP SSRF 审计（php-ssrf-audit）
分析 PHP 项目源码，识别 SSRF 风险：用户可控 URL/主机/路径进入网络请求或读取类函数，且缺少协议 allowlist、DNS/IP 内网拒绝、端口限制等控制。
分级与编号
- 详见：
shared/SEVERITY_RATING.md
- 漏洞编号：
{C/H/M/L}-SSRF-{序号}
SSRF Sink（必做）
识别至少以下网络/地址访问点：
curl_setopt(CURLOPT_URL, $url) / curl_execfile_get_contents($url) / readfile($url) / fopen($url, {value})stream_get_contents($stream) / fsockopen / pfsockopenget_headers($url) / dns_get_record（配合地址解析时）
危险模式：- URL/Host/Port/Path 来自用户输入且可控
- 协议未限制（允许
file://、gopher://、php:// 等）
必做的安全检查点
- 协议白名单：仅允许
http/https（如有必要）
- DNS/IP 解析后内网网段拦截：拒绝
127.0.0.1/::1/10.0.0.0/8/172.16.0.0/12/192.168.0.0/16 等
- 端口限制：拒绝内网高危端口（由项目策略决定）
- 重定向处理：跟随跳转的限制（如
CURLOPT_FOLLOWLOCATION）
- 重定向与最终地址校验：即使初始 URL 通过 allowlist，仍必须对“重定向后的最终 URL”执行同等拦截与协议校验
- DNS rebinding 防护：允许域名访问时，必须在实际发起请求前进行最终解析，或使用安全解析策略避免“先外网后内网”
- URL 归一化：对编码后的主机/路径（双重编码、大小写、用户信息段
user:pass@host）先归一化再做 allowlist 判断
触发 tracer 的条件
- URL 由多字段拼接（schema + host + path + query）
- 存在多层函数调用或编码/解码/替换
- 安全判断依赖字符串规范化（必须追踪真实最终 URL）
报告输出
{output_path}/vuln_audit/ssrf_{timestamp}.md
漏洞条目模板（强制）
与 php-sql-audit 同结构，但在数据流链里必须覆盖：
- 最终用于发起请求的 URL/Host/Port 变量来源与拼接过程
- 协议选择与内网拦截判断的分支证据
证据引用（强制：来自 php-route-tracer）
每条 SSRF 疑似漏洞必须逐项引用 trace 输出中 ## 9) Sink Evidence Type Checklist 的 SSRF 行对应证据要点（禁止只写“可能”；允许状态为待验证，但证据引用必须存在）：
EVID_SSRF_URL_NORMALIZATION：URL 归一化步骤（对应 SSRF 行中的证据点）EVID_SSRF_FINAL_URL_HOST_PORT：发起请求前的最终 URL/Host/Port（对应 SSRF 行中的证据点）EVID_SSRF_FINAL_REDIRECT_URL：若存在重定向/跟随跳转：最终重定向后地址证据（对应 SSRF 行中的证据点）EVID_SSRF_DNSIP_AND_INNER_BLOCK：DNS/IP 解析与内网拦截判定证据（对应 SSRF 行中的证据点）
tracer 证据缺失处理（强制）
- 若在 trace 中找不到上述 1~4 任一关键证据点：该条漏洞状态只能标记为
⚠️待验证，不得给出 ✅已确认可利用。
PoC（强制）
- 必须给出可执行请求（HTTP 代码块）
- PoC URL 必须使用真实路由并替换为真实可控字段名
