Revisão de Segurança do Spring Boot

Use ao adicionar autenticação, tratar entradas, criar endpoints ou lidar com segredos.

Quando Ativar

• Adicionando autenticação (JWT, OAuth2, baseada em sessão)
• Implementando autorização (@PreAuthorize, acesso baseado em roles)
• Validando entrada do usuário (Bean Validation, validadores customizados)
• Configurando CORS, CSRF ou cabeçalhos de segurança
• Gerenciando segredos (Vault, variáveis de ambiente)
• Adicionando limitação de taxa (rate limiting) ou proteção contra força bruta
• Escaneando dependências em busca de CVEs

Autenticação

• Prefira tokens JWT stateless ou tokens opacos com lista de revogação
• Use cookies httpOnly, Secure, SameSite=Strict para sessões
• Valide tokens com OncePerRequestFilter ou resource server

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

Autorização

• Habilite segurança de métodos: @EnableMethodSecurity
• Use @PreAuthorize("hasRole('ADMIN')") ou @PreAuthorize("@authz.canEdit(#id)")
• Negue por padrão; exponha apenas os escopos necessários

@RestController
@RequestMapping("/api/admin")
public class AdminController {

  @PreAuthorize("hasRole('ADMIN')")
  @GetMapping("/users")
  public List<UserDto> listUsers() {
    return userService.findAll();
  }

  @PreAuthorize("@authz.isOwner(#id, authentication)")
  @DeleteMapping("/users/{id}")
  public ResponseEntity<Void> deleteUser(@PathVariable Long id) {
    userService.delete(id);
    return ResponseEntity.noContent().build();
  }
}

Validação de Entrada

• Use Bean Validation com @Valid nos controllers
• Aplique restrições em DTOs: @NotBlank, @Email, @Size, validadores customizados
• Limpe qualquer HTML com uma whitelist antes de renderizar

// BAD: No validation
@PostMapping("/users")
public User createUser(@RequestBody UserDto dto) {
  return userService.create(dto);
}

// GOOD: Validated DTO
public record CreateUserDto(
    @NotBlank @Size(max = 100) String name,
    @NotBlank @Email String email,
    @NotNull @Min(0) @Max(150) Integer age
) {}

@PostMapping("/users")
public ResponseEntity<UserDto> createUser(@Valid @RequestBody CreateUserDto dto) {
  return ResponseEntity.status(HttpStatus.CREATED)
      .body(userService.create(dto));
}

Prevenção de Injeção de SQL

• Use repositórios Spring Data ou queries parametrizadas
• Para queries nativas, use bindings :param; nunca concatene strings

// BAD: String concatenation in native query
@Query(value = "SELECT * FROM users WHERE name = '" + name + "'", nativeQuery = true)

// GOOD: Parameterized native query
@Query(value = "SELECT * FROM users WHERE name = :name", nativeQuery = true)
List<User> findByName(@Param("name") String name);

// GOOD: Spring Data derived query (auto-parameterized)
List<User> findByEmailAndActiveTrue(String email);

Codificação de Senhas

• Sempre hasheie senhas com BCrypt ou Argon2 — nunca armazene em texto plano
• Use o bean PasswordEncoder, não hashing manual

@Bean
public PasswordEncoder passwordEncoder() {
  return new BCryptPasswordEncoder(12); // cost factor 12
}

// In service
public User register(CreateUserDto dto) {
  String hashedPassword = passwordEncoder.encode(dto.password());
  return userRepository.save(new User(dto.email(), hashedPassword));
}

Proteção CSRF

• Para apps com sessões de navegador, mantenha o CSRF habilitado; inclua o token em formulários/cabeçalhos
• Para APIs puras com tokens Bearer, desabilite o CSRF e confie na autenticação stateless

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

Gerenciamento de Segredos

• Sem segredos no código; carregue de variáveis de ambiente ou vault
• Mantenha application.yml livre de credenciais; use placeholders
• Rotacione tokens e credenciais de banco de dados regularmente

# RUIM: Hardcoded em application.yml
spring:
  datasource:
    password: mySecretPassword123

# BOM: Placeholder de variável de ambiente
spring:

…