Revue de sécurité avant ouverture au public

Audit de l'application avant sa première publication sur internet.
Correctifs immédiats, peu coûteux et sans changement de comportement
en dev :

- Le backend refuse de démarrer en `ENVIRONMENT=production` si
  `JWT_SECRET` est vide, trop court ou égal à la valeur par défaut
  versionnée dans `.env.example` — sinon n'importe qui pourrait forger
  un jeton de session valide (y compris pour un compte COORDINATION)
  sans jamais s'authentifier. Testé (`test_config.py`).
- Avertissement au démarrage si `EMAIL_ENABLED=false` en production :
  dans ce cas le jeton de lien magique est journalisé en clair (confort
  de dev, cf. `api/auth.py`) — un identifiant de connexion en clair dans
  les logs du conteneur en public serait un vrai problème.
- `frontend/nginx.conf` : plus de journal d'accès (la route
  `/connexion?token=…` y ferait apparaître le jeton de lien magique en
  clair), en-têtes `X-Content-Type-Options`, `X-Frame-Options`,
  `Referrer-Policy` (empêche aussi la fuite de ce même jeton vers
  Google Fonts via l'en-tête Referer), `server_tokens off`.
- `deploy/Caddyfile.benevoles` : mêmes en-têtes côté reverse proxy
  public, plus `Strict-Transport-Security`.
- `deploy/README.md` : check-list sécurité avant ouverture (secret,
  SMTP, ne jamais mettre en production la base de démo `app.seed` — le
  mot de passe du compte coordination y est versionné en clair —,
  limites connues comme l'absence de rate-limiting sur `/auth/*`).

Points vérifiés sans modification nécessaire : autorisation par rôle et
cloisonnement par édition cohérents sur tous les endpoints (`owned_or_404`
+ vérification d'édition partout), mots de passe bcryptés, jetons de
lien magique à usage unique haché en base (256 bits d'entropie), pas de
PII/jeton dans les logs applicatifs (RGPD déjà en place), pas
d'injection de gabarit dans les emails (substitution sur liste blanche,
pas de `.format()`), pas d'injection d'en-tête SMTP (`EmailMessage` du
socle Python), pas de `dangerouslySetInnerHTML` côté front, jeton JWT
en `Authorization: Bearer` (pas de cookie ⇒ pas de CSRF), `.env` jamais
versionné, dépendances à jour.

Restent des choix à trancher avec l'utilisateur plutôt qu'à décider
seul (compromis effort/risque) : rate-limiting sur les endpoints
d'authentification, désactivation de `/docs` en production, conteneurs
non-root.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017uUsRg7XzopkCPWimwg9ZM
This commit is contained in:
AdamThomas
2026-09-16 08:14:00 +02:00
co-authored by Claude Sonnet 5
parent ade59b3dc4
commit 89e74e5ec7
7 changed files with 137 additions and 2 deletions
+29 -1
View File
@@ -1,7 +1,14 @@
from functools import lru_cache
from pydantic import model_validator
from pydantic_settings import BaseSettings, SettingsConfigDict
# Valeur de développement uniquement (versionnée dans `.env.example`) : un
# secret connu de quiconque lit le dépôt ne protège plus rien. Voir le
# contrôle dans `Settings.check_production_secrets`.
_DEV_JWT_SECRET = "dev-insecure-secret-change-me-please-32b"
_MIN_JWT_SECRET_LENGTH = 32
class Settings(BaseSettings):
"""Configuration applicative, alimentée par l'environnement."""
@@ -20,7 +27,7 @@ class Settings(BaseSettings):
)
# Authentification (lien magique + session JWT). Secret >= 32 octets.
jwt_secret: str = "dev-insecure-secret-change-me-please-32b"
jwt_secret: str = _DEV_JWT_SECRET
magic_link_ttl_minutes: int = 30
session_ttl_hours: int = 12
@@ -49,6 +56,27 @@ class Settings(BaseSettings):
def is_production(self) -> bool:
return self.environment == "production"
@model_validator(mode="after")
def check_production_secrets(self) -> "Settings":
"""Un secret JWT par défaut, vide ou trop court n'importe pas en dev
(confort), mais en production il permettrait de forger un jeton pour
n'importe quel compte (y compris COORDINATION) — donc de fabriquer
soi-même un jeton valide sans jamais s'authentifier. On refuse de
démarrer plutôt que de tourner silencieusement sans protection."""
if not self.is_production:
return self
if (
not self.jwt_secret
or self.jwt_secret == _DEV_JWT_SECRET
or len(self.jwt_secret) < _MIN_JWT_SECRET_LENGTH
):
raise ValueError(
"JWT_SECRET manquant, par défaut ou trop court (>= "
f"{_MIN_JWT_SECRET_LENGTH} caractères) en production. "
"Générer une vraie valeur : openssl rand -hex 32"
)
return self
@lru_cache
def get_settings() -> Settings: