Spring Boot项目实现CSRF安全后如何验证配置是否生效
注意:你当前的CSRF开关逻辑完全写反了,代码中if (csrfEnabled) { http.csrf().disable(); }代表当你配置security.enable-csrf=true时会主动关闭CSRF防护,和你的预期相反,先修改为如下逻辑再做验证:
if (!csrfEnabled) { http.csrf().disable(); }
Spring Security默认开启CSRF防护,所以只有当配置项为false时才需要主动关闭。
验证CSRF配置生效的方法
- 页面源码验证:访问登录页,右键查看页面源代码,确认表单中
_csrf隐藏域存在且有对应的token值,说明服务端已正常生成CSRF token。 - 异常场景验证:
- 手动修改页面中
_csrf隐藏域的token值为任意错误内容,提交表单,如果返回403 Forbidden,说明CSRF校验生效。 - 用curl/postman直接向POST接口发起请求,不携带任何CSRF参数或请求头,返回403则说明防护生效。
- 手动修改页面中
- 日志验证:在配置文件中添加Spring Security debug日志配置:
logging: level: org.springframework.security: DEBUG
发起请求后在日志中搜索CsrfFilter相关记录,校验成功会打印放行日志,校验失败会打印Invalid CSRF token found的明确提示。
- Cookie验证:默认配置下,服务端会向浏览器写入名为
XSRF-TOKEN的Cookie,在浏览器开发者工具的存储面板中可以查看到该Cookie,存在则说明CSRF已开启。
优化建议
- 适配业务场景配置CSRF规则:如果存在不需要校验CSRF的公开接口、第三方回调接口,可以配置忽略路径:
http.csrf().ignoringAntMatchers("/public/**", "/notify/callback");
如果你的项目是纯前后端分离的REST服务,建议配置Cookie模式的token存储,方便前端读取:
http.csrf().csrfTokenRepository(CookieCsrfTokenRepository.withHttpOnlyFalse());
如果服务仅供给非浏览器客户端(移动端、OpenAPI调用方)使用,可以直接全局关闭CSRF防护,CSRF攻击仅存在于浏览器场景。
- 身份认证逻辑优化:当前用的内存身份认证、明文密码仅适合测试,生产环境需要对接持久化身份源,密码采用BCrypt等不可逆加密算法存储。
- 权限规则细化:不要使用
/**全路径拦截,将静态资源、登录、公开路径单独配置放行,缩小拦截范围。 - 自定义校验失败响应:可以自定义CSRF校验失败的处理逻辑,返回符合项目规范的JSON格式错误提示,替代默认的403错误页。
内容的提问来源于stack exchange,提问作者guidop21
相关产品推荐
相关产品推荐

