games_app/deploy/SECURITY_CSRF.md
2026-07-07 15:03:17 +02:00

78 lines
3.4 KiB
Markdown

# 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`