目录

一文讲清楚:什么是 CSRF

CSRF(Cross-Site Request Forgery,跨站请求伪造) 是一种「借刀杀人」式的攻击:攻击者既不需要偷走你的 Cookie,也不需要知道你的密码,只需在第三方页面里埋一段代码,诱导你的浏览器带着你已经登录的 Cookie,向目标站点发出一个你并不知情的请求。请求是受害者浏览器亲自发的、Cookie 也完全合法,服务端从请求本身看不出任何异常。

一句话对比:

一、攻击为什么能成立

根子在浏览器的两个设计上:

于是就有了一条公式:身份判断依赖 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 成立的前提。

常见的后果:

三、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 固定成已知值。缓解办法:

Host 前缀的写法示例(名字最前面是两个下划线):

Set-Cookie: __Host-session=abc123; Secure; HttpOnly; Path=/
Set-Cookie: session=abc123; Secure; HttpOnly; SameSite=Lax
取值 行为 副作用
Strict 完全不随跨站请求携带 从外部站点点链接进来会掉登录态
Lax 跨站 GET 导航 携带,跨站 POST 不携带 主流折中,现代浏览器默认值
None 允许跨站携带,必须同时带 Secure 仅真跨站场景(如嵌入第三方页面)

SameSite=Lax 已经能挡掉绝大多数「隐藏表单 POST」攻击,是性价比最高的一层。但不要只依赖它:

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();
});

要点:

4. 自定义请求头 + 严格 CORS(前后端分离最实用)

跨站的「简单请求」不能带自定义头:一旦请求带 X-Requested-With、X-CSRF-Token 之类的头,浏览器会先发 OPTIONS 预检,而预检通不过(服务端白名单不允许该来源)请求就发不出去。于是:

顺带说一句:CORS 本身不是 CSRF 防护。它只决定「能不能读响应」,宽松的 CORS 只会放大风险,不会挡住请求。

5. 设计层面的习惯

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 的推荐组合

六、上线检查清单

七、常见坑

坑 说明
只防了 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

参考

相关笔记:jwt、安全头、burp


返回:代码术语