纲要
- CSRF 攻击原理
- 攻击前提:用户已登录目标站点,会话未失效
- 攻击手段:诱导用户点击恶意链接,向真实站点提交伪造请求
- 危害:利用用户有效
Session执行非本人意愿的操作
- Spring Security 中的 CSRF 防护
CsrfToken机制:服务端生成 token 存入Session或Cookie,前端请求携带 tokenCsrfTokenRepository:控制 token 存储策略(HttpSessionCsrfTokenRepository/CookieCsrfTokenRepository)- 请求匹配策略:
ignoringRequestMatchers忽略指定路径,requireCsrfProtectionMatcher要求指定路径携带 token - 无状态应用天然免疫 CSRF,无需重点配置
- RememberMe 记住我
- 原理:基于 Cookie,存储用户名、过期时间和哈希值
- Token 生成规则:
base64(username + ":" + expiryTime + ":" + Md5(username + ":" + expiryTime + ":" + password + ":" + key)) - 验证流程:判断过期时间,未过期则根据用户名查询用户,重新计算哈希进行比对
- 安全考量:密码变更后哈希失效;企业应用慎用
- 配置项:
alwaysRemember、tokenValiditySeconds、cookieName、userDetailsService等
- Logout 注销
logoutUrl:触发注销的 URLlogoutSuccessUrl:注销成功后跳转地址- 其他定制:删除指定
Cookie、清理Authentication、失效Session
- 完整可运行配置示例
- 使用
SecurityFilterChain配置 CSRF、RememberMe、Logout - 基于内存的用户存储
InMemoryUserDetailsManager - 配套的登录页与首页示例
- 关键代码解析
- 使用
CSRF 攻击与 Spring Security 的防护
跨站请求伪造(CSRF)是一种利用用户已登录身份的攻击方式。攻击者诱导用户访问恶意站点,该站点会伪造请求发送到用户已认证的真实站点。由于浏览器会自动携带目标站点的 Cookie(含 Session ID),服务器会认为该请求合法,从而执行转账、修改信息等操作。
Spring Security 默认开启 CSRF 防护,核心是 同步令牌模式(Synchronizer Token Pattern)。服务端生成一个随机 CsrfToken,并将其存入 Session 或 Cookie。前端在发起非安全请求(如 POST、PUT、DELETE)时必须携带该 token,服务端校验通过后才放行。由于恶意站点无法读取用户浏览器中属于合法站点的 token(受同源策略限制),因此攻击无法生效。
攻击与防护流程
下面用 Mermaid 图表展示 CSRF 攻击原理与引入 token 后的防护效果:
CSRF 配置项速览
Spring Security 允许灵活配置 CSRF 策略:
| 配置方法 | 说明 |
|---|---|
csrfTokenRepository(CsrfTokenRepository) | 设置 token 存储方式,可选基于 HttpSession 或 Cookie |
ignoringRequestMatchers(RequestMatcher...) | 忽略某些路径的 CSRF 保护,例如 REST API |
requireCsrfProtectionMatcher(RequestMatcher) | 反向策略,指定哪些请求必须经过 CSRF 校验 |
csrf().disable() | 完全禁用 CSRF(不推荐,除非确认为无状态 API) |
对于前后端分离的无状态应用,因为不依赖 Session,每次请求携带自包含 Token(如 JWT),CSRF 攻击无法实施,此时可直接关闭 CSRF 保护。
RememberMe 记住我功能
RememberMe 允许用户在关闭浏览器后,下次访问时自动登录,无需重新输入账号密码。它的本质是 Token 持久化。Spring Security 会将一个加密后的 token 写入用户浏览器的 Cookie 中。
Token 的生成规则如下:
base64(username + ":" + expiryTime + ":" + Md5(username + ":" + expiryTime + ":" + password + ":" + key))
其中 key 是应用自行保管的私钥。验证时,服务端根据 username 从数据库中取出用户信息(包括密码),重新计算 MD5 并与 Cookie 中的哈希比对,同时校验过期时间。一旦用户修改密码,旧的 RememberMe Token 会立即失效,这是重要的安全保障。
RememberMe 验证时序
核心配置参数
alwaysRemember(true):开启“始终记住”,无需用户在表单勾选“记住我”tokenValiditySeconds(int):Token 有效期(秒),例如30*24*3600表示一个月key(String):用于计算哈希的私钥,必须设置rememberMeCookieName(String):自定义 Cookie 名称userDetailsService(UserDetailsService):指定查询用户信息的服务
注意:当使用 application.yml 中定义的用户时,默认不会暴露 UserDetailsService,因此无法直接配合 RememberMe。此时需要在配置类中通过 InMemoryUserDetailsManager 或 JdbcUserDetailsManager 显式创建 UserDetailsService Bean。
Logout 注销配置
Spring Security 提供了开箱即用的注销支持,默认监听 /logout 请求。我们可以对注销行为进行深度定制:
| 配置项 | 说明 |
|---|---|
logoutUrl(String) | 自定义触发注销的 URL,默认 /logout |
logoutSuccessUrl(String) | 注销成功后重定向的地址 |
deleteCookies(String...) | 清除指定的 Cookie(如 JSESSIONID、remember-me) |
invalidateHttpSession(true) | 是否使 HttpSession 失效,默认 true |
clearAuthentication(true) | 是否清除 SecurityContext 中的认证信息,默认 true |
addLogoutHandler(LogoutHandler) | 添加额外的注销处理器 |
logoutSuccessHandler(LogoutSuccessHandler) | 完全自定义注销成功后的逻辑 |
示例配置可结合 RememberMe,在注销时同时清除记住我 Cookie,避免残留。
完整整合示例
下面提供一个基于 Spring Boot + Spring Security 的完整配置类,整合了 CSRF 防护、RememberMe 和 Logout 功能,可直接运行。
项目结构
src/main/java/com/example/demo/
├── config
│ └── SecurityConfig.java
├── controller
│ └── HomeController.java
└── DemoApplication.java
src/main/resources/
├── application.yml
└── templates/
└── login.html
1. 启动类与控制器
package com.example.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication {
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
}
package com.example.demo.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class HomeController {
@GetMapping("/")
public String index() {
return "index";
}
@GetMapping("/login")
public String login() {
return "login";
}
}
2. 登录页 login.html
放置在 src/main/resources/templates/ 下。关键点:表单 action 指向 /login,并包含 CSRF 隐藏域以及 RememberMe 复选框。
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8"/>
<title>登录</title>
</head>
<body>
<h2>请登录</h2>
<form th:action="@{/login}" method="post">
<div>
<label>用户名: <input type="text" name="username"/></label>
</div>
<div>
<label>密码: <input type="password" name="password"/></label>
</div>
<div>
<label><input type="checkbox" name="remember-me"/> 记住我</label>
</div>
<div>
<button type="submit">登录</button>
</div>
<!-- 当启用 CSRF 时,Thymeleaf 会自动生成隐藏域 -->
</form>
</body>
</html>
3. 首页 index.html
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8"/>
<title>首页</title>
</head>
<body>
<h1>欢迎回来,<span th:text="${#authentication.name}"></span>!</h1>
<form th:action="@{/logout}" method="post">
<button type="submit">退出登录</button>
</form>
</body>
</html>
4. 安全配置核心 SecurityConfig.java
package com.example.demo.config;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.core.userdetails.User;
import org.springframework.security.core.userdetails.UserDetailsService;
import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
import org.springframework.security.crypto.password.PasswordEncoder;
import org.springframework.security.provisioning.InMemoryUserDetailsManager;
import org.springframework.security.web.SecurityFilterChain;
import org.springframework.security.web.csrf.CookieCsrfTokenRepository;
import org.springframework.security.web.csrf.CsrfTokenRepository;
@Configuration
@EnableWebSecurity
public class SecurityConfig {
// 配置密码编码器
@Bean
public PasswordEncoder passwordEncoder() {
return new BCryptPasswordEncoder();
}
// 显式暴露 UserDetailsService,支持 RememberMe
@Bean
public UserDetailsService userDetailsService(PasswordEncoder encoder) {
InMemoryUserDetailsManager manager = new InMemoryUserDetailsManager();
manager.createUser(User.withUsername("user")
.password(encoder.encode("12345678"))
.roles("USER")
.build());
return manager;
}
// RememberMe 的私钥,实际项目应放在配置文件中
private static final String REMEMBER_ME_KEY = "uniqueAndSecret";
@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
http
// 配置 CSRF 防护
.csrf(csrf -> csrf
// 使用 Cookie 存储 CsrfToken,便于纯前端读取
.csrfTokenRepository(csrfTokenRepository())
// 忽略 /api/** 路径的 CSRF 保护(假设为 REST 接口)
.ignoringRequestMatchers("/api/**")
)
// 表单登录配置
.formLogin(form -> form
.loginPage("/login")
.defaultSuccessUrl("/", true)
.permitAll()
)
// RememberMe 配置
.rememberMe(remember -> remember
.userDetailsService(userDetailsService(passwordEncoder()))
.key(REMEMBER_ME_KEY)
.tokenValiditySeconds(30 * 24 * 3600) // 一个月
.rememberMeCookieName("MY_REMEMBER_ME")
.alwaysRemember(false) // 用户勾选才生效
)
// 注销配置
.logout(logout -> logout
.logoutUrl("/logout")
.logoutSuccessUrl("/login?logout")
.deleteCookies("JSESSIONID", "MY_REMEMBER_ME")
.invalidateHttpSession(true)
.clearAuthentication(true)
.permitAll()
)
// 授权规则
.authorizeHttpRequests(auth -> auth
.requestMatchers("/login", "/css/**", "/js/**").permitAll()
.anyRequest().authenticated()
);
return http.build();
}
// 自定义 CsrfTokenRepository,此处选择存入 Cookie
private CsrfTokenRepository csrfTokenRepository() {
CookieCsrfTokenRepository repository = CookieCsrfTokenRepository.withHttpOnlyFalse();
repository.setCookieName("XSRF-TOKEN"); // Cookie 名称
repository.setHeaderName("X-XSRF-TOKEN"); // 前端读取后放在此请求头
return repository;
}
}
5. 配置文件 application.yml
spring:
thymeleaf:
cache: false
security:
user:
name: user
password: 12345678
# 注意:因为我们在 Java 配置中显式定义了 InMemoryUserDetailsManager,
# 所以此处基于 application.yml 的用户定义将不会生效,仅用于参考。
server:
port: 8080
运行说明
- 启动项目,访问
http://localhost:8080/会自动跳转到http://localhost:8080/login。 - 输入用户名
user、密码12345678,勾选“记住我”后登录。 - 在开发者工具中可以看到名为
MY_REMEMBER_ME的 Cookie。 - 关闭浏览器后重新访问
/,无需再次登录。 - 点击“退出登录”,将会清除
JSESSIONID和MY_REMEMBER_ME并回到登录页。
知识扩展:无状态应用与 CSRF
对于完全无状态的 RESTful 架构,使用 JWT 等令牌机制,不再依赖 HttpSession。此类应用无需 CSRF 保护,可以直接通过 http.csrf().disable() 关闭。但在混合场景下(部分页面仍使用 Session),请谨慎评估。
官方文档
- Spring Security Reference – CSRF
- Spring Security Reference – RememberMe
- Spring Security Reference – Logout
总结
本文从 CSRF 攻击的原理出发,详解了 Spring Security 中 csrf、rememberMe 和 logout 三大核心配置模块,并给出了可直接运行的整合示例。
通过显式创建 UserDetailsService,解决了基于配置文件用户时 RememberMe 无法生效的问题。合理组合这些配置,可以快速构建安全且体验友好的登录体系。
616



被折叠的 条评论
为什么被折叠?



