CD — Deployment / deploy (push) Successful in 33s
PR automatique de feat/ui-glass-layout-icons vers main. --------- Co-authored-by: xEsiah <[email protected]> Reviewed-on: #21 Reviewed-by: Esiah <[email protected]> Co-authored-by: Gitea Actions <-[email protected]>
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/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`.
|
|
|
|
### 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/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.
|
|
|
|
### 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/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`.
|
|
- 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).
|