# 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 : 1. L'API lit le JWT depuis le header `Authorization`, pas depuis un cookie. 2. Un site malveillant ne peut pas lire `localStorage` d'une autre origine (same-origin policy). 3. 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 # .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 : 1. Ajouter un middleware CSRF (double-submit cookie ou synchronizer token). 2. Configurer `SameSite=Strict` ou `Lax` + `Secure` sur le cookie de session. 3. Restreindre `CORS_ORIGINS` à la liste blanche exacte. 4. Ne jamais exposer le token CSRF dans une réponse lisible par JavaScript si le cookie est `HttpOnly`. ## Checklist déploiement - [ ] `CORS_ORIGINS` défini en production (pas de fallback `*`) - [ ] `JWT_SECRET` unique et fort (min. 32 caractères — le serveur refuse de démarrer sinon) - [ ] `ENCRYPTION_KEY` défini (32 octets base64/hex, 64 caractères hex — fail-fast au boot) - [ ] HTTPS terminé au reverse proxy (`TRUST_PROXY=true`) - [ ] `require_withdrawal_2fa=true` si 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` + claim `tv`