Formations — 1 037 leçons en français

Accueil › Spring Boot › Protéger les écritures, devant le contrôleur

Protéger les écritures, devant le contrôleur

Exercice de la série « Un projet de bout en bout »avance

Où l'on en est. L'API est complète et ses erreurs sont traduites en un seul endroit — le GestionnaireErreurs de l'exercice 8 est désormais fourni. Il reste un détail que personne n'a abordé : n'importe qui peut écrire. Le catalogue est public en lecture, et il doit le rester ; mais créer ou supprimer un produit est le travail d'un administrateur.

Ni Spring, ni serveur, ni base de données ne tournent ici : votre code est compilé par javac seul, et c'est un routeur miniature fourni — visible sous « Code fourni, déjà en place » — précédé cette fois d'une chaîne de filtres. Monter le projet, le pom.xml, le application.yml et le démarrage ne s'apprennent pas ici : ils restent dans les leçons, et c'est leur place. Spring Security, en particulier, ne s'installe pas ici : ce qui s'apprend, c'est où la décision se prend, et pourquoi là.

Ce que le code fourni vous donne, en plus du prélude de l'exercice 8 :

record Requete(String verbe, String cible, String corps, String jeton) { }

interface Filtre {
    // une reponse pour arreter la chaine, ou null pour laisser passer
    ReponseHttp avant(Requete requete);
}

final class Jetons {
    static Optional<String> role(String jeton)   // vide si le jeton est inconnu
}

Les jetons connus sont jeton-admin (rôle ADMIN) et jeton-client (rôle CLIENT) ; tout le reste est inconnu. Un ChaineDeFiltres fourni traverse les filtres dans l'ordre : le premier qui rend une réponse arrête tout, et le routeur n'est jamais atteint. S'ils laissent tous passer, la requête arrive au contrôleur. Un FiltreTrace est déjà en tête de chaîne : il journalise et laisse passer. Le banc affiche ce journal, la réponse, puis la taille du catalogue — c'est ainsi qu'on voit si une écriture refusée a vraiment été empêchée.

Ce qu'on vous demande. Écrivez FiltreAuthentification, qui implémente Filtre, et décide ainsi :

situation décision
verbe GET laisse passer, avec ou sans jeton — le catalogue est public
écriture (POST, PUT, PATCH, DELETE) sans jeton 401, corps authentification requise
écriture avec un jeton inconnu 401, corps jeton inconnu
écriture avec le rôle CLIENT 403, corps droits insuffisants
écriture avec le rôle ADMIN laisse passer

« Sans jeton » signifie null ou une chaîne de blancs. Laisser passer se dit en rendant null.

401 et 403 ne disent pas la même chose, et les confondre coûte cher. 401 Unauthorized — mal nommé, il devrait s'appeler Unauthenticated — dit « je ne sais pas qui tu es : présente-toi, ou présente-toi autrement ». Le client sait alors qu'il doit se connecter, ou rafraîchir un jeton expiré. 403 Forbidden dit « je sais qui tu es, et ce n'est pas permis » : se reconnecter n'y changera rien, il faut d'autres droits. Un client qui reçoit 403 là où 401 était juste boucle sur un message « accès refusé » alors qu'il lui suffisait de renouveler son jeton ; l'inverse l'envoie se reconnecter indéfiniment pour une permission qu'il n'aura jamais.

Pourquoi devant le contrôleur, et non dedans. Le filtre voit la requête avant qu'une route soit choisie, avant que le corps soit transformé en objet, avant que le service soit touché. Trois conséquences : la décision est prise une fois pour toute l'application ; aucun contrôleur ne peut l'oublier ; et une requête refusée ne coûte ni requête SQL ni désérialisation. C'est exactement la place de la SecurityFilterChain de Spring Security — un filtre de servlet, donc avant le DispatcherServlet.

Les cas limites, annoncés. Une lecture avec un jeton de client passe comme une lecture sans jeton : le filtre n'a aucune raison de s'en occuper. Et une suppression autorisée mais portant sur un produit inexistant rend 404 : le filtre a laissé passer, et c'est le gestionnaire d'erreurs de l'exercice 8 qui a répondu. Le filtre dit qui a le droit d'essayer, pas si l'essai réussit.

Le piège. Le code de départ exige un jeton de tout le monde, et se contente de vérifier qu'il y en a un. Résultat : la lecture publique est cassée — 403 sur un simple GET —, un jeton inventé de toutes pièces ouvre les écritures, et le rôle n'est jamais regardé, donc un client supprime les produits du catalogue. Les trois fautes tiennent dans un seul if, et c'est le if qu'on écrit quand on confond « authentifié » et « autorisé ».

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 « Un projet de bout en bout »