Files
CoHaiSe-CLOUD/docs/security.md
T
Esiah 6fed804a02 feat(chat,files): edit messages, pin several of them, drag-and-drop upload
Chat messages can now be rewritten by their author only, at any time, with a
"(edited)" marker whose tooltip carries the full date and time down to the
second. The edit is enforced by the SQL filter on user_id, so a message of
someone else answers 404, exactly like a message that does not exist.

Several messages can be pinned at once in the same chat room. Pinning is open
to every member of the room: it is a reading convenience, not a way to take
over someone else's content. A dedicated GET on /chat/pins is required because
the id cursor only reports recent messages, and pinning an old one would
otherwise stay invisible.

The message list is synchronised with two cursors: the id one for new
messages, a timestamp one for rewrites. The server computes that timestamp
before running the query and returns it as-is, in the very frame used by
edited_at, so the client never converts it and cannot drift by a timezone
offset.

Files can now be dropped on the current folder or on any sub-folder card. The
drop zone only reacts to file drags, and the pointer moving from a child
element to another no longer makes the overlay flicker.

A deleted message leaves the pinned list, and its physical file is removed
from the disk as before.
2026-10-22 10:11:39 +02:00

104 lines
5.2 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, **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.
### 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).
## 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).