代码术语:一文讲清楚什么是csrf

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
代码术语:一文讲清楚什么是csrf [2026/10/12 16:33] – 修复渲染:清单里的 __Host- 改为文字描述 张叶安代码术语:一文讲清楚什么是csrf [2026/10/12 16:36] (当前版本) – 修复渲染:去掉清单中的孤立星号 张叶安
行 202: 行 202:
  
   * 前端所有写操作统一带自定义头(例如 ''x-csrf-token'');   * 前端所有写操作统一带自定义头(例如 ''x-csrf-token'');
-  * 后端 CORS 白名单**精确到域名**,''Access-Control-Allow-Origin'' 不使用 ''*'';+  * 后端 CORS 白名单**精确到域名**,''Access-Control-Allow-Origin'' 不使用通配符;
   * 前后端分离时同时打开凭据:前端请求带 ''credentials: "include"'',后端 ''Access-Control-Allow-Credentials: true''。   * 前后端分离时同时打开凭据:前端请求带 ''credentials: "include"'',后端 ''Access-Control-Allow-Credentials: true''。
  
行 218: 行 218:
  
 ^ 框架 ^ 做法 ^ 备注 ^ ^ 框架 ^ 做法 ^ 备注 ^
-| Django | ''CsrfViewMiddleware'' + 模板 ''{% csrf_token %}'' | 内置;默认还会校验 Referer |+| Django | ''CsrfViewMiddleware'' 中间件 + 模板标签输出 csrf token | 内置;默认还会校验 Referer |
 | Spring Security | 默认开启 CSRF,''CookieCsrfTokenRepository.withHttpOnlyFalse()'' | SPA 场景常改用 Cookie 仓库 + 前端带头 | | Spring Security | 默认开启 CSRF,''CookieCsrfTokenRepository.withHttpOnlyFalse()'' | SPA 场景常改用 Cookie 仓库 + 前端带头 |
 | Laravel | ''VerifyCsrfToken'' 中间件 + ''@csrf'' | 下发 ''XSRF-TOKEN'' Cookie,前端放 ''X-XSRF-TOKEN'' 头 | | Laravel | ''VerifyCsrfToken'' 中间件 + ''@csrf'' | 下发 ''XSRF-TOKEN'' Cookie,前端放 ''X-XSRF-TOKEN'' 头 |
-| Rails | ''protect_from_forgery with: :exception'' | 内置 | +| Rails | 控制器里声明防伪保护(默认开启) | 内置 | 
-| Next.js | Server Actions **内置** Origin / Host 比对 | 但 Route Handlers(''app/api/*'')**没有**内置防护,要自己加 |+| Next.js | Server Actions **内置** Origin / Host 比对 | 但 Route Handlers(app 目录下的接口文件)**没有**内置防护,要自己加 |
 | Express | ''csurf'' **已于 2022 年废弃** | 新项目用 ''csrf-csrf''(双重提交)或自行实现 | | Express | ''csurf'' **已于 2022 年废弃** | 新项目用 ''csrf-csrf''(双重提交)或自行实现 |
 +
 +Django 模板标签与 Rails 控制器声明的原文:
 +
 +<code>
 +{% csrf_token %}                        <!-- Django:模板里输出隐藏字段 -->
 +protect_from_forgery with: :exception   <!-- Rails:控制器里声明 -->
 +</code>
  
 ==== 7. 前后端分离 / SPA 的推荐组合 ==== ==== 7. 前后端分离 / SPA 的推荐组合 ====
行 240: 行 247:
   * token 随机、足够长(≥ 32 字节)、有生命周期,比对用恒定时间函数   * token 随机、足够长(≥ 32 字节)、有生命周期,比对用恒定时间函数
   * 服务端校验 ''Origin''(''Referer'' 只作补充),空来源按拒绝处理   * 服务端校验 ''Origin''(''Referer'' 只作补充),空来源按拒绝处理
-  * CORS 白名单精确到域名,不使用 ''*'',且带凭据时正确配置+  * CORS 白名单精确到域名,不使用通配符,且带凭据时正确配置
   * 敏感操作有二次确认(原密码 / OTP / 验证码)   * 敏感操作有二次确认(原密码 / OTP / 验证码)
   * 子域之间互不信任:关键 Cookie 加 Host 前缀(双下划线开头)   * 子域之间互不信任:关键 Cookie 加 Host 前缀(双下划线开头)
行 255: 行 262:
 | 认为有 XSS 也能靠 CSRF token 兜底 | 脚本可直接读走 token,必须先解决 XSS | | 认为有 XSS 也能靠 CSRF token 兜底 | 脚本可直接读走 token,必须先解决 XSS |
 | 新项目还在用 ''csurf'' | 该库已废弃,改用 ''csrf-csrf'' 或自实现 | | 新项目还在用 ''csurf'' | 该库已废弃,改用 ''csrf-csrf'' 或自实现 |
-| 以为子域之间安全 | 子域属于同站,''SameSite'' 不拦,需靠 %%__Host-%% 前缀与来源校验 |+| 以为子域之间安全 | 子域属于同站,''SameSite'' 不拦,需靠 Host 前缀(双下划线)与来源校验 |
 | token 一成不变 | 至少与 session 绑定并在登录后更换,防止会话固定类问题 | | token 一成不变 | 至少与 session 绑定并在登录后更换,防止会话固定类问题 |
 | 登录接口本身没防 | 「登录 CSRF」会把受害者送进攻击者账号,同样要防 | | 登录接口本身没防 | 「登录 CSRF」会把受害者送进攻击者账号,同样要防 |

该主题尚不存在

您访问的页面并不存在。如果允许,您可以使用创建该页面按钮来创建它。

  • 代码术语/一文讲清楚什么是csrf.1791793990.txt.gz
  • 最后更改: 2026/10/12 16:33
  • 由 张叶安