springboot-security

Révision de la Sécurité Spring Boot

À utiliser lors de l'ajout d'authentification, de la gestion des entrées, de la création d'endpoints ou du traitement des secrets.

Quand Activer

• Ajout d'authentification (JWT, OAuth2, basée sur session)
• Implémentation d'autorisation (@PreAuthorize, contrôle d'accès basé sur les rôles)
• Validation des entrées utilisateur (Bean Validation, validateurs personnalisés)
• Configuration de CORS, CSRF ou des en-têtes de sécurité
• Gestion des secrets (Vault, variables d'environnement)
• Ajout de limitation de débit ou de protection contre les attaques par force brute
• Analyse des dépendances pour les CVEs

Authentification

• Privilégier les jetons JWT sans état ou opaques avec liste de révocation
• Utiliser des cookies httpOnly, Secure, SameSite=Strict pour les sessions
• Valider les jetons avec OncePerRequestFilter ou un serveur de ressources

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

Autorisation

• Activer la sécurité par méthode : @EnableMethodSecurity
• Utiliser @PreAuthorize("hasRole('ADMIN')") ou @PreAuthorize("@authz.canEdit(#id)")
• Refuser par défaut ; n'exposer que les portées nécessaires

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

Validation des Entrées

• Utiliser Bean Validation avec @Valid sur les contrôleurs
• Appliquer des contraintes sur les DTOs : @NotBlank, @Email, @Size, validateurs personnalisés
• Nettoyer tout HTML avec une liste blanche avant affichage

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

// BON : DTO validé
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));
}

Prévention des Injections SQL

• Utiliser les dépôts Spring Data ou des requêtes paramétrées
• Pour les requêtes natives, utiliser les liaisons :param ; ne jamais concaténer des chaînes

// MAUVAIS : Concaténation de chaînes dans une requête native
@Query(value = "SELECT * FROM users WHERE name = '" + name + "'", nativeQuery = true)

// BON : Requête native paramétrée
@Query(value = "SELECT * FROM users WHERE name = :name", nativeQuery = true)
List<User> findByName(@Param("name") String name);

// BON : Requête dérivée Spring Data (auto-paramétrée)
List<User> findByEmailAndActiveTrue(String email);

Encodage des Mots de Passe

• Toujours hacher les mots de passe avec BCrypt ou Argon2 — ne jamais stocker en clair
• Utiliser un bean PasswordEncoder, pas de hachage manuel

@Bean
public PasswordEncoder passwordEncoder() {
  return new BCryptPasswordEncoder(12); // facteur de coût 12
}

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

Protection CSRF

• Pour les applications avec session navigateur, garder CSRF activé ; inclure le jeton dans les formulaires/en-têtes
• Pour les API pures avec jetons Bearer, désactiver CSRF et s'appuyer sur une authentification sans état

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

Gestion des Secrets

• Aucun secret dans le code source ; charger depuis l'environnement ou un coffre
• Garder application.yml exempt d'identifiants ; utiliser des espaces réservés
• Renouveler régulièrement les jetons et les identifiants de base de données

# MAUVAIS : Codé en dur dans application.yml
spring:
  datasource:
    password: mySecretPassword123

# BON : Espace réservé pour variable d'environnement
spring:
  datasource:
    password: ${DB_PASSWORD}

# BON : Intégration Spring Cloud Vault
spring:
  cloud:
    vault:
      uri: https://vault.example.com
      token: ${VAULT_TOKEN}

En-têtes de Sécurité

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

Configuration CORS

• Configurer CORS au niveau du filtre de sécurité, pas par contrôleur
• Restreindre les origines autorisées — ne jamais utiliser * en production

@Bean
public CorsConfigurationSource corsConfigurationSource() {
  CorsConfiguration config = new CorsConfiguration();
  config.setAllowedOrigins(List.of("https://app.example.com"));
  config.setAllowedMethods(List.of("GET", "POST", "PUT", "DELETE"));
  config.setAllowedHeaders(List.of("Authorization", "Content-Type"));
  config.setAllowCredentials(true);
  config.setMaxAge(3600L);

  UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
  source.registerCorsConfiguration("/api/**", config);
  return source;
}

// Dans SecurityFilterChain :
http.cors(cors -> cors.configurationSource(corsConfigurationSource()));

Limitation de Débit

• Appliquer Bucket4j ou des limites au niveau de la passerelle sur les endpoints coûteux
• Journaliser et alerter en cas de pics ; retourner 429 avec des indications de nouvelle tentative

// Utilisation de Bucket4j pour la limitation de débit par endpoint
@Component
public class RateLimitFilter extends OncePerRequestFilter {
  private final Map<String, Bucket> buckets = new ConcurrentHashMap<>();

  private Bucket createBucket() {
    return Bucket.builder()
        .addLimit(Bandwidth.classic(100, Refill.intervally(100, Duration.ofMinutes(1))))
        .build();
  }

  @Override
  protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
      FilterChain chain) throws ServletException, IOException {
    String clientIp = request.getRemoteAddr();
    Bucket bucket = buckets.computeIfAbsent(clientIp, k -> createBucket());

    if (bucket.tryConsume(1)) {
      chain.doFilter(request, response);
    } else {
      response.setStatus(HttpStatus.TOO_MANY_REQUESTS.value());
      response.getWriter().write("{\"error\": \"Rate limit exceeded\"}");
    }
  }
}

Sécurité des Dépendances

• Exécuter OWASP Dependency Check / Snyk dans l'intégration continue
• Maintenir Spring Boot et Spring Security sur des versions supportées
• Échouer les builds en cas de CVEs connues

Journalisation et Données Personnelles (PII)

• Ne jamais journaliser les secrets, jetons, mots de passe ou données PAN complètes
• Masquer les champs sensibles ; utiliser une journalisation structurée en JSON

Téléchargements de Fichiers

• Valider la taille, le type de contenu et l'extension
• Stocker en dehors de la racine web ; scanner si nécessaire

Checklist Avant la Mise en Production

• Les jetons d'authentification sont validés et expirent correctement
• Des gardes d'autorisation sont présentes sur chaque chemin sensible
• Toutes les entrées sont validées et nettoyées
• Pas de SQL concaténé avec des chaînes
• La posture CSRF est correcte pour le type d'application
• Les secrets sont externalisés ; aucun n'est commité
• Les en-têtes de sécurité sont configurés
• La limitation de débit est active sur les API
• Les dépendances sont analysées et à jour
• Les journaux sont exempts de données sensibles

Rappel : Refuser par défaut, valider les entrées, moindre privilège, et sécurité par configuration en premier.