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é :
- Le conteneur Servlet (Tomcat…) appelle un unique filtre, le
DelegatingFilterProxy, enregistré par Spring Boot. - Ce filtre délègue au bean Spring
springSecurityFilterChain, qui est en réalité unFilterChainProxy. - Le
FilterChainProxychoisit, parmi lesSecurityFilterChaindé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.
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
userest 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
springSecurityFilterChainlui-même. Il contient la liste desSecurityFilterChainde l'application et choisit, pour chaque requête, la première dont leRequestMatchercorrespond à l'URL.- SecurityFilterChain
Bean déclaré avec une méthode
@BeanretournantSecurityFilterChain, construit via l'objetHttpSecurityet 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
SecurityContextcourant, qui contient l'Authenticationde l'utilisateur. Stockage par défaut : unThreadLocal, 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), sescredentials, 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.
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.