Repository Public
1# Sécurité23## Clés d'accès (WebAuthn)45- **RP ID** : `music.spboucher.ai` (hôte de `APP_URL` ; `WEBAUTHN_RP_ID` permet un domaine parent). **Origine attendue** : `https://music.spboucher.ai`, comparée à l'identique. Le développement utilise `http://localhost:8690` (RP ID `localhost`), dans une base distincte.6- **Vérifié côté serveur à chaque opération** : challenge à usage unique (la ligne est supprimée à sa lecture, 5 minutes de validité), signature, origine, RP ID, présence **et vérification** de l'utilisateur (`userVerification: required`, `requireUserVerification: true`), compteur.7- **Stocké** : identifiant de la clé, clé publique, compteur, transports, type d'appareil, indicateur de synchronisation, nom, dates de création et de dernière utilisation. **Jamais** de clé privée ni de donnée biométrique : Face ID et Touch ID restent sur l'appareil, le site ne reçoit qu'une signature.8- Plusieurs clés par compte, renommables et révocables (`/compte`). La dernière clé ne peut pas être retirée depuis l'interface.9- Clés découvrables : la connexion n'envoie aucune liste de comptes ; une clé inconnue et une signature fausse produisent la même réponse.1011### Si le site est ouvert autrement1213| Adresse | Effet |14|---|---|15| `http://music.spboucher.ai` | redirigé en HTTPS par Caddy |16| adresse IP, `nœud:8690`, autre sous-domaine | pas de contexte sûr ou RP ID différent : le navigateur refuse WebAuthn ; la page de connexion l'explique ; aucune clé ne peut être créée ni utilisée |17| `http://localhost:8690` | développement seulement (contexte sûr par exception) |1819## Création du propriétaire, comptes, récupération2021- `scripts/bootstrap.ts` crée l'unique compte propriétaire depuis `OWNER_EMAIL` et, **tant qu'il n'a aucune clé d'accès**, écrit un lien d'inscription à usage unique (24 h) dans `SETUP_URL_FILE` (mode 0600) — jamais dans un journal. Dès qu'une clé existe, plus aucun lien n'est émis : le mode d'installation est fermé. Il n'y a ni `admin/admin`, ni mot de passe, ni secret par défaut.22- Seul le SHA-256 des jetons est en base ; le jeton voyage dans le fragment d'URL (`#…`), qui n'apparaît ni dans les requêtes, ni dans les journaux du proxy, ni dans `Referer`.23- **Aucune inscription publique.** Un compte n'existe que parce qu'un administrateur l'a créé (`/admin` → Comptes) ; il reçoit un lien d'inscription à usage unique, affiché une seule fois (72 h).24- **Récupération** : (1) huit codes à usage unique, affichés une fois à la première clé, stockés hachés ; (2) pour le propriétaire, depuis le shell du nœud : `tsx scripts/setup-token.ts [--recovery]` ; `--recovery` remplace toutes les clés et ferme toutes les sessions ; (3) pour les autres comptes, un nouveau lien émis par un administrateur. Il n'existe aucune autre voie.2526## Association d'appareil (applications natives)2728L'application affiche un code court (`XXXX-XXXX`, 10 minutes) et ouvre `/appareil?code=…` ; un navigateur **déjà connecté29par clé d'accès** l'approuve (session + jeton CSRF + origine exigés) ; l'application, qui interroge `device/poll` avec30son propre secret (seul son SHA-256 est en base), reçoit alors **sa propre session** (méthode `device`, 90 jours),31visible et révocable dans « Compte ». Une association ne sert qu'une fois ; refusée, expirée ou inconnue, elle ne donne32rien. Débit limité : création 10 / 10 min par adresse, saisie de codes 30 / 10 min par compte. L'application peut aussi33se connecter directement par clé d'accès (AuthenticationServices) : même vérification serveur que le navigateur, l'origine34signée étant celle du site.3536## Sessions3738Cookie `spmusic_session` : jeton aléatoire de 256 bits (seul son SHA-256 est en base), `HttpOnly`, `Secure` en production, `SameSite=Lax`, sans attribut `Domain` (jamais envoyé à un autre sous-domaine de spboucher.ai), 30 jours. Un nouveau jeton à chaque authentification. Révocation côté serveur : par l'utilisateur (une session, ou toutes les autres), par un administrateur (toutes les sessions d'un compte), par la suspension du compte, par la récupération.3940**CSRF** : toute requête modifiante doit venir de notre origine (`Origin`, `Sec-Fetch-Site`) et porter le jeton CSRF de la session dans `X-CSRF-Token`.4142## Autorisation4344Rôle lu en base à chaque requête. `/api/v1/admin/*` passe par `requireAdmin` avant toute recherche de gestionnaire ; masquer un bouton n'est jamais l'autorisation. Les données personnelles (listes, favoris, état de lecture, clés, sessions) sont filtrées par `user_id` : l'identifiant d'un autre compte répond `404`. Le propriétaire ne peut être ni rétrogradé, ni suspendu, ni supprimé.4546## Téléversement4748Type vérifié sur le contenu ; tailles bornées à la création, à chaque morceau (compté en flux) et à l'analyse ; quota optionnel ; espace disque vérifié. Les noms de fichiers ne servent qu'à l'affichage (nettoyés) : les chemins de stockage sont construits par le serveur à partir d'empreintes et d'UUID, et le pilote refuse toute clé hors de sa racine. Images : JPEG/PNG/WebP, 25 Mo et 8000 px par côté au plus.4950## En-têtes5152CSP (`default-src 'self'`, `frame-ancestors 'none'`, `object-src 'none'`, aucune origine tierce), `Strict-Transport-Security`, `X-Content-Type-Options: nosniff`, `Referrer-Policy`, `X-Frame-Options: DENY`, `Permissions-Policy`. Les réponses audio et image ajoutent `Cross-Origin-Resource-Policy: same-origin` et un cache strictement privé. Aucune ressource externe n'est chargée ; aucun titre écouté ni fichier n'est transmis à un service tiers.5354## Limitation de débit et journal5556Compteurs en base par adresse : authentification 30 / 10 min, codes de récupération 5 / 15 min. Échecs de connexion journalisés avec leur cause, sans secret. `audit_events` consigne les actions d'administration (import remplacé, édition, suppression avec titre et empreinte du fichier, comptes, sessions) ; jamais de contenu audio, de cookie, de jeton, de code ni de challenge. Les erreurs renvoyées au client ne contiennent ni trace, ni chemin.5758## Limites connues5960- `script-src` et `style-src` autorisent `'unsafe-inline'` (amorçage de Next.js sans nonce). Aucun contenu tiers n'est chargé.61- Le port 8690 du nœud est joignable depuis le réseau local sans TLS ; l'en-tête `X-Forwarded-For` y est falsifiable (seule la limitation de débit en dépend). L'accès prévu passe par la passerelle.62- Les originaux ne sont pas chiffrés au repos par l'application (dossier en mode 0700 sur le nœud) ; les sauvegardes de la base le sont.63- La sauvegarde quotidienne est sur le même disque que la bibliothèque tant qu'une copie hors nœud n'est pas mise en place (voir OPERATIONS.md).64- Pas de service worker : pas de lecture hors ligne.65