首页/新闻资讯/正文详情

SpringBoot集成Sa-Token实现CSRF防护全解析

发布时间:2026/11/18 10:33:32 来源:云帆数科 栏目:资讯中心
SpringBoot集成Sa-Token实现CSRF防护全解析
1. SpringBoot Sa-Token 实现 CSRF 令牌校验的核心逻辑CSRFCross-Site Request Forgery攻击是Web应用中常见的安全威胁之一。攻击者通过诱导用户访问恶意页面利用用户已登录的会话状态发起非预期的请求。在SpringBoot项目中我们可以通过Sa-Token框架提供的CSRF防护机制来有效防范这类攻击。1.1 CSRF攻击的基本原理CSRF攻击的本质是借用用户的身份凭证。假设用户已经登录了银行网站此时访问了攻击者精心构造的页面该页面中包含一个自动提交的表单向银行网站发起转账请求。由于浏览器会自动携带用户的Cookie服务器会认为这是用户的合法操作。典型的CSRF攻击流程用户登录信任网站A并保留了登录凭证Cookie/Session用户在不登出A的情况下访问危险网站B网站B中包含向网站A发起请求的恶意代码浏览器自动携带网站A的凭证执行请求1.2 Sa-Token的CSRF防护机制Sa-Token采用令牌同步模式防御CSRF服务端生成一个随机token通常存储在Session或Redis中将token嵌入到前端表单或请求头中用户提交请求时携带该token服务端校验token的有效性这种机制有效的原因是攻击者无法获取或预测这个随机token因此无法构造合法的请求。2. SpringBoot集成Sa-Token的完整配置2.1 基础环境准备首先确保你的项目已经正确配置SpringBoot和Sa-Token依赖!-- pom.xml -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcn.dev33/groupId artifactIdsa-token-spring-boot-starter/artifactId version1.30.0/version /dependency2.2 Sa-Token基础配置在application.yml中添加基本配置sa-token: # token名称同时也是cookie名称 token-name: satoken # token有效期单位秒 默认30天 timeout: 2592000 # token临时有效期指定时间内无操作就视为token过期单位秒 默认-1 代表不限制 activity-timeout: -1 # 是否允许同一账号并发登录为true时允许一起登录为false时新登录挤掉旧登录 is-concurrent: true # 在多人登录同一账号时是否共用一个token为true时所有登录共用一个token为false时每次登录新建一个token is-share: false # token风格 token-style: uuid # 是否输出操作日志 is-log: false2.3 启用CSRF防护在配置类中启用CSRF防护Configuration public class SaTokenConfigure implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { // 注册Sa-Token的拦截器校验规则为StpUtil.checkLogin() registry.addInterceptor(new SaInterceptor(handle - { // 指定校验的接口路径 SaRouter.match(/**) .notMatch(/user/login, /user/register) .check(r - { // 校验登录状态 StpUtil.checkLogin(); // 校验CSRF token SaHolder.getRequest().checkCsrfToken(); }); })).addPathPatterns(/**); } }3. 前后端协作实现CSRF防护3.1 服务端生成CSRF Token在用户登录成功后服务端需要生成并返回CSRF TokenRestController RequestMapping(/user) public class UserController { PostMapping(/login) public Result login(RequestBody LoginDto dto) { // 验证用户名密码... User user userService.login(dto); // 登录成功后生成CSRF Token String csrfToken SaTokenCsrfUtil.getToken(); return Result.success() .data(user, user) .data(csrfToken, csrfToken); } }3.2 前端存储和使用CSRF Token前端在收到CSRF Token后需要妥善存储并在后续请求中携带// 登录成功后存储token localStorage.setItem(csrfToken, res.data.csrfToken); // 封装axios请求拦截器 axios.interceptors.request.use(config { // 从localStorage获取token const csrfToken localStorage.getItem(csrfToken); if (csrfToken) { // 将token添加到请求头 config.headers[x-csrf-token] csrfToken; } return config; });3.3 表单提交的CSRF防护对于传统的表单提交需要将CSRF Token作为隐藏字段form action/api/transfer methodpost input typehidden namecsrfToken th:value${csrfToken} !-- 其他表单字段 -- input typetext nameamount button typesubmit提交/button /form4. 高级配置与优化4.1 自定义CSRF Token生成策略Sa-Token默认使用UUID生成CSRF Token我们可以自定义生成逻辑Configuration public class MySaTokenConfig { Autowired public void configCsrf(SaTokenConfig config) { // 自定义CSRF Token生成器 SaTokenCsrfUtil.setCsrfTokenGenerator(() - { // 这里可以使用更复杂的生成逻辑 return CSRF- IdUtil.fastSimpleUUID(); }); } }4.2 分布式环境下的CSRF防护在分布式系统中CSRF Token需要存储在共享存储中如Redissa-token: # 配置token存储为Redis token-store-type: redis # Redis配置 redis: host: 127.0.0.1 port: 6379 # password: database: 04.3 防御双重提交Cookie模式除了传统的Token模式还可以启用双重提交Cookie模式Configuration public class MySaTokenConfig { Autowired public void configCsrf(SaTokenConfig config) { // 启用双重提交Cookie模式 SaTokenCsrfUtil.setDoubleSubmitCookie(true); // 设置Cookie名称 SaTokenCsrfUtil.setCookieName(x-csrf-token); } }这种模式下服务端会同时检查请求头和Cookie中的Token是否一致。5. 常见问题与解决方案5.1 Token过期问题CSRF Token默认有效期为会话期间可以通过以下方式调整// 设置CSRF Token有效期单位秒 SaTokenCsrfUtil.setTokenTimeout(60 * 30); // 30分钟5.2 前后端分离架构的特殊处理在前后端分离项目中可能需要调整CSRF Token的传递方式Configuration public class CorsConfig implements WebMvcConfigurer { Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping(/**) .allowedOrigins(*) .allowedMethods(*) .allowedHeaders(*) // 允许前端获取CSRF Token响应头 .exposedHeaders(x-csrf-token) .allowCredentials(true); } }5.3 性能优化建议对于高并发系统可以考虑以下优化措施使用JWT代替Session存储CSRF Token对静态资源和不需防护的接口禁用CSRF校验实现Token的懒加载机制SaRouter.match(/**) .notMatch(/static/**, /api/public/**) .check(r - { // 只有需要防护的接口才校验CSRF if (SaTokenCsrfUtil.isCsrfCheck()) { SaHolder.getRequest().checkCsrfToken(); } });6. 安全增强措施6.1 同源策略检查除了CSRF Token还可以加强同源策略检查Bean public FilterRegistrationBeanSameOriginFilter sameOriginFilter() { FilterRegistrationBeanSameOriginFilter registration new FilterRegistrationBean(); registration.setFilter(new SameOriginFilter()); registration.addUrlPatterns(/*); registration.setOrder(Ordered.HIGHEST_PRECEDENCE); return registration; }6.2 请求频率限制防止CSRF Token被暴力破解Bean public FilterRegistrationBeanRateLimitFilter rateLimitFilter() { FilterRegistrationBeanRateLimitFilter registration new FilterRegistrationBean(); registration.setFilter(new RateLimitFilter()); registration.addUrlPatterns(/api/*); registration.setOrder(1); return registration; }6.3 安全头部配置添加安全相关的HTTP头部Configuration public class SecurityHeaderConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new HandlerInterceptorAdapter() { Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) { response.setHeader(X-Content-Type-Options, nosniff); response.setHeader(X-Frame-Options, DENY); response.setHeader(X-XSS-Protection, 1; modeblock); } }); } }7. 测试与验证7.1 单元测试CSRF防护编写测试用例验证CSRF防护是否生效SpringBootTest AutoConfigureMockMvc class CsrfTests { Autowired private MockMvc mockMvc; Test void testCsrfProtection() throws Exception { // 模拟登录获取CSRF Token MvcResult loginResult mockMvc.perform(post(/user/login) .contentType(MediaType.APPLICATION_JSON) .content({\username\:\admin\,\password\:\123456\})) .andExpect(status().isOk()) .andReturn(); String csrfToken JsonPath.read(loginResult.getResponse().getContentAsString(), $.data.csrfToken); // 测试带有效Token的请求 mockMvc.perform(post(/api/transfer) .header(x-csrf-token, csrfToken) .contentType(MediaType.APPLICATION_JSON) .content({\amount\:100})) .andExpect(status().isOk()); // 测试不带Token的请求 mockMvc.perform(post(/api/transfer) .contentType(MediaType.APPLICATION_JSON) .content({\amount\:100})) .andExpect(status().isForbidden()); } }7.2 使用Postman测试在Postman中测试CSRF防护首先调用登录接口获取CSRF Token在后续请求的Headers中添加x-csrf-token: 获取到的token验证不带Token的请求是否被拒绝7.3 安全扫描验证使用OWASP ZAP等工具进行安全扫描确认没有CSRF漏洞所有敏感操作都要求CSRF TokenToken具有足够的随机性和强度8. 生产环境部署建议8.1 监控与告警配置监控系统跟踪CSRF验证失败的情况Aspect Component Slf4j public class CsrfMonitorAspect { AfterThrowing(pointcut execution(* cn.dev33.satoken.servlet.SaTokenCsrfFilter.doFilter(..)), throwing ex) public void afterCsrfCheckFailed(Throwable ex) { if (ex instanceof NotCsrfTokenException) { log.warn(CSRF验证失败: {}, ex.getMessage()); // 发送告警通知 alertService.sendAlert(CSRF验证失败告警, ex.getMessage()); } } }8.2 定期更换密钥如果使用加密的CSRF Token建议定期更换加密密钥Scheduled(cron 0 0 0 * * ?) // 每天凌晨执行 public void rotateCsrfKey() { String newKey SecureRandomUtil.randomString(32); SaTokenCsrfUtil.setEncryptKey(newKey); log.info(CSRF加密密钥已更新); }8.3 应急响应计划制定CSRF防护失效的应急方案立即禁用相关功能接口强制所有用户重新登录生成新的CSRF Token审查日志确认是否已被利用修复问题后逐步恢复服务在实际项目中CSRF防护只是安全体系的一部分还需要结合XSS防护、输入验证、权限控制等多层防御措施才能构建真正安全的Web应用。Sa-Token提供的CSRF防护功能既简单易用又足够灵活能够满足大多数SpringBoot项目的安全需求。

相关推荐

Python字典详解:从基础操作到高级应用
Python字典详解:从基础操作到高级应用

1. Python字典基础概念解析字典(Dictionary)是Python中最强大的数据类型之一,它提供了一种灵活的数据组织方式。与列表和元组不同,字典使用键值对(key-value pairs)来存储数据,这使得数据的存取… · 2026/10/26 6:09:48

plugin-git:Fish Shell的终极Git别名工具,让命令行效率提升10倍
plugin-git:Fish Shell的终极Git别名工具,让命令行效率提升10倍

plugin-git:Fish Shell的终极Git别名工具,让命令行效率提升10倍 【免费下载链接】plugin-git Git aliases plugin for the Fish shell (similar to oh-my-zsh git) 项目地址: https://gitcode.com/gh_mirrors/pl/plugin-git plugin-git是一款专为… · 2026/10/26 5:07:02

Java实现OCR功能:Tesseract与Tess4J实战指南
Java实现OCR功能:Tesseract与Tess4J实战指南

1. 为什么选择Java实现OCR功能?在当今数字化时代,光学字符识别(OCR)技术已经成为从图像中提取文本信息的重要工具。Java作为一门成熟稳定的编程语言,在企业级应用开发中占据重要地位。使用Java实现OCR功能具有以下优势… · 2026/10/26 5:34:19

铜川专业的初级电工证上岗必须要这个证吗 良心建议帮你搞清
铜川专业的初级电工证上岗必须要这个证吗 良心建议帮你搞清

铜川专业的初级电工证上岗必须要这个证吗 良心建议帮你搞清 实操考试心里没底怕挂科,别担心,这不是你一个人的烦恼。我认识不少从洛阳涧西区转岗过来的电工,他们最初也和你一样,担心自己能不能一次性通过考试。但只要你准备到位、流程清楚,其实并不难。… · 2026/11/18 10:33:08

工地太忙根本没时间复习考试?电工证办理手续怎么报名全攻略
工地太忙根本没时间复习考试?电工证办理手续怎么报名全攻略

工地太忙根本没时间复习考试?电工证办理手续怎么报名全攻略 工地太忙根本没时间复习考试,这是很多一线电工的真实写照。每天扛着工具穿梭在钢筋水泥之间,还要兼顾考试复习,听起来就让人头疼。但别以为电工证不重要,它不仅是你合法上岗的“通行证”,更是… · 2026/11/18 10:33:08

广东电工证哪里发的值不值得考?实操考试心里没底怕挂科?看这篇就够了
广东电工证哪里发的值不值得考?实操考试心里没底怕挂科?看这篇就够了

广东电工证哪里发的值不值得考?实操考试心里没底怕挂科?看这篇就够了 实操考试心里没底怕挂科,这是很多准备考电工证的朋友最真实的感受。特别是对许昌水利工程从业者来说,电工证不仅是从事相关工作的“入场券”,更是职业发展的重要跳板。但面对【广东电… · 2026/11/18 10:33:08

铜川专业的初级电工证多少钱?怕考不过白交培训费?3步教你避开坑
铜川专业的初级电工证多少钱?怕考不过白交培训费?3步教你避开坑

铜川专业的初级电工证多少钱?怕考不过白交培训费?3步教你避开坑 怕考不过白交培训费?铜川专业的初级电工证多少钱?如果你正在考虑报考,但又担心浪费钱,这篇文章就是为你准备的。从报名到拿证,从考试到复审,我用10年经验告诉你怎么做最稳妥,别被培… · 2026/11/18 10:33:08

怎么去老家考电工证官方回应来了,别再怕考不过白交培训费
怎么去老家考电工证官方回应来了,别再怕考不过白交培训费

怎么去老家考电工证官方回应来了,别再怕考不过白交培训费 怕考不过白交培训费?别慌! 官方回应 已经明确,只要你选对地方、报对机构,电工证考试并不难。特别是 漯河应届工程类毕业生… · 2026/11/18 10:33:08

依兰电工证在哪报名官方回应:急需特种作业证才能上岗找工作
依兰电工证在哪报名官方回应:急需特种作业证才能上岗找工作

依兰电工证在哪报名官方回应:急需特种作业证才能上岗找工作 你现在找工作卡在特种作业证上, 依兰电工证在哪报名 ?别急,先听我说。官方回应明确表示, 依兰电工证必须通过当地应急管理部门指定渠道报名… · 2026/11/18 10:32:08

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/18 8:19:55

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/18 8:19:53

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/17 9:06:35

电工证做题最新内部消息:怕考不过白交培训费?三招教你稳过
电工证做题最新内部消息:怕考不过白交培训费?三招教你稳过

电工证做题最新内部消息:怕考不过白交培训费?三招教你稳过 你是不是也这样?报名了电工证培训,交了钱,结果一到考试就懵, 怕考不过白交培训费 ?别慌,这是很多初次报考人员的真实写照。而最近, 河南省应急管理厅… · 2026/11/18 0:00:37

许昌电工证在哪复审 别踩坑怕考不过白交培训费
许昌电工证在哪复审 别踩坑怕考不过白交培训费

许昌电工证在哪复审 别踩坑怕考不过白交培训费 怕考不过白交培训费,这几乎是每个想考电工证的学员心中的痛。尤其是在许昌,电工证的报考和复审流程复杂,稍有不慎就可能被坑, 千万别踩坑… · 2026/11/18 0:00:37

老式电工证还能用吗?怎么报名别踩坑,河南企业主都在问的实操真相
老式电工证还能用吗?怎么报名别踩坑,河南企业主都在问的实操真相

老式电工证还能用吗?怎么报名别踩坑,河南企业主都在问的实操真相 实操考试心里没底怕挂科?老式电工证还能用吗?怎么报名又怕被坑?这些问题几乎每个准备考电工证的施工企业负责人心里都在打鼓。尤其是河南本地的中小施工企业,很多都在用老式电工证,但随… · 2026/11/18 0:00:37

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/17 21:47:42

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码