Repository Public
1# SP CLIP AI — Sécurité23Document rédigé le 2026-11-19. Il décrit ce que le code fait réellement ; les limites connues sont en dernière section.4Code de référence : `src/lib/auth.ts`, `src/lib/webauthn.ts`, `src/app/api/auth/*`, `scripts/invite.ts`, tests `tests/auth.test.ts`.56## 1. Modèle de menace (bref)78| Actif | Menace | Mesure principale |9|---|---|---|10| Zone `/admin` et API `/api/admin/*` (publication, médiathèque, droits) | Vol d'identifiants, hameçonnage, bourrage d'identifiants | Passkeys WebAuthn seulement (aucun mot de passe), liées au domaine, vérification utilisateur exigée |11| Session d'un administrateur | Vol de cookie, CSRF, session oubliée sur un poste | Cookie `HttpOnly` + `SameSite=Strict` (+ `Secure`, préfixe `__Host-` en production), contrôle de l'en-tête `Origin`, expiration (12 h d'inactivité, 7 j), révocation |12| Création de comptes | Auto-inscription, invitation interceptée | Aucune inscription publique ; invitation à usage unique créée en terminal, courte durée |13| Actions sensibles (passkeys, publication…) | Poste déverrouillé laissé sans surveillance | Réauthentification récente (moins de 10 min) |14| Médias non publiés | Accès direct par URL | URL signées HMAC expirantes |15| Secrets (clés de fournisseurs, `APP_SECRET`) | Fuite dans le navigateur, la base ou les journaux | Variables d'environnement côté serveur, masquage dans les journaux |1617Hors périmètre : compromission du nœud qui héberge l'application ou de la base PostgreSQL (un attaquant qui écrit dans la base peut créer une invitation ou une session), compromission du compte du fournisseur de passkeys de l'utilisateur (trousseau iCloud, Google), logiciel malveillant sur le poste de l'administrateur.1819## 2. WebAuthn (passkeys)2021Bibliothèque : `@simplewebauthn/server` (serveur) et `@simplewebauthn/browser` (client).2223- **RP ID** = `WEBAUTHN_RP_ID` ou, à défaut, le nom d'hôte de `PUBLIC_URL` ; **origine attendue** = origine exacte de `PUBLIC_URL`. Une assertion produite pour un autre domaine ou une autre origine est refusée.24- **Vérification utilisateur exigée** (`userVerification: "required"`) à l'enregistrement, à la connexion et à la réauthentification ; le drapeau UV est contrôlé côté serveur.25- **Clé résidente exigée** (`residentKey: "required"`) : la connexion se fait sans saisir d'identifiant (`allowCredentials` vide), l'authentificateur propose ses passkeys du domaine.26- **Attestation `none`** : le serveur ne cherche pas à identifier le modèle d'authentificateur.27- **Challenges** : valeur aléatoire générée par le serveur, stockée dans `webauthn_challenges` avec son usage (`register`, `login`, `reauth`), l'utilisateur ou l'invitation concernés et une expiration de 5 minutes. À la vérification, le challenge signé est consommé par une mise à jour atomique (`used_at`) : il ne sert qu'une fois, même si la vérification échoue ensuite. Un challenge n'est accepté que pour l'usage, l'utilisateur et l'invitation pour lesquels il a été émis.28- **Compteur de signature** : mis à jour à chaque usage. Si le compteur stocké est supérieur à 0 et que la valeur reçue ne progresse pas, la connexion est refusée et un événement `counter_anomaly` est journalisé (`login_events` et `audit_logs`) : c'est l'indice d'un justificatif cloné. Les passkeys synchronisées gardent un compteur à 0, ce qui est accepté.29- **Doublons** : à l'ajout, `excludeCredentials` contient les passkeys déjà enregistrées du compte ; l'identifiant de justificatif est unique en base.3031### Ce que le serveur stocke3233Table `passkeys` : identifiant du justificatif, **clé publique** (COSE), **compteur**, transports, type (liée à l'appareil ou synchronisée), état de sauvegarde, AAGUID, libellé choisi par l'utilisateur, dates.3435Le serveur ne reçoit et ne stocke **jamais** d'empreinte digitale, d'image de visage, de code de l'appareil ni de clé privée. Touch ID et Face ID sont vérifiés par l'appareil ; le serveur ne voit qu'une signature cryptographique et le drapeau « utilisateur vérifié ».3637## 3. Enrôlement et récupération3839Il n'y a **aucune auto-inscription** : sans invitation valide ni session, `POST /api/auth/passkey/register/*` répond 403.4041```42tsx scripts/invite.ts --email x@exemple.ca --name "Nom" --role owner|editor|reviewer [--ttl 30] [--force]43tsx scripts/invite.ts --email x@exemple.ca --recovery # nouvelle passkey pour un compte existant44tsx scripts/invite.ts --list45tsx scripts/invite.ts --revoke-sessions x@exemple.ca46```4748- Le jeton d'invitation (32 octets aléatoires) n'apparaît qu'une fois, dans l'URL `/admin/enroll?token=…` affichée par le script ; la base ne garde que son SHA-256. Durée par défaut : 30 minutes. Usage unique, garanti par une mise à jour atomique dans la même transaction que la création du compte.49- `enroll` crée l'utilisateur et sa première passkey. Le script refuse d'inviter un second propriétaire si un propriétaire existe déjà, sauf `--force`.50- `recovery` (appareil perdu) ajoute une passkey à un compte existant et **révoque toutes ses sessions**. Les anciennes passkeys restent : supprimer celle de l'appareil perdu dans Compte.51- La page d'enrôlement retire le jeton de la barre d'adresse dès son affichage.52- Recommandation d'exploitation : chaque administrateur enregistre au moins deux passkeys, dont une clé de sécurité matérielle FIDO2 de secours (page Compte). La dernière passkey d'un compte ne peut pas être supprimée.5354L'accès au terminal du nœud est donc la racine de confiance de l'enrôlement et de la récupération.5556## 4. Sessions5758- Jeton aléatoire de 32 octets, remis dans le cookie `__Host-clip_session` en production (`clip_session` en développement) : `HttpOnly`, `SameSite=Strict`, `Path=/`, `Secure` en production. La base ne garde que le SHA-256 du jeton (`sessions.token_hash`) : une fuite de la base ne donne pas de session utilisable.59- Expiration : 12 heures d'inactivité (`last_seen_at`) et 7 jours au plus après la connexion (`expires_at`), vérifiées côté serveur à chaque requête.60- Rotation : chaque connexion crée une nouvelle session ; celle que le navigateur présentait est révoquée.61- Révocation (`revoked_at`) : déconnexion, révocation d'une session ou de toutes les autres depuis Compte, récupération de compte, suppression de la passkey qui a ouvert la session, `--revoke-sessions` en terminal. Un compte désactivé (`users.disabled`) perd l'accès immédiatement.62- Dans l'interface et l'API, une session est désignée par les 16 premiers caractères hexadécimaux de son hash : cet identifiant ne permet pas de l'utiliser.63- Journal : `login_events` (`login_ok`, `login_fail`, `register`, `reauth`, `logout`, `revoke`, `counter_anomaly`) avec l'adresse IP **hachée** (HMAC avec `APP_SECRET`) et l'agent utilisateur, jamais l'adresse brute. La page Compte montre à chacun son historique.6465## 5. Rôles (RBAC)6667`reviewer < editor < owner`. `requireUser(min)` protège les pages serveur (redirection vers `/admin/login`, ou `/admin?denied=1` si le rôle est insuffisant) ; `apiUser(req, min)` protège les routes (401 ou 403 en JSON). Le rôle est lu en base à chaque requête : un changement de rôle s'applique tout de suite. Les actions sensibles sont consignées dans `audit_logs`.6869## 6. Réauthentification7071Les routes déclarées avec `recentAuth: true` exigent une vérification utilisateur par passkey de moins de 10 minutes (`sessions.reauth_at`), sinon 403 `{"error":"reauth_required"}`. Le client lance alors `POST /api/auth/passkey/reauth/options` puis `/verify` (helper `ensureRecentAuth()` de `src/components/admin/reauth.ts`) et rejoue la requête. La réauthentification n'accepte qu'une passkey du compte connecté. Elle est exigée pour ajouter, renommer ou supprimer une passkey.7273## 7. CSRF et CSP7475- **CSRF** : cookie `SameSite=Strict`, et pour toute méthode autre que GET/HEAD l'en-tête `Origin` doit être exactement l'origine de `PUBLIC_URL` ; une requête mutante sans `Origin` est refusée (403 `bad_origin`). Les routes GET ne modifient rien.76- **En-têtes** (`next.config.ts`) : `Content-Security-Policy` (`default-src 'self'`, `frame-ancestors 'none'`, `object-src 'none'`, `base-uri 'self'`, `form-action 'self'`, `connect-src 'self'`), `X-Frame-Options: DENY`, `X-Content-Type-Options: nosniff`, `Referrer-Policy`, `Strict-Transport-Security`, `Permissions-Policy`.77- La zone admin est marquée `noindex, nofollow`.78- **Limites de débit** par IP hachée sur les routes de cérémonie : 20 demandes d'options et 10 vérifications par minute et par type de cérémonie (429 au-delà).7980## 8. Téléversements8182Les téléversements sont réservés aux utilisateurs connectés (rôle vérifié par `apiUser`). Chaque fichier est analysé par `ffprobe` avant d'être accepté comme média ; il est stocké sous un nom dérivé de son contenu (SHA-256), jamais sous le nom fourni par le client, hors de l'arborescence servie par le serveur web. Un média n'entre dans une production que si sa licence a été approuvée. Le détail (tailles, types acceptés) relève du module médiathèque.8384## 9. URL signées8586Tout fichier non publié est servi par `/media/f/<id>?exp=…&sig=…` : signature HMAC-SHA-256 de l'identifiant et de l'échéance avec `APP_SECRET`, comparée en temps constant, expirante (6 heures par défaut). Seuls les artefacts d'une publication à l'état `published` sont servis sans signature, sous `/media/p/<slug>/…`.8788## 10. Secrets8990- Les secrets (`APP_SECRET`, `DATABASE_URL`, clés des fournisseurs) sont des variables d'environnement du serveur et du worker (`.env` en mode 600, jamais commité). `src/lib/env.ts` ne doit jamais être importé par un composant client.91- La table `secrets_references` ne contient que le **nom** de la variable d'environnement, jamais la valeur.92- Rien de secret n'est envoyé au navigateur : ni clés de fournisseurs, ni jetons de session lisibles par JavaScript, ni hash de session complet.93- Journaux (`src/lib/log.ts`) : les champs dont le nom évoque un secret (`token`, `secret`, `api_key`, `authorization`, `password`) et les motifs de clés connus sont masqués. Les jetons d'invitation et de session ne sont jamais journalisés.94- `scripts/secrets-scan.ts` vérifie qu'aucun secret n'est présent dans le dépôt.95- Changer `APP_SECRET` invalide les URL signées en circulation et les invitations d'enrôlement dont la cérémonie est en cours ; les sessions restent valides (elles ne dépendent pas de ce secret).9697## 11. Limites connues9899- **CSP** : `script-src` et `style-src` autorisent `'unsafe-inline'` (pas de nonce) ; la protection contre l'injection de script repose d'abord sur l'échappement de React.100- **Adresse IP** : l'application prend la dernière valeur de `X-Forwarded-For`, celle ajoutée par le proxy Caddy. Si l'application était exposée sans ce proxy, l'en-tête serait contrôlé par le client et les limites de débit par IP seraient contournables. Les limites de débit utilisent des fenêtres fixes d'une minute.101- **Attestation `none`** : le serveur ne peut pas imposer un modèle d'authentificateur ni prouver qu'une clé est matérielle ; le bouton « clé de sécurité » n'est qu'une indication donnée au navigateur.102- **Passkeys synchronisées** : leur sécurité dépend du compte du fournisseur (trousseau iCloud, Google). Leur compteur reste à 0 : le clonage n'est détectable que pour les clés liées à un appareil.103- **Récupération** : elle n'enlève pas les anciennes passkeys ; c'est à l'utilisateur de supprimer celle de l'appareil perdu.104- **Invitation** : le lien contient le jeton ; il peut rester dans l'historique du terminal ou du navigateur jusqu'à son expiration ou son usage. Le transmettre par un canal sûr.105- **Réauthentification automatique** : certains navigateurs exigent un geste de l'utilisateur pour ouvrir une passkey ; si la cérémonie lancée après une réponse 403 est bloquée, l'interface propose un bouton « Confirmer mon identité ».106- **Pas de verrouillage de compte** après des échecs répétés (seulement des limites de débit) et pas d'alerte automatique sur `counter_anomaly` : l'événement est journalisé, à surveiller dans Audit.107- **Gestion des utilisateurs** (changement de rôle, désactivation) : pas d'interface, opération en base.108- Les cérémonies sont testées de bout en bout avec un authentificateur logiciel (`tests/auth.test.ts`) ; la validation sur de vrais appareils (Touch ID, Face ID, clé FIDO2) reste à faire après déploiement.109110## 12. Code d'animation généré par les agents (moteur v3)111112Les agents écrivent du code (HTML, CSS, JavaScript, TypeScript, SVG, Python). Ce code est **non fiable** et n'est jamais exécuté librement sur l'hôte.113114| Code | Où il s'exécute | Ce qui l'enferme |115|---|---|---|116| Scène (HTML / CSS / JS) | page Chromium sans tête, contexte jetable | CSP `default-src 'none'` (scripts et styles en ligne + kit seulement, `connect-src 'none'`), toute requête interceptée (seuls le document et `https://scene.clip/kit/*` répondent, noms de fichiers filtrés), WebSocket fermés, service workers, téléchargements, fenêtres et navigation refusés, pas d'`eval`, 400 ko au plus, délai par opération, 20 000 minuteries au plus par image |117| TypeScript d'une scène | transpilé par `esbuild.transform` (retrait des types) | aucune exécution côté serveur : seul le JavaScript produit entre dans la page ci-dessus |118| Symboles SVG de la distribution | planche du kit, dans la page | validés (`castProblems`) puis filtrés à l'injection : `<symbol>` seulement, sans `<script>`, gestionnaire d'événement ni référence externe |119| Voix, données, thème injectés dans la page | `window.__SCENE` | sérialisés avec échappement de `<` (un mot de la narration ne peut pas refermer la balise script) |120| Python (calcul ou rendu matplotlib) | processus enfant sous `sandbox-exec` | profil Seatbelt `deny default` : aucun réseau, aucun `fork` / `exec`, écriture dans un seul dossier jetable, lecture limitée à Python, au venv figé et aux polices système ; environnement reconstruit de zéro (aucune variable du worker : aucune clé d'API) ; `RLIMIT_CPU`, `RLIMIT_FSIZE`, `RLIMIT_NOFILE`, `RLIMIT_NPROC = 0`, plafond de mémoire, délai mural avec `SIGKILL` du groupe ; sortie revérifiée (taille, forme, pas de lien symbolique) |121| Aperçu interactif du studio | `<iframe sandbox="allow-scripts">` | origine opaque : ni cookies, ni API d'administration |122123Vérifié par `tests/pysandbox.test.ts` (36 tests, exécution réelle) : avec les gardes Python **désactivées**, le noyau seul refuse TCP (v4, v6), UDP, DNS,124sockets Unix, lecture de `~/.ssh`, du trousseau et du `.env` du dépôt, écriture hors du dossier jetable, `subprocess`, `os.system`, `fork`, `posix_spawn`,125`ctypes`, `osascript`, signaux vers d'autres processus ; bombes mémoire, disque et `fork` bornées ; une fausse `ANTHROPIC_API_KEY` posée dans le worker126n'est pas visible du code.127128Risques résiduels, à connaître :129- Les gardes au niveau Python (liste de modules, contrôle statique) sont **contournables** : c'est une défense en profondeur. La frontière est le noyau (Seatbelt + rlimits). Une faille de Seatbelt, du noyau ou une corruption mémoire dans numpy / scipy / Pillow resterait dans le bac à sable.130- `sandbox-exec` est déprécié par Apple. S'il disparaît, le moteur **refuse d'exécuter** (`no_sandbox`) ; il ne se dégrade pas en silence. `CLIP_PYSANDBOX_UNSAFE=1` (développement) ne doit jamais être posé en production.131- Fuites d'information mineures dans le bac à sable : nom d'hôte, nom d'utilisateur (visible dans les chemins), PID parent, noms de premier niveau de `/`. Sans réseau, la seule sortie est le résultat rendu.132- Le plafond de mémoire porte sur la croissance de mémoire virtuelle, pas sur la mémoire résidente ; un chien de garde externe (250 ms) complète, avec un dépassement possible entre deux mesures.133- Le profil a été mesuré sur macOS 27.0 (poste de développement) ; il doit être revérifié sur chaque nœud de production (`vitest run tests/pysandbox.test.ts`).134- `will-change` est refusé dans les scènes : il ne pose pas de risque de sécurité mais rend le rendu non reproductible.135