====== 一文讲清楚:什么是 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]] ---- 返回:[[代码术语]]