MartyAIDocumentation

Mécanismes de sécurité et protection CSRF

Détail des protections implémentées par SecurityFilter et leur intégration dans les formulaires.

Jeton CSRF : génération, stockage et vérification

Le filtre SecurityFilter implémente une protection CSRF synchronisée sur la session.

Pour toute requête dont le chemin se termine par .do, le filtre accède à la session HTTP. Si aucun jeton n’existe sous la clé csrf, il en génère un via UUID.randomUUID().toString() et le stocke dans la session. Ce jeton est donc unique par session et persiste pendant sa durée de vie.

Côté client, chaque formulaire (souscripteur, simulation, recapitulatif, produit) inclut le fragment fragments/csrf.jspf, qui injecte un champ caché <input type="hidden" name="csrf" value="..."> dont la valeur est celle du jeton stocké en session (${sessionScope.csrf}).

Lors d’une requête POST vers une URL .do, SecurityFilter extrait le paramètre csrf de la requête et le compare au jeton stocké en session. La comparaison est effectuée en temps constant via MessageDigest.isEqual sur les représentations UTF-8 des deux chaînes, afin d’éviter les attaques par chronométrage. Si le paramètre est absent, dépasse 100 caractères, ou ne correspond pas au jeton de session, la requête est rejetée avec un code 403 Forbidden.

Consulter les sources (6)
Marty Harness · source
src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56
Marty Harness · source
src/main/webapp/WEB-INF/jsp/fragments/csrf.jspf · lignes 1–1
Marty Harness · source
src/main/webapp/WEB-INF/jsp/souscripteur.jsp · lignes 1–29
Marty Harness · source
src/main/webapp/WEB-INF/jsp/simulation.jsp · lignes 1–23
Marty Harness · source
src/main/webapp/WEB-INF/jsp/recapitulatif.jsp · lignes 1–26
Marty Harness · source
src/main/webapp/WEB-INF/jsp/produit.jsp · lignes 1–25

En-têtes HTTP de sécurité configurés par SecurityFilter

SecurityFilter applique systématiquement les en-têtes suivants à chaque réponse, avant tout traitement ultérieur :

  • X-Content-Type-Options: nosniff → Empêche le navigateur de deviner ou de changer le type MIME déclaré par le serveur, ce qui limite les risques d’exécution de scripts ou de fichiers malveillants interprétés dans un contexte non prévu.
  • X-Frame-Options: DENY → Interdit l’affichage de la page dans un iframe ou une frame, protégeant contre les attaques de type clickjacking.
  • Referrer-Policy: no-referrer → Supprime l’en-tête Referer des requêtes sortantes, évitant la fuite d’informations sur les URLs internes.
  • Content-Security-Policy: default-src 'self'; style-src 'self'; img-src 'self'; script-src 'none'; object-src 'none'; base-uri 'none'; frame-ancestors 'none'; form-action 'self' → Restreint les sources autorisées : seules les ressources locales ('self') sont permises pour les styles et images ; les scripts, objets, frames et actions de formulaire sont bloqués ou limités à l’origine, ce qui empêche l’injection de ressources externes non approuvées.
  • Cache-Control: no-store → Interdit la mise en cache des réponses, garantissant que les données sensibles (comme les jetons de session ou les informations de souscription) ne sont pas conservées localement par le navigateur ou des proxys.

Ces en-têtes sont définis avant toute validation de méthode ou de jeton, assurant une protection immédiate contre plusieurs classes de vulnérabilités web.

Consulter les sources (1)
Marty Harness · source
src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56

Restriction des méthodes HTTP à GET, HEAD et POST

SecurityFilter vérifie explicitement la méthode HTTP de chaque requête. Si celle-ci n’est ni GET, ni HEAD, ni POST, le filtre renvoie immédiatement une erreur 405 Method Not Allowed et ajoute un en-tête Allow: GET, HEAD, POST à la réponse.

Cette restriction limite la surface d’attaque de l’application en interdisant les méthodes potentiellement dangereuses ou non utilisées (comme PUT, DELETE, TRACE, etc.). Elle s’applique avant toute autre logique, y compris la vérification du jeton CSRF, ce qui garantit qu’aucune requête avec une méthode non autorisée ne peut atteindre les actions Struts ou les traitements métier.

Consulter les sources (1)
Marty Harness · source
src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56

Intégration du jeton CSRF dans les formulaires

L’intégration du jeton CSRF dans l’interface repose sur deux éléments :

  • Le fragment JSP fragments/csrf.jspf qui génère dynamiquement le champ caché contenant le jeton de session.
  • L’inclusion systématique de ce fragment dans chaque formulaire de l’application :
    • souscripteur.jsp (saisie des informations du souscripteur)
    • simulation.jsp (paramètres du placement)
    • recapitulatif.jsp (validation finale avant confirmation)
    • produit.jsp (lancement du parcours de souscription)

Cette approche centralisée garantit que toute requête POST vers une action .do transmet automatiquement le jeton CSRF attendu par SecurityFilter.

Consulter les sources (5)
Marty Harness · source
src/main/webapp/WEB-INF/jsp/fragments/csrf.jspf · lignes 1–1
Marty Harness · source
src/main/webapp/WEB-INF/jsp/souscripteur.jsp · lignes 1–29
Marty Harness · source
src/main/webapp/WEB-INF/jsp/simulation.jsp · lignes 1–23
Marty Harness · source
src/main/webapp/WEB-INF/jsp/recapitulatif.jsp · lignes 1–26
Marty Harness · source
src/main/webapp/WEB-INF/jsp/produit.jsp · lignes 1–25

Comportement en cas d’échec de vérification CSRF

Lorsque la vérification du jeton CSRF échoue (jeton absent, trop long, ou non égal à celui en session), SecurityFilter renvoie un code 403 Forbidden sans redirection ni message supplémentaire. La page d’erreur erreur.jsp affiche alors un message spécifique pour ce code : « Le formulaire a expiré ou son jeton de sécurité est invalide. Rechargez la page avant de réessayer. » (via la condition ${requestScope['jakarta.servlet.error.status_code'] == 403}).

Consulter les sources (2)
Marty Harness · source
src/main/java/fr/demo/souscription/web/SecurityFilter.java · lignes 16–56
Marty Harness · source
src/main/webapp/WEB-INF/jsp/erreur.jsp · lignes 1–12

Snapshot graph:e63f5f99ab8bbd6992fd2ffb · version 1
Workspace struts-example-3

Empreinte du snapshot
9a6815fc1f0aaae6d1abef9ee7a19d966482e4bb8dc9f23161a788d459d556c1