一文讲清楚:什么是 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」,有就执行。那么攻击者只需在自己站点放一个表单,指向这个接口、填好恶意参数,再用一行脚本自动提交:
<!-- 放在 https://evil.com/win.html --> <form id="f" action="https://bank.example.com/profile/email" method="POST"> <input type="hidden" name="email" value="hacker@evil.com"> </form> <!-- 页面加载后自动 submit 这个表单(此处省略一行脚本) -->
只要受害者在已登录的状态下打开这个页面,浏览器就会带上 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 里,页面表单里带上,提交时比对。
<form method="post" action="/profile/email"> <input type="hidden" name="_csrf" value="9f2c...random..."> <input type="email" name="email"> <button type="submit">保存</button> </form>
// 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 %} <!-- Django:模板里输出隐藏字段 -->
protect_from_forgery with: :exception <!-- Rails:控制器里声明 -->
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」会把受害者送进攻击者账号,同样要防 |
八、关系总览
# 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 跨站请求伪造说明 —— 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/
返回:代码术语