Php Csrf Audit

---
name: php-csrf-audit
description: PHP Web 源码 CSRF 审计工具。识别状态变更接口是否受 CSRF 保护，追踪 token 生成、校验与绕过条件，输出可利用性分级、PoC 与修复建议（禁止省略）。
---

# PHP CSRF 审计（php-csrf-audit）

分析 PHP 项目源码中，所有可能造成状态变更的接口（POST/PUT/PATCH/DELETE，或含副作用的 GET）是否实现了 CSRF 防护（token 校验、SameSite/CORS 配合、双提交 cookie 等）。

## 分级与编号
- 详见：`shared/SEVERITY_RATING.md`
- 漏洞编号：`{C/H/M/L}-CSRF-{序号}`

## 保护点与必检内容（强制）
必须识别并输出：
1. 状态变更入口：路由的 HTTP 方法、是否包含副作用（写数据库/更新权限/发起交易/触发任务等）
2. CSRF token 生成：token 来源（session/cookie/random）、字段名、注入到表单或请求头的方式
3. CSRF token 校验：后端验证逻辑位置与条件（是否只校验登录用户、是否存在绕过分支）
4. 校验绕过：是否存在“某些分支不校验”“仅校验特定 Content-Type”“只在 AJAX 时校验”等
5. 同源/跨站辅助：`SameSite`、CORS/跨域设置、Referer/Origin 校验（注意：Referer/Origin 单独依赖也可能不稳）

## 数据流追踪要求
必须追踪至少一条链：
- 从 token 来源（如 `$_SESSION['csrf']`）到前端输出
- 再到后端的 token 接收（`$_POST/headers`）与校验（比较/哈希校验）

## 报告输出
输出到：
```
{output_path}/vuln_audit/csrf_{timestamp}.md
```

## 漏洞条目模板（强制）
必须包含以下部分：
- 位置证据（路由 + 校验函数/中间件位置）
- 数据流链（token 生成 -> 前端携带 -> 后端校验）
- 可利用前置条件（是否需要登录；攻击者能否构造页面；浏览器同站策略）
- 验证 PoC（必须包含真实路由与请求结构；若需配合登录，给出 cookie/登录态说明）
- 建议修复（token 校验放置、失败响应策略、字段名统一、对绕过分支加覆盖）

## 证据引用（强制：来自 php-route-tracer）
每条 CSRF 风险必须逐项引用 trace 中的证据点（允许状态为待验证，但证据引用必须存在）：
1. `EVID_CSRF_STATE_CHANGE_HANDLER_EXEC`：状态变更 handler 的执行证据（trace 的分支路径证据）
2. `EVID_CSRF_TOKEN_SOURCE`：CSRF token 来源与生成证据（session/cookie/random 等）
3. `EVID_CSRF_TOKEN_RECEIVE`：CSRF token 在请求中的接收/进入校验逻辑的位置证据（trace 的参数进入点/分支证据）
4. `EVID_CSRF_TOKEN_VERIFY`：CSRF 校验比较/哈希判断位置证据（trace 的条件与早退证据）
5. `EVID_CSRF_BYPASS_BRANCH`：绕过分支证据（如仅校验某些 Content-Type 或仅对 AJAX 校验）

## tracer 证据缺失处理（强制）
- 若 trace 契约校验失败或缺失上述 1~5 任一关键证据点：该风险只能标记为 `⚠️待验证`，不得给出“已确认可利用”的断言。