PR — Ouverture automatique / create-pr (push) Successful in 3s
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.
115 lines
6.0 KiB
Markdown
115 lines
6.0 KiB
Markdown
# 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).
|