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

原创于 2025-06-28 21:00:52 发布 · 622 阅读

18 ·

CC 4.0 BY-SA版权

文章标签：

#Spring Boot #Spring Security #JWT #Java #Web安全

Java 专栏收录该内容

769 篇文章

订阅专栏

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

引言

在现代Web应用开发中，安全性是不可忽视的重要环节。Spring Security作为Spring生态中的安全框架，提供了强大的认证与授权功能。本文将详细介绍如何在Spring Boot项目中集成Spring Security，并实现常见的用户认证与授权功能。

1. Spring Security简介

Spring Security是一个功能强大且高度可定制的安全框架，主要用于Java应用程序的安全性控制。它提供了认证（Authentication）和授权（Authorization）功能，支持多种认证方式，如表单登录、OAuth2、JWT等。

2. 创建Spring Boot项目

首先，我们需要创建一个Spring Boot项目。可以通过Spring Initializr（https://start.spring.io/）快速生成项目骨架。选择以下依赖：

Spring Web
Spring Security

生成项目后，导入到IDE中。

3. 配置Spring Security

3.1 基本配置

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();
    }
}

3.2 用户认证

Spring Security支持多种用户认证方式，如内存认证、数据库认证等。以下是一个内存认证的示例：

@Autowired
public void configureGlobal(AuthenticationManagerBuilder auth) throws Exception {
    auth
        .inMemoryAuthentication()
            .withUser("user").password("{noop}password").roles("USER")
            .and()
            .withUser("admin").password("{noop}admin").roles("ADMIN");
}

4. 实现JWT认证

JWT（JSON Web Token）是一种流行的无状态认证机制。以下是集成JWT的步骤：

4.1 添加依赖

在pom.xml中添加以下依赖：

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

4.2 创建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();
    }
}

4.3 配置JWT过滤器

创建一个过滤器来验证JWT：

public class JwtRequestFilter extends OncePerRequestFilter {
    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain chain)
            throws ServletException, IOException {
        final String authorizationHeader = request.getHeader("Authorization");

        String username = null;
        String jwt = null;

        if (authorizationHeader != null && authorizationHeader.startsWith("Bearer ")) {
            jwt = authorizationHeader.substring(7);
            username = JwtUtil.extractUsername(jwt);
        }

        if (username != null && SecurityContextHolder.getContext().getAuthentication() == null) {
            UsernamePasswordAuthenticationToken authenticationToken =
                    new UsernamePasswordAuthenticationToken(username, null, new ArrayList<>());
            SecurityContextHolder.getContext().setAuthentication(authenticationToken);
        }
        chain.doFilter(request, response);
    }
}