SPB Git

Repository Public

SECURITY.md 6.4 KB

# 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). /lock ré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 Origin appartenant à AUTH_ORIGINS (ou Sec-Fetch-Site: same-origin en son absence) ; cookie SameSite=Lax et préfixe __Host-.
  • 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.
  • 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-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).

# 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 sous DATA_DIR/uploads uniquement.
  • Fichiers servis avec nosniff, Content-Security-Policy: sandbox, texte forcé en text/plain.
  • Un fichier n'est joignable qu'à sa conversation ou aux conversations de son projet ; search_documents a 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-exec sans réseau, 20 s, répertoire jetable ; fetch_page refuse 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.production avait été commité le 2026-11-01 : les clés de cette époque restent dans l'historique git et devraient être remplacées.
Files main
Menu

Theme