Sécurité — Chat SPBoucher AI 0.3
Application 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.
Authentification
| Élément | Choix | Où |
|---|---|---|
| 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 |
| Bibliothèque | @simplewebauthn/server 14.1 (Node ≥ 22) et @simplewebauthn/browser 14.0 — aucune cryptographie maison |
package.json |
| 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 |
| 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 |
| 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 |
| 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/* |
| 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 |
Sessions
- 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). - 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.
- Expiration glissante 30 jours, absolue 90 jours. Révocation par appareil, globale, ou automatique (récupération, révocation de la passkey associée).
/lockrévoque en base : l'ancien cookie est inutilisable immédiatement. - Opérations sensibles : passkey vérifiée depuis moins de 10 minutes (
guarded(fn, { recentAuth: true })).
Initialisation et récupération
| Chemin | Qui | Garde-fous |
|---|---|---|
| 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 |
| 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 |
| Récupération administrateur | SSH : pnpm auth bootstrap --recover |
explicite, journalisée, ferme toutes les sessions à l'usage |
| 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 |
Il n'existe aucun repli automatique vers un mot de passe, un NIP ou un lien permanent.
Requêtes
- CSRF : toute mutation exige un en-tête
Originappartenant àAUTH_ORIGINS(ouSec-Fetch-Site: same-originen son absence) ; cookieSameSite=Laxet préfixe__Host-. - Autorisation :
src/proxy.tsbloque tout sans session ; chaque route privée revérifie la session (guarded). Les Server Actions ne sont pas utilisées. - 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).
- 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. - 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-storesur tout contenu privé. Une CSPscript-srcstricte n'est pas appliquée à l'application : les aperçus d'artefacts (iframe srcdocen 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 avecContent-Security-Policy: sandbox).
Fichiers et contenus hostiles
- Type vérifié sur les octets réels (
src/lib/files.ts) ; extension et type annoncé ignorés ; quota global ; chemins résolus sousDATA_DIR/uploadsuniquement. - Fichiers servis avec
nosniff,Content-Security-Policy: sandbox, texte forcé entext/plain. - Un fichier n'est joignable qu'à sa conversation ou aux conversations de son projet ;
search_documentsa la même portée. - 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-execsans réseau, 20 s, répertoire jetable ;fetch_pagerefuse les adresses privées. - Artefacts :
iframe sandbox="allow-scripts"sans origine partagée, donc sans accès aux cookies ni à l'API.
Journaux
Lignes 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).
Limites connues
- 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.
- Les sauvegardes nocturnes (14 jours) contiennent encore les données supprimées entre-temps.
.env.productionavait été commité le 2026-11-01 : les clés de cette époque restent dans l'historique git et devraient être remplacées.