====== 一文讲清楚:什么是 CSRF ======
**CSRF(Cross-Site Request Forgery,跨站请求伪造)** 是一种「借刀杀人」式的攻击:攻击者**既不需要偷走你的 Cookie,也不需要知道你的密码**,只需在第三方页面里埋一段代码,诱导你的浏览器**带着你已经登录的 Cookie**,向目标站点发出一个你并不知情的请求。请求是受害者浏览器亲自发的、Cookie 也完全合法,服务端从请求本身看不出任何异常。
一句话对比:
* **XSS 是「偷令牌」**:用脚本把凭证读走,之后攻击者可以在任何地方使用它。
* **CSRF 是「盗用令牌」**:凭证一步都没离开受害者浏览器,攻击者只是让浏览器替他动手。
===== 一、攻击为什么能成立 =====
根子在浏览器的两个设计上:
* **Cookie 会自动携带**:向某个域发请求时,浏览器会自动附上该域下的 Cookie,**不管这个请求是从哪个页面发起的**。
* **表单、图片、脚本等标签天生能跨站发请求**:''form''、''img''、''script'' 这类标签的请求都不受同源策略阻止「发送」。
于是就有了一条公式:**身份判断依赖 Cookie + 请求可以跨站发起 = CSRF 的生存土壤。**
要特别记住:**Cookie 上的 ''HttpOnly'' 拦不住 CSRF。** ''HttpOnly'' 只禁止 JS 读取 Cookie(防偷读),并不阻止浏览器自动带 Cookie(防盗用)。这一点在 [[jwt]] 里也专门说过。
===== 二、一次典型的攻击 =====
假设 ''bank.example.com'' 用 Cookie 维持登录态,修改绑定邮箱的接口是:
POST /profile/email HTTP/1.1
Host: bank.example.com
Cookie: session=abc123
Content-Type: application/x-www-form-urlencoded
email=hacker%40evil.com
服务端只检查「Cookie 里有没有有效 session」,有就执行。那么攻击者只需在自己站点放一个表单,指向这个接口、填好恶意参数,再用一行脚本自动提交:
只要受害者在**已登录**的状态下打开这个页面,浏览器就会带上 ''session=abc123'' 提交表单,邮箱被改掉,而受害者只看到页面闪了一下。
反过来说:如果受害者没登录,服务端校验 session 失败,攻击无效。**所以「受害者处于登录态」是 CSRF 成立的前提。**
常见的后果:
* 悄悄转账、下单
* 修改收件地址、绑定手机、绑定邮箱
* 冒名发帖、点赞、关注、授权第三方应用
* **登录 CSRF**:把受害者登录进**攻击者的账号**,此后受害者的操作记录、保存的信息全落到攻击者账号里(受害者往往察觉不到)
* **登出 CSRF**:强制登出,通常用来配合其他攻击
===== 三、GET 还是 POST =====
早期 CSRF 常靠图片标签发起,例如在页面里放一张「图片」,其地址其实是转账接口、参数就写在 URL 里 —— 因为图片、脚本、样式表都能跨站发起 GET。
所以第一条设计纪律是:**任何会改变状态的操作一律用 POST(或 PUT / PATCH / DELETE),绝不用 GET。** 但仅仅这样还不够——隐藏表单可以发 POST,所以 POST 只是必要条件,不是防护手段。
^ 方式 ^ 能否跨站发送 ^ 能否读响应 ^ 说明 ^
| 表单提交 | 能 | 不能 | 经典 CSRF 载体,可发 GET 和 POST |
| ''img'' / ''script'' / ''link'' | 能 | 否(''script'' 有限) | 只能发 GET |
| ''fetch'' / ''XMLHttpRequest'' 简单请求 | 能 | 默认不能读 | 受同源策略限制读响应,但请求已经发出去了 |
| ''fetch'' 带自定义头 | **会先发 OPTIONS 预检** | 预检不通过就发不出 | 这正是防 CSRF 的一个抓手 |
**重要:同源策略和 CORS 限制的是「读取响应」,不是「发送请求」。** 所以「接口的响应对方拿不到」完全不能阻止 CSRF —— 攻击者要的本来就不是响应,而是「服务端执行了这次操作」这个副作用。
===== 四、和相邻概念的区分 =====
^ 缩写 ^ 全称 ^ 攻击者借的是谁 ^ 一句话 ^
| **XSS** | Cross-Site Scripting | 目标站点的**信任关系** | 在自己页面里执行攻击者脚本,能偷 Cookie、读 DOM |
| **CSRF** | Cross-Site Request Forgery | 受害者的**登录态** | 让受害者的浏览器替攻击者发请求 |
| **SSRF** | Server-Side Request Forgery | **服务器**的网络位置 | 让服务器去请求内网地址 |
| **CORS** | 跨源资源共享 | 不是攻击 | 浏览器放宽同源策略的机制,配错会放大风险 |
| **Clickjacking** | 点击劫持 | 用户的**点击** | 用透明 iframe 骗用户点真实按钮 |
XSS 与 CSRF 的关系:**有 XSS 时,CSRF 防护基本失效**——脚本能直接读走页面里的 CSRF token,或者干脆以受害者身份调用接口。所以「先解决 XSS,再谈 CSRF」的顺序不能反。相关防护见 [[安全头]] 中的 CSP。
===== 五、怎么防 =====
防护思路只有一句:**让服务端能够确认「这个请求是本站自己的页面主动发起的」,而不只是「带着一张合法 Cookie」。**
==== 1. CSRF Token(最主流) ====
服务端生成一个攻击者猜不到的随机值,随页面下发给本站前端;所有改状态的请求都必须带回它,服务端比对。
**同步令牌模式(Synchronizer Token Pattern)**:token 只存在服务端 session 里,页面表单里带上,提交时比对。
// Express:生成与校验
import crypto from "node:crypto";
app.use((req, res, next) => {
if (!req.session.csrfToken) {
req.session.csrfToken = crypto.randomBytes(32).toString("base64url");
}
res.locals.csrfToken = req.session.csrfToken; // 模板里用
next();
});
// 所有「改状态」的方法统一拦截;GET/HEAD/OPTIONS 视为安全方法放行
app.use((req, res, next) => {
if (["GET", "HEAD", "OPTIONS"].includes(req.method)) return next();
const sent = req.body._csrf || req.get("x-csrf-token");
const expected = req.session.csrfToken;
if (!sent || !expected) return res.status(403).send("CSRF token missing");
// 用恒定时间比较,避免时序侧信道
const a = Buffer.from(sent);
const b = Buffer.from(expected);
if (a.length !== b.length || !crypto.timingSafeEqual(a, b)) {
return res.status(403).send("CSRF token invalid");
}
next();
});
**双重提交 Cookie(Double Submit Cookie)**:不依赖 session,token 一份放 Cookie、一份放请求头/请求体,服务端只比对两者是否相等。
// 下发(注意:前端要读出来,所以不能带 HttpOnly)
res.cookie("csrf_token", token, {
httpOnly: false,
secure: true,
sameSite: "lax",
path: "/",
});
// 校验
const cookieToken = req.cookies["csrf_token"];
const headerToken = req.get("x-csrf-token");
if (!cookieToken || cookieToken !== headerToken) {
return res.status(403).end();
}
双重提交的固有弱点是「Cookie 固定」:如果攻击者能往目标域写 Cookie(子域 XSS、中间人、子域被接管),就能把 token 固定成已知值。缓解办法:
* 给 token 加 **HMAC 签名**,Cookie 里放「随机值 + 签名」,服务端验签后再比对;
* Cookie 名加 **Host 前缀**(前缀以两个下划线开头),它会强制 ''Secure'' + ''Path=/''
且不允许带 ''Domain'',从而阻止子域覆盖;
* 或者干脆用同步令牌模式(服务端存 session)。
Host 前缀的写法示例(名字最前面是两个下划线):
Set-Cookie: __Host-session=abc123; Secure; HttpOnly; Path=/
==== 2. SameSite Cookie(最省事的兜底) ====
Set-Cookie: session=abc123; Secure; HttpOnly; SameSite=Lax
^ 取值 ^ 行为 ^ 副作用 ^
| ''Strict'' | 完全不随跨站请求携带 | 从外部站点点链接进来会掉登录态 |
| ''Lax'' | 跨站 **GET 导航** 携带,跨站 **POST 不携带** | 主流折中,现代浏览器默认值 |
| ''None'' | 允许跨站携带,**必须同时带 ''Secure''** | 仅真跨站场景(如嵌入第三方页面) |
''SameSite=Lax'' 已经能挡掉绝大多数「隐藏表单 POST」攻击,是性价比最高的一层。但**不要只依赖它**:
* 老浏览器可能忽略该属性;
* **同站子域之间的请求算 SameSite**(''a.example.com'' → ''b.example.com'' 属于同站),子域被攻陷就绕过了;
* 跨站的 **GET 导航** 仍然携带 Cookie,如果站点存在「GET 就能改状态」的接口就还是危险。
==== 3. 校验 Origin / Referer(服务端主动检查) ====
app.use((req, res, next) => {
if (["GET", "HEAD", "OPTIONS"].includes(req.method)) return next();
const origin = req.get("origin") || req.get("referer");
const allow = ["https://app.example.com", "https://example.com"];
if (!origin || !allow.some(o => origin.startsWith(o))) {
return res.status(403).send("Bad origin");
}
next();
});
要点:
* ''Origin'' 比 ''Referer'' 更可靠(不受 ''Referrer-Policy'' 影响、不带路径),现代浏览器对 ''fetch''/表单 POST 都会带;
* ''Referer'' 可能为空(用户隐私设置、HTTPS 跳 HTTP),**「空 Referer 就放行」是常见错误**,安全策略下应当拒绝;
* 这是一层**补充**,不是替代 token——因为校验逻辑写错、漏掉某些入口的情况很常见。
==== 4. 自定义请求头 + 严格 CORS(前后端分离最实用) ====
跨站的「简单请求」不能带自定义头:一旦请求带 ''X-Requested-With''、''X-CSRF-Token'' 之类的头,浏览器会**先发 OPTIONS 预检**,而预检通不过(服务端白名单不允许该来源)请求就发不出去。于是:
* 前端所有写操作统一带自定义头(例如 ''x-csrf-token'');
* 后端 CORS 白名单**精确到域名**,''Access-Control-Allow-Origin'' 不使用通配符;
* 前后端分离时同时打开凭据:前端请求带 ''credentials: "include"'',后端 ''Access-Control-Allow-Credentials: true''。
顺带说一句:**CORS 本身不是 CSRF 防护**。它只决定「能不能读响应」,宽松的 CORS 只会放大风险,不会挡住请求。
==== 5. 设计层面的习惯 ====
* **状态改变一律 POST / PUT / PATCH / DELETE**,不放在 GET 里;
* **敏感操作二次确认**:重设密码、改绑手机、大额转账时要求输入原密码或 OTP —— 这一层攻击者无法伪造;
* **凭证走请求头而非 Cookie**:把 access token 放内存、用 ''Authorization: Bearer'' 传递,业务请求根本不带 Cookie,就**天然免疫 CSRF**(代价与取舍见 [[jwt]] 的方案 B);
* **缩短会话寿命、重要操作要求重新认证**;
* 给 Cookie 加上 ''Secure''、''HttpOnly''、''SameSite'' 等属性,组合使用。
==== 6. 常见框架的实现 =====
^ 框架 ^ 做法 ^ 备注 ^
| Django | ''CsrfViewMiddleware'' 中间件 + 模板标签输出 csrf token | 内置;默认还会校验 Referer |
| Spring Security | 默认开启 CSRF,''CookieCsrfTokenRepository.withHttpOnlyFalse()'' | SPA 场景常改用 Cookie 仓库 + 前端带头 |
| Laravel | ''VerifyCsrfToken'' 中间件 + ''@csrf'' | 下发 ''XSRF-TOKEN'' Cookie,前端放 ''X-XSRF-TOKEN'' 头 |
| Rails | 控制器里声明防伪保护(默认开启) | 内置 |
| Next.js | Server Actions **内置** Origin / Host 比对 | 但 Route Handlers(app 目录下的接口文件)**没有**内置防护,要自己加 |
| Express | ''csurf'' **已于 2022 年废弃** | 新项目用 ''csrf-csrf''(双重提交)或自行实现 |
Django 模板标签与 Rails 控制器声明的原文:
{% csrf_token %}
protect_from_forgery with: :exception
==== 7. 前后端分离 / SPA 的推荐组合 ====
* Cookie:''Secure; HttpOnly; SameSite=Lax''(更敏感的用 ''Strict'')
* CSRF token:双重提交 + HMAC 签名,或同步令牌模式存在 Redis
* 前端:所有写请求统一带 ''x-csrf-token'' 头
* 后端:校验 token + 校验 ''Origin'' + CORS 白名单精确到域名
* 更彻底的做法:access token 放内存走请求头,业务接口不依赖 Cookie
===== 六、上线检查清单 =====
* 所有改状态的接口只接受 POST / PUT / PATCH / DELETE,GET 是幂等的
* 会话 Cookie 带 ''Secure'' + ''HttpOnly'' + ''SameSite=Lax''(或 ''Strict'')
* 每个写操作都校验 CSRF token,包括 AJAX / fetch,不只是 HTML 表单
* token 随机、足够长(≥ 32 字节)、有生命周期,比对用恒定时间函数
* 服务端校验 ''Origin''(''Referer'' 只作补充),空来源按拒绝处理
* CORS 白名单精确到域名,不使用通配符,且带凭据时正确配置
* 敏感操作有二次确认(原密码 / OTP / 验证码)
* 子域之间互不信任:关键 Cookie 加 Host 前缀(双下划线开头)
* 已确认没有遗留的 GET 幂等性破坏接口
* 有 XSS 防护(CSP + 输出转义),否则 token 也可能被读走
===== 七、常见坑 =====
^ 坑 ^ 说明 ^
| 只防了 HTML 表单 | AJAX / fetch 走的接口同样要校验 token |
| 把 CORS 当 CSRF 防护 | CORS 管「能不能读响应」,不阻止请求被发送 |
| 只依赖 ''Referer'' | 隐私设置下可能为空,HTTPS→HTTP 跳转也不带;''Origin'' 更可靠 |
| token 放进 URL query | 会进浏览器历史、''Referer'' 和服务器日志,等于泄露 |
| 认为有 XSS 也能靠 CSRF token 兜底 | 脚本可直接读走 token,必须先解决 XSS |
| 新项目还在用 ''csurf'' | 该库已废弃,改用 ''csrf-csrf'' 或自实现 |
| 以为子域之间安全 | 子域属于同站,''SameSite'' 不拦,需靠 Host 前缀(双下划线)与来源校验 |
| token 一成不变 | 至少与 session 绑定并在登录后更换,防止会话固定类问题 |
| 登录接口本身没防 | 「登录 CSRF」会把受害者送进攻击者账号,同样要防 |
===== 八、关系总览 =====
```mdk height=560 color=#4f46e5
# CSRF 跨站请求伪造
## 是什么
- 借浏览器自动携带的 Cookie 发请求
- 攻击者不偷凭证,只让浏览器替他动手
- XSS 偷令牌,CSRF 盗用令牌
## 成立条件
- Cookie 自动携带
- 请求能跨站发起
- 受害者处于登录态
- 服务端只凭 Cookie 判身份
## 常见危害
- 转账 / 改邮箱 / 改地址
- 冒名发帖、点赞、授权
- 登录 CSRF、登出 CSRF
## 常见载体
- 自动提交的隐藏表单
- img / script / link 的 GET 请求
- 诱导点击的链接
## GET 与 POST
- 改状态必须用 POST
- POST 是必要不充分
- 同源策略只限读,不限发送
## 防御
### CSRF Token
- 同步令牌:服务端存 session
- 双重提交 Cookie:加签名或 Host 前缀
- 恒定时间比较
### Cookie 加固
- SameSite Lax 起步,敏感用 Strict
- HttpOnly 防偷读,不防盗用
- Secure 全程 HTTPS
### 校验来源
- Origin 为主,Referer 为辅
- 空来源应拒绝
- 自定义头触发预检
- CORS 白名单精确到域名
### 设计习惯
- 状态改变不用 GET
- 敏感操作二次确认
- 凭证走请求头而非 Cookie
## 框架支持
- Django:CsrfViewMiddleware
- Spring Security:默认开启
- Laravel:VerifyCsrfToken
- Next.js:Server Actions 内置 Origin 校验
- Express:csurf 已废弃,用 csrf-csrf
## 相关概念
- XSS 是偷令牌,有 XSS 则 CSRF 防护失效
- SSRF 借的是服务器
- CORS 不是 CSRF 防护
- 点击劫持借的是点击
## 常见坑
- 只防表单,漏了 AJAX
- token 放进 URL
- 只依赖 Referer
- 子域之间算同站
- 新项目还在用 csurf
```
===== 参考 =====
* OWASP CSRF 防护速查表 —— [[https://cheatsheetseries.owasp.org/cheatsheets/Cross-Site_Request_Forgery_Prevention_Cheat_Sheet.html]]
* OWASP 跨站请求伪造说明 —— [[https://owasp.org/www-community/attacks/csrf]]
* MDN:SameSite Cookie 说明 —— [[https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Headers/Set-Cookie/SameSite]]
* MDN:CSRF 概述 —— [[https://developer.mozilla.org/zh-CN/docs/Glossary/CSRF]]
* RFC 6265bis(Cookie 与 SameSite 规范) —— [[https://datatracker.ietf.org/doc/draft-ietf-httpbis-rfc6265bis/]]
相关笔记:[[jwt]]、[[安全头]]、[[burp]]
----
返回:[[代码术语]]