Files
CoHaiSe-CLOUD/docs/security.md
T
Esiah f564908650 refactor: aplatir backend/cloud et frontend/cloud
Le niveau `cloud` etait redondant : il ne reste qu'une seule application.

- backend/cloud/* -> backend/*, frontend/cloud/* -> frontend/*
- workspaces npm : frontend et backend ; reference tsconfig ./backend
- extends tsconfig.base corrige (../ au lieu de ../../)
- docker-compose : APP_DIR backend/frontend, montage ./backend/migrations
- deploy.yml : reconstruit aussi l'image migrate
- chemins mis a jour dans les docs, le Makefile et docker/README.md
2026-10-16 11:50:55 +02:00

3.9 KiB

Sécurité — CoHaiSe Cloud

En place

Comptes et sessions

Mesure Détail
Mots de passe scrypt natif node:crypto (N=16384, r=8, p=1, keylen 64, sel 16 o.), comparaison timingSafeEqual
Stockage session jeton aléatoire 32 o. côté client, SHA-256 en base
Cookie cohaise_session, httpOnly, SameSite=Lax, path=/, secure selon le schéma réel
Expiration SESSION_TTL_HOURS (336 h) ; revoked_at, is_active, deleted_at vérifiés à chaque résolution
Révocation logout, purge au démarrage, toutes les autres sessions au changement de mot de passe, gestion des sessions ouvertes depuis le compte
Anti-énumération hash factice pour une adresse inconnue ; les flux « mot de passe oublié » répondent toujours { ok: true } sans révéler l'existence du compte
Jetons à usage unique réinitialisation de mot de passe et changement d'adresse stockés hachés, avec expiration
Changement d'adresse mot de passe actuel exigé, confirmation à la nouvelle adresse avant application

Limitation de débit

  • Applicatif : createRateLimiter (backend/src/lib/ratelimit.ts) par IP sur auth/login, account/forgot-password, account/reset-password, account/email-change. Réglages RATE_LIMIT_LOGIN_MAX (10) et RATE_LIMIT_LOGIN_WINDOW_MS (60 s).
  • Edge nginx : zones limit_req login (15 r/min, burst 5) et api (60 r/s, burst élevé) — voir docker/nginx/cloud.conf.

Droits d'accès

Calculés en base à chaque requête, depuis la session — jamais depuis un en-tête (backend/src/access.ts). Lecture : propriétaire, permission folder_permissions (read/write/admin), ou dossier public. Écriture : write/admin. 404 plutôt que 403 : jamais d'indice sur l'existence d'une ressource.

Courriel

Nodemailer (backend/src/lib/mail.ts) avec SMTP_HOST. PUBLIC_ORIGIN (obligatoire) construit les liens de réinitialisation et de confirmation ; aucun HTML utilisateur n'est injecté dans les messages.

Transport et enveloppe

  • En-têtes API : x-request-id, nosniff, referrer-policy: same-origin.
  • En-têtes nginx (docker/nginx/snippets/security-headers.conf) : Content-Security-Policy (default-src 'self', frame-ancestors 'none', pas de unsafe-inline), Strict-Transport-Security, X-Content-Type-Options, Referrer-Policy, Permissions-Policy.
  • SQL : requêtes préparées uniquement, multipleStatements: false.
  • CORS désactivé par défaut (CLOUD_CORS_ORIGIN vide).

Le script d'amorçage du thème est sorti de index.html vers public/theme.js exprès : la CSP n'autorise pas unsafe-inline.

Stockage des fichiers

  • Chemin physique dérivé du slug + UUID, jamais du nom affiché ; resolveInside() rejette toute cible hors MEDIA_DIR.
  • Écriture temporaire .upload-<uuid> puis rename() atomique ; copie en flux (un fichier surdimensionné est coupé, pas bufferisé).
  • Téléchargement : content-disposition: attachment, nosniff, cache-control: private, max-age=0, must-revalidate.

Hors périmètre (assumé)

Sujet État
CSRF pas de jeton CSRF — reposé sur SameSite=Lax + same-origin ; acceptable tant que le front et l'API partagent l'origine
HTTPS nginx écoute le 80 ; le terminus TLS est le tunnel cloudflared, hors dépôt
Chiffrement au repos fichiers en clair ; seuls mots de passe, sessions et jetons sont dérivés
Détection antivirus aucune analyse des fichiers envoyés

À ne pas faire

  • Ne jamais renvoyer de stack ou de détail de schéma au client.
  • Ne jamais ajouter de route qui prend un chemin disque en paramètre : passer par storage.ts.
  • Ne jamais persister le jeton de session en clair, ni logger un mot de passe.
  • Ne pas réintroduire de script inline dans index.html (casserait la CSP).