Repository Public
1# Sécurité — Chat SPBoucher AI 0.323Application mono-propriétaire. Menace principale : un tiers qui atteint `chat.spboucher.ai` (nom public par les journaux de transparence de certificats) et tente d'ouvrir une session, ou qui fait exécuter une action au navigateur du propriétaire.45## Authentification67| Élément | Choix | Où |8|---|---|---|9| Facteur | Passkey WebAuthn, identifiants découvrables, `userVerification: "required"` à l'enregistrement **et** à chaque connexion, vérifié côté serveur (`requireUserVerification: true`) | `src/lib/auth/webauthn.ts` |10| Bibliothèque | `@simplewebauthn/server` 14.1 (Node ≥ 22) et `@simplewebauthn/browser` 14.0 — aucune cryptographie maison | `package.json` |11| Ce que le serveur stocke | identifiant de la clé, **clé publique**, compteur, transports, libellé. Aucune donnée biométrique n'existe côté serveur : la vérification est faite par l'appareil | table `webauthn_credentials` |12| Défi | 32 octets aléatoires, stocké côté serveur, lié au type de cérémonie et à son but, valable 5 minutes, **consommé une seule fois** par `UPDATE … WHERE consumed_at IS NULL RETURNING` ; son identifiant voyage dans un cookie HttpOnly SameSite=Strict | table `auth_challenges` |13| Origine / RP | origine exacte (`AUTH_ORIGINS`) et RP id exact (`AUTH_RP_ID`) vérifiés à chaque cérémonie ; type `webauthn.get` / `webauthn.create` imposé | `webauthn.ts` |14| Réponses | identiques que des passkeys existent ou non (`allowCredentials` vide à la connexion) ; tout échec → `401 « Vérification refusée. »` avec délai aléatoire | `/api/auth/login/*` |15| Ce que le site ne peut pas imposer | le système choisit entre biométrie et code de déverrouillage de l'appareil ; l'interface le dit. Un NIP saisi **dans** l'application n'existe pas | `src/components/auth/shared.tsx` |1617## Sessions1819- Jeton aléatoire de 256 bits dans le cookie `__Host-csa_session` (HttpOnly, Secure, SameSite=Lax, Path=/, sans Domain) ; la base ne contient que son SHA-256 (`sessions.id`).20- Nouvelle session à chaque connexion (l'éventuelle session précédente du navigateur est révoquée : pas de fixation) ; **rotation du jeton** après chaque vérification de passkey.21- Expiration glissante 30 jours, absolue 90 jours. Révocation par appareil, globale, ou automatique (récupération, révocation de la passkey associée). `/lock` révoque en base : l'ancien cookie est inutilisable immédiatement.22- Opérations sensibles : passkey vérifiée depuis moins de 10 minutes (`guarded(fn, { recentAuth: true })`).2324## Initialisation et récupération2526| Chemin | Qui | Garde-fous |27|---|---|---|28| Bootstrap | administrateur, en SSH sur le nœud : `pnpm auth bootstrap` | code de 100 bits affiché une fois, haché en base, 15 minutes, usage unique, refusé dès qu'une passkey existe, brûlé après 10 essais faux |29| Codes de récupération | propriétaire connecté (passkey récente) ou CLI | 8 codes de 100 bits, hachés, usage unique, rotation par lot ; un code n'ouvre qu'une fenêtre d'enrôlement de 10 minutes ; son usage ferme toutes les sessions |30| Récupération administrateur | SSH : `pnpm auth bootstrap --recover` | explicite, journalisée, ferme toutes les sessions à l'usage |31| Transition 0.2 → 0.3 | appareil détenant encore l'ancien cookie | seulement si `AUTH_TRANSITION_UNTIL` est dans le futur, que la migration 003 a moins de 7 jours et qu'aucune passkey n'existe ; sert une seule fois à créer la première passkey, n'ouvre jamais l'application, se ferme seule |3233Il n'existe **aucun** repli automatique vers un mot de passe, un NIP ou un lien permanent.3435## Requêtes3637- **CSRF** : toute mutation exige un en-tête `Origin` appartenant à `AUTH_ORIGINS` (ou `Sec-Fetch-Site: same-origin` en son absence) ; cookie `SameSite=Lax` et préfixe `__Host-`.38- **Autorisation** : `src/proxy.ts` bloque tout sans session ; chaque route privée revérifie la session (`guarded`). Les Server Actions ne sont pas utilisées.39- **Validation** : schémas Zod sur chaque corps ; taille plafonnée avant lecture (1 Mio par défaut, 64 Kio pour l'authentification, limite dédiée pour les fichiers) ; erreurs 5xx sans détail interne (référence de requête).40- **Limitation de débit** : compteurs en base (`rate_limits`), partagés et persistants : cérémonies 20/min/IP et 120/min au total ; codes 5/15 min/IP et 30/h au total.41- **En-têtes** : `X-Frame-Options: DENY`, `frame-ancestors 'none'`, `nosniff`, `Referrer-Policy`, `Permissions-Policy` (WebAuthn et micro pour l'origine seule), HSTS, `Cache-Control: private, no-store` sur tout contenu privé. Une CSP `script-src` stricte n'est pas appliquée à l'application : les aperçus d'artefacts (`iframe srcdoc` en bac à sable) hériteraient de cette politique et cesseraient de fonctionner ; la surface est réduite autrement (pas de HTML de modèle injecté hors Markdown assaini, fichiers servis avec `Content-Security-Policy: sandbox`).4243## Fichiers et contenus hostiles4445- Type vérifié sur les **octets réels** (`src/lib/files.ts`) ; extension et type annoncé ignorés ; quota global ; chemins résolus sous `DATA_DIR/uploads` uniquement.46- Fichiers servis avec `nosniff`, `Content-Security-Policy: sandbox`, texte forcé en `text/plain`.47- Un fichier n'est joignable qu'à sa conversation ou aux conversations de son projet ; `search_documents` a la même portée.48- Pages web, documents et résultats d'outils sont présentés aux modèles comme des **données** ; l'outil Python tourne sous `sandbox-exec` sans réseau, 20 s, répertoire jetable ; `fetch_page` refuse les adresses privées.49- Artefacts : `iframe sandbox="allow-scripts"` sans origine partagée, donc sans accès aux cookies ni à l'API.5051## Journaux5253Lignes JSON (`pm2 logs`) avec identifiants de corrélation (`rid`, `run`, `conv`, `msg`). Jamais : texte de message, prompt, entrées/sorties d'outils, noms de fichiers, assertion WebAuthn, cookie, clé. Journal de sécurité : table `auth_events` (Réglages → Sécurité, ou `pnpm auth events`).5455## Limites connues5657- Limiteur de concurrence, disjoncteur et registre des générations sont en mémoire du processus : corrects pour l'instance unique PM2 ; à déplacer en base avant de passer à plusieurs instances.58- Les sauvegardes nocturnes (14 jours) contiennent encore les données supprimées entre-temps.59- `.env.production` avait été commité le 2026-11-01 : les clés de cette époque restent dans l'historique git et devraient être remplacées.60