CSRF(Cross-Site Request Forgery,跨站请求伪造) 是一种「借刀杀人」式的攻击:攻击者既不需要偷走你的 Cookie,也不需要知道你的密码,只需在第三方页面里埋一段代码,诱导你的浏览器带着你已经登录的 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 常靠图片标签发起,例如在页面里放一张「图片」,其地址其实是转账接口、参数就写在 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」。
服务端生成一个攻击者猜不到的随机值,随页面下发给本站前端;所有改状态的请求都必须带回它,服务端比对。
同步令牌模式(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 固定成已知值。缓解办法:
Secure + Path=/
且不允许带 Domain,从而阻止子域覆盖;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」攻击,是性价比最高的一层。但不要只依赖它:
a.example.com → b.example.com 属于同站),子域被攻陷就绕过了;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 就放行」是常见错误,安全策略下应当拒绝;
跨站的「简单请求」不能带自定义头:一旦请求带 X-Requested-With、X-CSRF-Token 之类的头,浏览器会先发 OPTIONS 预检,而预检通不过(服务端白名单不允许该来源)请求就发不出去。于是:
x-csrf-token);Access-Control-Allow-Origin 不使用通配符;credentials: “include”,后端 Access-Control-Allow-Credentials: true。顺带说一句:CORS 本身不是 CSRF 防护。它只决定「能不能读响应」,宽松的 CORS 只会放大风险,不会挡住请求。
Authorization: Bearer 传递,业务请求根本不带 Cookie,就天然免疫 CSRF(代价与取舍见 jwt 的方案 B);Secure、HttpOnly、SameSite 等属性,组合使用。| 框架 | 做法 | 备注 |
|---|---|---|
| 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:控制器里声明 -->
Secure; HttpOnly; SameSite=Lax(更敏感的用 Strict)x-csrf-token 头Origin + CORS 白名单精确到域名Secure + HttpOnly + SameSite=Lax(或 Strict)Origin(Referer 只作补充),空来源按拒绝处理| 坑 | 说明 |
|---|---|
| 只防了 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
返回:代码术语