Formations — 1 037 leçons en français

Accueil › Spring Boot › La chaîne de filtres, et l'endroit où elle s'arrête

La chaîne de filtres, et l'endroit où elle s'arrête

Exercice de la série « Ce qui fait que Spring paraît magique »intermediaire

Spring Security, en entier, c'est ce modèle — et rien d'autre. Pas de magie, pas d'interception mystérieuse : une liste de filtres qui s'appellent l'un l'autre, chacun décidant s'il passe la requête à la suite ou s'il répond lui-même. Celui qui répond lui-même interrompt tout ce qui venait après. Quand vous aurez écrit le maillon de cette chaîne, la SecurityFilterChain cessera d'être une boîte noire.

Ni Spring, ni serveur, ni base de données ne tournent ici : votre code est compilé par javac seul. Votre ChaineDeFiltres remplace la VirtualFilterChain de Spring Security — la classe interne du FilterChainProxy qui tient la position dans la liste et qu'on reçoit sous le nom de FilterChain dans un doFilter.

Ce que le code fourni vous donne (bloc « Code fourni, déjà en place ») : les record Requete(String chemin, String jeton) et record Reponse(int statut, String corps), l'interface Chaine { Reponse suivant(Requete requete); }, l'interface Filtre { Reponse filtrer(Requete requete, Chaine chaine); }, les quatre filtres déjà écrits, la « servlet » finale, et le banc d'essai. Chaque filtre journalise son entrée et sa sortie : le journal vous rend l'ordre d'exécution et l'endroit où la chaîne s'est arrêtée.

Les quatre filtres, dans l'ordre où le banc les empile :

  1. FiltreTrace — journalise, passe la suite, journalise le statut au retour. L'équivalent du WebAsyncManagerIntegrationFilter, tout en haut, qui voit tout.
  2. FiltreCors — passe la suite. L'équivalent du CorsFilter.
  3. FiltreAuthentification — sans jeton, il répond 401 lui-même et n'appelle pas la suite. L'équivalent de la paire UsernamePasswordAuthenticationFilter / ExceptionTranslationFilter.
  4. FiltreAutorisation — sur /admin… sans le jeton admin, il répond 403. L'équivalent de l'AuthorizationFilter, toujours le dernier.

Au bout de la liste, la « servlet » : elle journalise qu'elle a été atteinte et rend 200. C'est le DispatcherServlet — celui de l'exercice précédent. Une requête qui l'atteint est une requête que la sécurité a laissée passer.

Ce qu'on vous demande. Écrivez la classe ChaineDeFiltres :

class ChaineDeFiltres implements Chaine {
    ChaineDeFiltres(List<Filtre> filtres, Function<Requete, Reponse> servlet)
    public Reponse suivant(Requete requete)
}

suivant donne la requête au prochain filtre non encore appelé, en se passant elle-même comme Chaine — c'est ainsi qu'un filtre peut appeler la suite. Quand il n'y a plus de filtre, suivant appelle la servlet. Un seul objet, une position qui avance : chaque filtre est appelé au plus une fois par requête.

Ce qui est vraiment vérifié. Le statut rendu, et le journal : dans quel ordre les filtres se sont exécutés, et à quel maillon la chaîne s'est arrêtée. C'est tout l'enseignement. Une requête anonyme sur /commandes doit produire ceci, et pas autre chose :

entre trace
entre cors
entre authentification
authentification : INTERROMPT, la suite ne sera pas appelee
sort cors : 401
sort trace : 401

Trois choses s'y lisent d'un coup : l'ordre d'entrée, le fait que autorisation n'a jamais été appelé, et que la servlet non plus. La réponse 401 est ensuite remontée à travers les filtres déjà traversés, qui la voient passer — c'est pour cela que FiltreTrace peut journaliser un statut qu'il n'a pas produit.

Le piège du code de départ, et c'est un trou de sécurité. Il fait ce que suggère le mot « liste » : il boucle sur les filtres, en donnant à chacun une chaîne qui mène directement à la servlet, puis appelle la servlet une dernière fois pour construire la réponse. Il compile, il ne plante pas, et il rend 200 à une requête sans jeton — alors que le filtre d'authentification a bien répondu 401. Sa réponse a simplement été jetée. Lisez le journal du départ : la servlet y est atteinte quatre ou cinq fois. Une chaîne n'est pas une boucle.

Cas de test

Écrire le code et le faire exécuter →

Votre code est réellement compilé par javac et exécuté sur une JVM — aucun JDK à installer —, et la correction compare son résultat à celui d'une solution de référence.

La leçon qui prépare cet exercice

Les autres exercices de « Ce qui fait que Spring paraît magique »