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

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.

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