Files
CoHaiSe-CLOUD/docs/security.md
T
Esiah 68d4d5dea0
PR — Ouverture automatique / create-pr (push) Successful in 3s
refactor: restructure frontend and backend by domain services
Split the monolithic backend (lib/, routes/, access.ts, storage.ts, media.ts)
into a layered structure inspired by JeanXXIII-CRM:
- config/: appConfig, db
- middleware/: auth (session, roles, cookies)
- models/: shared types
- routes/: *Routes.ts (thin HTTP handlers)
- services/: *Service.ts (business logic, one per domain)
- utils/: errors, http, migrate, ratelimit, validators, service bootstrap

Frontend likewise: services/*Service.ts + apiClient, contexts/, types/, utils/format.
Route files now carry the "Routes" suffix; service files are named
authService.ts, ratelimit.ts, etc. and live in their own files, frontend and
backend separated.

Updated docs and READMEs to reflect the new layout. Typecheck and builds pass.
2026-11-13 09:45:21 +01:00

6.0 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, HMAC-SHA-256 poivré par SESSION_SECRET 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 et toutes les heures, toutes les autres sessions au changement de mot de passe, gestion des sessions ouvertes depuis le compte
Changement imposé must_change_password vérifié dans requireAuth : seules auth/me, auth/change-password et auth/logout restent accessibles, la redirection du front n'est qu'un confort
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/utils/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.

Limites d'entrée

  • Les corps JSON passent par readJson : 1 Mio maximum, lecture bornée même si content-length ment (le flux est coupé au-delà).
  • L'avatar passe par readBodyCapped : 8 Mio maximum, même garantie.
  • Les envois de fichiers ont leur propre flux borné (storage.ts), indépendant de client_max_body_size de nginx.

Droits d'accès

Calculés en base à chaque requête, depuis la session — jamais depuis un en-tête (backend/src/services/auditService.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.

Discussion

Le salon d'un dossier est ouvert à qui a accès au dossier (canRead). L'accès en lecture et l'envoi de messages se distinguent de l'édition :

  • l'édition d'un message (PATCH .../chat/messages/:id) est réservée à son auteur, sans limite de temps. Le filtre user_id est porté par la requête SQL : un message d'autrui répond 404, comme un message inexistant, sans rien laisser deviner. Le gestionnaire du dossier peut supprimer un message mais pas le réécrire à la place de son auteur ;
  • l'épinglage (PUT .../chat/messages/:id/pin) est ouvert à tout membre du salon : c'est une mise de côté de lecture, pas une prise de contrôle du contenu ;
  • la suppression est un soft-delete (deleted_at), un message retiré quitte aussi les épingles ;
  • edited_at est posé par le serveur, jamais reçu du client : un client ne peut pas dater sa propre modification.

Chaque écriture dans le salon passe par le limiteur de débit (20 requêtes d'écriture par compte sur 10 s), édition et épinglage compris.

Courriel

Nodemailer (backend/src/services/mailService.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.
  • Aperçu en ligne : même contrôle d'accès que le téléchargement, inline sur une liste blanche de types (image/* hors image/svg+xml, video/*, audio/*, application/pdf, text/plain) — jamais de HTML/SVG qui s'exécuterait dans l'origine. Les deux routes gèrent Range (206 / 416).
  • Vignettes : le SVG est aussi exclu du passage à sharp/librsvg ; il reste téléchargeable, mais n'est jamais décodé côté serveur.

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