Files
CoHaiSe-CLOUD/docs/security.md
T
Esiah cc397e96d8
PR — Ouverture automatique / create-pr (push) Failing after 1s
chore: initial import of CoHaiSe Cloud
Standalone files & media application: React/Vite frontend with the @cohaise/ui design system, Hono + MariaDB backend, nginx reverse proxy, Docker Compose stack, migrations 000-006, and project docs.

Adds Gitea Actions workflows for deployment, automatic pull requests, and Renovate dependency updates.
2026-10-14 15:24:06 +02:00

79 lines
3.9 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/shared/src/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/cloud/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/shared/src/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).