Formations — 1 037 leçons en français

Accueil › Spring Boot › Architecture de Spring Security : la chaîne de filtres

Architecture de Spring Security : la chaîne de filtres

Spring Securityintermediaire

Spring Security fonctionne comme une chaîne de filtres Servlet, placée devant vos contrôleurs. Dès que spring-boot-starter-security est sur le classpath, l'auto-configuration protège toutes les routes et crée un utilisateur user avec un mot de passe généré, affiché une fois dans les logs.

Le mécanisme, en résumé :

  1. Le conteneur Servlet (Tomcat…) appelle un unique filtre, le DelegatingFilterProxy, enregistré par Spring Boot.
  2. Ce filtre délègue au bean Spring springSecurityFilterChain, qui est en réalité un FilterChainProxy.
  3. Le FilterChainProxy choisit, parmi les SecurityFilterChain déclarées, la première dont l'URL correspond, et exécute sa propre liste de filtres (authentification, contexte de sécurité, autorisation…).

On configure une SecurityFilterChain avec la DSL lambda, seule syntaxe recommandée depuis Spring Security 5.7 (l'ancienne API fluide chaînée, et WebSecurityConfigurerAdapter, sont supprimées) :

@Configuration
public class SecurityConfig {

    @Bean
    SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
        http
            .authorizeHttpRequests(auth -> auth
                .requestMatchers("/api/public/**").permitAll()
                .anyRequest().authenticated()
            )
            .formLogin(Customizer.withDefaults());
        return http.build();
    }
}

Dès qu'un bean SecurityFilterChain est déclaré, il remplace la configuration par défaut de Spring Boot.

REQUÊTE HTTP GET /api/… CHAÎNE DE FILTRES (SecurityFilterChain) SecurityContextHolderFilter restaure le contexte filtre d'authentification jeton, formulaire, Basic ExceptionTranslationFilter traduit les refus AuthorizationFilter autorise ou refuse Dispatcher Servlet puis le contrôleur refus : 401 ou 403 La conséquence qu'on oublie Un refus est produit ici, avant tout contrôleur : votre @RestControllerAdvice ne le voit jamais. Le format des 401 et 403 se configure par authenticationEntryPoint et accessDeniedHandler.
Spring Security est une chaîne de filtres de servlet, en amont de Spring MVC. Tout ce qui s'y décide se décide avant que votre code ne soit atteint.

Les termes à connaître

spring-boot-starter-security

Dépendance qui active Spring Security. Dès son ajout, toutes les requêtes sont protégées : un utilisateur user est créé avec un mot de passe généré aléatoirement, affiché une seule fois dans les logs au démarrage.

DelegatingFilterProxy

Filtre standard Servlet enregistré dans le conteneur (Tomcat…) par Spring Boot. Son seul rôle est de déléguer chaque requête à un bean Spring nommé springSecurityFilterChain : le pont entre le monde Servlet et le monde Spring.

FilterChainProxy

Le bean springSecurityFilterChain lui-même. Il contient la liste des SecurityFilterChain de l'application et choisit, pour chaque requête, la première dont le RequestMatcher correspond à l'URL.

SecurityFilterChain

Bean déclaré avec une méthode @Bean retournant SecurityFilterChain, construit via l'objet HttpSecurity et sa DSL lambda (http.authorizeHttpRequests(auth -> ...)). Il définit la liste ordonnée des filtres de sécurité pour un ensemble de requêtes.

SecurityContextHolder

Point d'accès statique au SecurityContext courant, qui contient l'Authentication de l'utilisateur. Stockage par défaut : un ThreadLocal, donc valable pour le thread qui traite la requête.

Authentication

Interface qui représente l'utilisateur authentifié (ou la tentative d'authentification) : le principal (souvent un UserDetails), ses credentials, et ses autorités (GrantedAuthority).

ExceptionTranslationFilter

Filtre qui intercepte les exceptions de sécurité (AuthenticationException, AccessDeniedException) levées plus loin dans la chaîne et les traduit en réponse HTTP : redirection vers le login, 401 ou 403.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.