78 lines
3.4 KiB
Markdown
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`
|