3.4 KiB
Sécurité CSRF et modèle d'authentification — Prediqo
Ce document décrit le modèle de protection CSRF de la plateforme Prediqo et les exigences de configuration en production.
Modèle d'authentification
Prediqo utilise un modèle stateless JWT :
| Token | Stockage client | Transport | Durée |
|---|---|---|---|
| Access token | localStorage (prediqo_web/src/shared/auth/tokenStorage.ts) |
Header Authorization: Bearer … |
Courte (défaut 15 min, configurable) |
| Refresh token | localStorage |
Corps JSON POST /api/v1/auth/refresh |
Longue (défaut 7 jours) |
Il n'y a pas de cookie de session HTTP. Les mécanismes CSRF classiques (token synchronizer sur formulaires, SameSite=Strict sur cookie de session) ne s'appliquent donc pas directement à l'API actuelle.
Pourquoi le CSRF cookie-based ne s'applique pas
Une attaque CSRF exploite le fait qu'un navigateur envoie automatiquement les cookies d'une origine lors d'une requête cross-site.
Avec Prediqo :
- L'API lit le JWT depuis le header
Authorization, pas depuis un cookie. - Un site malveillant ne peut pas lire
localStoraged'une autre origine (same-origin policy). - Le navigateur n'attache pas le JWT Prediqo aux requêtes cross-origin sans que du JavaScript malveillant s'exécute déjà sur l'origine Prediqo (XSS).
Risque principal restant : XSS → vol de tokens. Mitigations en place :
- TTL court des access tokens
- Invalidation via
users.token_version(changement MDP, logout-all, suppression) - Sanitization HTML FAQ (serveur + client)
- Helmet (en-têtes de sécurité)
CORS — exigences production
Fichier : backend/src/app.ts → resolveCorsOrigin()
| Environnement | Comportement |
|---|---|
| Développement | Toutes origines autorisées |
Production avec CORS_ORIGINS |
Liste blanche stricte |
Production sans CORS_ORIGINS |
❌ Refusé (fail-closed) — configurez CORS_ORIGINS ou APP_PUBLIC_URL |
Configuration recommandée
# .env production
CORS_ORIGINS=https://app.prediqo.com,https://admin.prediqo.com
APP_PUBLIC_URL=https://app.prediqo.com
TRUST_PROXY=true
credentials: true est activé côté CORS pour compatibilité future ; tant qu'aucun cookie d'auth n'est utilisé, l'impact CSRF reste limité.
Si vous migrez vers des cookies de session
Avant d'introduire un cookie HttpOnly pour l'auth :
- Ajouter un middleware CSRF (double-submit cookie ou synchronizer token).
- Configurer
SameSite=StrictouLax+Securesur le cookie de session. - Restreindre
CORS_ORIGINSà la liste blanche exacte. - Ne jamais exposer le token CSRF dans une réponse lisible par JavaScript si le cookie est
HttpOnly.
Checklist déploiement
CORS_ORIGINSdéfini en production (pas de fallback*)JWT_SECRETunique et fort (min. 32 caractères — le serveur refuse de démarrer sinon)ENCRYPTION_KEYdéfini (32 octets base64/hex, 64 caractères hex — fail-fast au boot)- HTTPS terminé au reverse proxy (
TRUST_PROXY=true) require_withdrawal_2fa=truesi politique plateforme l'exige- Sentry / monitoring actif (
deploy/PRODUCTION_SENTRY_CLAMAV.md)
Références code
- Auth middleware :
backend/src/middleware/auth.ts - Token storage frontend :
prediqo_web/src/shared/auth/tokenStorage.ts - CORS :
backend/src/app.ts - Invalidation JWT :
users.token_version+ claimtv