Spring Boot 安全审查

在添加身份验证、处理输入、创建端点或处理敏感密钥时使用。

身份验证（Authentication）

优先使用无状态 JWT 或带有吊销列表的不透明令牌（Opaque Token）
对于会话，使用
```
httpOnly
```
、
```
Secure
```
、
```
SameSite=Strict
```
的 Cookie
在
```
OncePerRequestFilter
```
或资源服务器中验证令牌

@Component
public class JwtAuthFilter extends OncePerRequestFilter {
  private final JwtService jwtService;

  public JwtAuthFilter(JwtService jwtService) {
    this.jwtService = jwtService;
  }

  @Override
  protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
      FilterChain chain) throws ServletException, IOException {
    String header = request.getHeader(HttpHeaders.AUTHORIZATION);
    if (header != null && header.startsWith("Bearer ")) {
      String token = header.substring(7);
      Authentication auth = jwtService.authenticate(token);
      SecurityContextHolder.getContext().setAuthentication(auth);
    }
    chain.doFilter(request, response);
  }
}

授权（Authorization）

启用方法级安全：
```
@EnableMethodSecurity
```

使用

@PreAuthorize("hasRole('ADMIN')")

或

@PreAuthorize("@authz.canEdit(#id)")

默认拒绝访问，仅公开必要的范围（Scope）

输入验证（Input Validation）

在控制器中使用
```
@Valid
```
进行 Bean Validation
在 DTO 上应用约束：
```
@NotBlank
```
、
```
@Email
```
、
```
@Size
```
以及自定义校验器
在渲染前使用白名单对 HTML 进行清理（Sanitize）

SQL 注入防护

使用 Spring Data Repository 或参数化查询
原生查询使用
```
:param
```
绑定，禁止字符串拼接

CSRF 防护

对于浏览器会话应用，启用 CSRF 并在表单/响应头中包含令牌
对于使用 Bearer 令牌的纯 API 应用，禁用 CSRF 并依赖无状态身份验证

http
  .csrf(csrf -> csrf.disable())
  .sessionManagement(sm -> sm.sessionCreationPolicy(SessionCreationPolicy.STATELESS));

密钥管理（Secrets Management）

禁止在源码中包含密钥。从环境变量或 Vault 加载
确保
```
application.yml
```
中不含凭据，使用占位符代替
定期轮换令牌和数据库凭证

安全响应头（Security Headers）

http
  .headers(headers -> headers
    .contentSecurityPolicy(csp -> csp
      .policyDirectives("default-src 'self'"))
    .frameOptions(HeadersConfigurer.FrameOptionsConfig::sameOrigin)
    .xssProtection(Customizer.withDefaults())
    .referrerPolicy(rp -> rp.policy(ReferrerPolicyHeaderWriter.ReferrerPolicy.NO_REFERRER)));

速率限制（Rate Limiting）

对高成本端点应用 Bucket4j 或网关级限制
记录突发流量日志并发送告警，返回带有重试提示的 429 状态码

依赖项安全（Dependency Security）

在 CI 中运行 OWASP Dependency Check / Snyk
保持 Spring Boot 和 Spring Security 处于受支持的版本
针对已知的 CVE 漏洞使构建失败

日志与 PII（个人识别信息）

禁止在日志中记录密钥、令牌、密码或完整的银行卡号（PAN）数据
脱敏敏感字段，并使用结构化 JSON 日志

文件上传

验证文件大小、内容类型（Content-Type）和扩展名
存储在 Web 根目录之外，并根据需要进行扫描

发布前检查清单

注意：默认拒绝（Default Deny）、验证输入、应用最小权限原则，并优先采用“配置即安全”的实践。

Everything-claude-code-zh springboot-security

Spring Boot 安全审查

身份验证（Authentication）

授权（Authorization）

输入验证（Input Validation）

SQL 注入防护

CSRF 防护

密钥管理（Secrets Management）

安全响应头（Security Headers）

速率限制（Rate Limiting）

依赖项安全（Dependency Security）

日志与 PII（个人识别信息）

文件上传

发布前检查清单