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
essai("GET", "/produits/1", "", "")essai("GET", "/produits/1", "", "jeton-client")essai("POST", "/produits", "ecran;bureau;15900;4", "")essai("POST", "/produits", "ecran;bureau;15900;4", "jeton-mystere")essai("POST", "/produits", "ecran;bureau;15900;4", "jeton-client")essai("POST", "/produits", "ecran;bureau;15900;4", "jeton-admin")
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 »
- Le modèle et le dépôt, premières fondations
- Lister, consulter, et le 404 qui n'est pas celui du routeur
- Créer une ressource, et dire où elle est
- Refuser une entrée, et nommer le champ fautif
- Remplacer, modifier, supprimer — et rejouer deux fois
- Filtrer et trier, sans casser l'URL de la liste
- Une page de catalogue, et ses bornes
- Les erreurs, traitées en un seul endroit
- Une commande qui touche deux agrégats, et reste cohérente