Protection CSRF
Règles
- Définissez
SameSite=Lax sur tous les cookies – cela bloque la plupart des attaques CSRF par défaut
- Utilisez
SameSite=Strict pour les actions hautement sensibles (suppression de compte, changement de mot de passe)
- Implémentez le motif de double soumission pour les API personnalisées : jeton CSRF dans un cookie + en-tête de requête
- Incluez des jetons CSRF dans tous les formulaires HTML qui effectuent des actions modifiant l'état
- Vérifiez les en-têtes
Origin et Referer sur les requêtes modifiant l'état en tant que défense en profondeur
- Les Server Actions Next.js et les form actions SvelteKit gèrent automatiquement le CSRF – utilisez-les
- Pour les SPA : envoyez le jeton CSRF dans un en-tête personnalisé (
X-CSRF-Token) – les navigateurs bloquent les en-têtes personnalisés cross-origin par défaut
import crypto from "crypto";
function generateCsrfToken(res) {
const token = crypto.randomBytes(32).toString("hex");
res.cookie("csrf_token", token, { httpOnly: false, sameSite: "strict", secure: true });
return token;
}
function verifyCsrf(req) {
const cookieToken = req.cookies.csrf_token;
const headerToken = req.headers["x-csrf-token"];
if (!cookieToken || cookieToken !== headerToken) {
throw new Error("Échec de la validation CSRF");
}
}
À éviter
- Se fier uniquement à l'authentification basée sur les cookies sans protection CSRF – n'importe quel site peut soumettre des formulaires à vos points d'accès
- Les jetons CSRF qui ne pivotent jamais – un seul jeton divulgué compromet toutes les requêtes futures
- Les requêtes GET qui changent d'état – la protection CSRF ne fonctionne que sur POST/PUT/DELETE car les requêtes GET contournent SameSite=Lax
- Désactiver la protection CSRF parce que "c'est juste une API" – si des cookies sont impliqués, le CSRF s'applique