基于Spring Security的JWT认证深度解析与实践指南

liuian 2025-07-24 19:48 53 浏览

一、JWT认证核心原理剖析

1. JWT令牌结构解析

Header：采用HMAC SHA256算法示例

json

{
  "alg": "HS256",
  "typ": "JWT"
}

Payload：包含标准声明与业务扩展

json

{
  "sub": "user123",
  "iat": 1629098000,
  "exp": 1629101600,
  "roles": ["ROLE_ADMIN", "ROLE_USER"]
}

Signature：基于密钥的哈希签名实现

HMACSHA256(
  base64UrlEncode(header) + "." + base64UrlEncode(payload),
  secret_key
)

2. Spring Security认证流程

客户端提交用户名密码
AuthenticationFilter拦截请求
AuthenticationManager执行认证逻辑
UserDetailsService加载用户权限
JWT生成组件创建令牌
响应头设置Authorization: Bearer令牌
后续请求的JWT验证流程

二、Spring Security整合JWT实战

1. 安全配置类实现

java

@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {

    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.csrf().disable()
            .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS)
            .and()
            .addFilter(new JwtAuthenticationFilter(authenticationManager()))
            .addFilterAfter(new JwtAuthorizationFilter(), UsernamePasswordAuthenticationFilter.class)
            .authorizeRequests()
            .antMatchers("/auth/login").permitAll()
            .anyRequest().authenticated();
    }
}

2. JWT核心组件实现

java

@Component
public class JwtProvider {
    private final String secret = "complex_secret_key_using_HS256";
    private final long expiration = 3600000; // 1小时

    public String generateToken(UserDetails userDetails) {
        Map<String, Object> claims = new HashMap<>();
        claims.put("roles", userDetails.getAuthorities().stream()
                .map(GrantedAuthority::getAuthority)
                .collect(Collectors.toList()));
        
        return Jwts.builder()
                .setClaims(claims)
                .setSubject(userDetails.getUsername())
                .setIssuedAt(new Date())
                .setExpiration(new Date(System.currentTimeMillis() + expiration))
                .signWith(SignatureAlgorithm.HS256, secret)
                .compact();
    }

    public boolean validateToken(String token) {
        try {
            Jwts.parser().setSigningKey(secret).parseClaimsJws(token);
            return true;
        } catch (JwtException | IllegalArgumentException e) {
            throw new InvalidJwtException("Expired or invalid JWT token");
        }
    }
}

三、认证过滤器深度定制

1. 登录认证过滤器

java

public class JwtAuthenticationFilter extends UsernamePasswordAuthenticationFilter {
    
    private final ObjectMapper objectMapper = new ObjectMapper();
    
    @Override
    public Authentication attemptAuthentication(HttpServletRequest request,
                                                 HttpServletResponse response) {
        try {
            LoginRequest loginRequest = objectMapper.readValue(
                    request.getInputStream(), LoginRequest.class);
            
            UsernamePasswordAuthenticationToken authRequest = new UsernamePasswordAuthenticationToken(
                    loginRequest.getUsername(),
                    loginRequest.getPassword());
            
            return getAuthenticationManager().authenticate(authRequest);
        } catch (IOException e) {
            throw new AuthenticationServiceException("Authentication failed");
        }
    }
    
    @Override
    protected void successfulAuthentication(HttpServletRequest request,
                                            HttpServletResponse response,
                                            FilterChain chain,
                                            Authentication authResult) {
        UserDetails userDetails = (UserDetails) authResult.getPrincipal();
        String token = jwtProvider.generateToken(userDetails);
        response.addHeader("Authorization", "Bearer " + token);
    }
}

2. 请求验证过滤器

java

public class JwtAuthorizationFilter extends OncePerRequestFilter {
    
    @Override
    protected void doFilterInternal(HttpServletRequest request,
                                    HttpServletResponse response,
                                    FilterChain filterChain) {
        String header = request.getHeader("Authorization");
        
        if (header != null && header.startsWith("Bearer ")) {
            String token = header.replace("Bearer ", "");
            
            if (jwtProvider.validateToken(token)) {
                Claims claims = jwtProvider.parseToken(token);
                List<SimpleGrantedAuthority> authorities = ((List<?>) claims.get("roles"))
                        .stream()
                        .map(role -> new SimpleGrantedAuthority((String) role))
                        .collect(Collectors.toList());
                
                UsernamePasswordAuthenticationToken authentication = 
                    new UsernamePasswordAuthenticationToken(
                        claims.getSubject(), null, authorities);
                
                SecurityContextHolder.getContext().setAuthentication(authentication);
            }
        }
        filterChain.doFilter(request, response);
    }
}

四、高级安全策略实现

1. 双Token刷新机制

java

public class TokenRefreshService {
    @Value("${jwt.refreshExpiration}")
    private Long refreshExpiration;

    public TokenPair generateTokenPair(UserDetails userDetails) {
        String accessToken = jwtProvider.generateToken(userDetails);
        String refreshToken = Jwts.builder()
                .setSubject(userDetails.getUsername())
                .setExpiration(new Date(System.currentTimeMillis() + refreshExpiration))
                .signWith(SignatureAlgorithm.HS512, refreshSecret)
                .compact();
        return new TokenPair(accessToken, refreshToken);
    }
    
    public String refreshAccessToken(String refreshToken) {
        Claims claims = validateRefreshToken(refreshToken);
        UserDetails userDetails = userService.loadUserByUsername(claims.getSubject());
        return jwtProvider.generateToken(userDetails);
    }
}

2. 分布式会话黑名单

java

@Service
public class TokenBlacklistService {
    @Autowired
    private RedisTemplate<String, String> redisTemplate;

    public void invalidateToken(String token) {
        Claims claims = jwtProvider.parseToken(token);
        long expiration = claims.getExpiration().getTime() - System.currentTimeMillis();
        if (expiration > 0) {
            redisTemplate.opsForValue().set(
                "blacklist:" + token, 
                "invalid", 
                expiration, 
                TimeUnit.MILLISECONDS);
        }
    }
    
    public boolean isTokenBlacklisted(String token) {
        return redisTemplate.hasKey("blacklist:" + token);
    }
}

五、性能优化与安全加固

1. 算法性能对比

算法类型	密钥长度	签名速度	验证速度	适用场景
HS256	256bit	15μs	12μs	内部系统
RS256	2048bit	850μs	45μs	开放平台
ES256	256bit	120μs	180μs	移动设备

2. 安全防护策略

密钥管理：使用环境变量注入密钥
Token存储：HttpOnly Cookie + SameSite策略
请求限流：Guava RateLimiter保护登录接口
日志审计：记录关键认证事件
漏洞防护：集成Spring Security OWASP防护模块

六、典型问题解决方案

1. 跨域资源共享(CORS)配置

java

@Bean
public CorsFilter corsFilter() {
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    CorsConfiguration config = new CorsConfiguration();
    config.setAllowCredentials(true);
    config.addAllowedOrigin("https://domain.com");
    config.addAllowedHeader("*");
    config.addExposedHeader("Authorization");
    config.addAllowedMethod("*");
    source.registerCorsConfiguration("/**", config);
    return new CorsFilter(source);
}

2. 并发登录控制

java

@Configuration
public class SessionControlConfig {
    @Bean
    public ConcurrentSessionControlAuthenticationStrategy sessionStrategy() {
        ConcurrentSessionControlAuthenticationStrategy strategy = 
            new ConcurrentSessionControlAuthenticationStrategy(sessionRegistry());
        strategy.setMaximumSessions(1);
        strategy.setExceptionIfMaximumExceeded(true);
        return strategy;
    }
    
    @Bean
    public SessionRegistry sessionRegistry() {
        return new SessionRegistryImpl();
    }
}