深入解析Spring Boot与Spring Security的集成实践

Uranus^

于 2025-05-28 14:01:00 发布

阅读量420

点赞数 13

本文链接：https://blog.csdn.net/intwei/article/details/148282793

版权

Java 专栏收录该内容

157 篇文章

订阅专栏

深入解析Spring Boot与Spring Security的集成实践

引言

在现代Web应用开发中，安全性是一个不可忽视的重要环节。Spring Security作为Spring生态中的安全框架，提供了强大的认证和授权功能。本文将详细介绍如何在Spring Boot项目中集成Spring Security，并实现常见的功能，如基于角色的访问控制、自定义登录页面、JWT认证等。

1. Spring Security简介

Spring Security是一个功能强大且高度可定制的安全框架，主要用于Java企业级应用的安全控制。它基于Spring框架，提供了全面的安全解决方案，包括认证（Authentication）和授权（Authorization）。

核心功能

认证（Authentication）：验证用户的身份，确保用户是其所声称的身份。
授权（Authorization）：确定用户是否有权限访问某个资源或执行某个操作。
防护攻击：如CSRF（跨站请求伪造）、XSS（跨站脚本攻击）等。

2. Spring Boot集成Spring Security

2.1 添加依赖

首先，在pom.xml中添加Spring Security的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-security</artifactId>
</dependency>

2.2 基础配置

Spring Security默认会为所有请求启用安全防护。我们可以通过配置类来自定义安全规则。以下是一个简单的配置示例：

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http
            .authorizeRequests()
                .antMatchers("/public/**").permitAll()
                .anyRequest().authenticated()
            .and()
            .formLogin()
                .loginPage("/login")
                .permitAll()
            .and()
            .logout()
                .permitAll();
    }

    @Override
    protected void configure(AuthenticationManagerBuilder auth) throws Exception {
        auth.inMemoryAuthentication()
            .withUser("user").password("{noop}password").roles("USER")
            .and()
            .withUser("admin").password("{noop}admin").roles("ADMIN");
    }
}

2.3 自定义登录页面

默认情况下，Spring Security会提供一个简单的登录页面。如果需要自定义登录页面，可以创建一个login.html文件，并在配置类中指定其路径。

3. 高级功能

3.1 JWT认证

JSON Web Token（JWT）是一种轻量级的认证机制，适用于分布式系统。以下是如何在Spring Security中集成JWT的示例：

添加JWT依赖：

<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt</artifactId>
    <version>0.9.1</version>
</dependency>

创建JWT工具类：

public class JwtUtil {
    private static final String SECRET_KEY = "your-secret-key";

    public static String generateToken(String username) {
        return Jwts.builder()
                .setSubject(username)
                .setIssuedAt(new Date())
                .setExpiration(new Date(System.currentTimeMillis() + 1000 * 60 * 60 * 10))
                .signWith(SignatureAlgorithm.HS256, SECRET_KEY)
                .compact();
    }

    public static String extractUsername(String token) {
        return Jwts.parser().setSigningKey(SECRET_KEY).parseClaimsJws(token).getBody().getSubject();
    }
}

配置JWT过滤器：

public class JwtRequestFilter extends OncePerRequestFilter {
    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain)
            throws ServletException, IOException {
        String token = request.getHeader("Authorization");
        if (token != null && token.startsWith("Bearer ")) {
            token = token.substring(7);
            String username = JwtUtil.extractUsername(token);
            if (username != null && SecurityContextHolder.getContext().getAuthentication() == null) {
                UsernamePasswordAuthenticationToken authentication = new UsernamePasswordAuthenticationToken(
                        username, null, new ArrayList<>());
                SecurityContextHolder.getContext().setAuthentication(authentication);
            }
        }
        chain.doFilter(request, response);
    }
}