SPB Git

Repository Public

SECURITY.md 8.3 KB 117 lines markdown

1# Sécurité23Application à utilisateur unique, entièrement privée : aucune page ni route d'API (hors connexion et `/api/health`) ne4répond sans session valide.56## Authentification78- **Mot de passe** : scrypt (N = 2¹⁵, r = 8, p = 1, sel aléatoire de 16 octets), comparaison à temps constant, 12 caractères9  minimum. Formulaire standard (`autocomplete="username"` / `current-password"` / `new-password`) : compatible avec les10  gestionnaires de mots de passe.11- **Clés d'accès (passkeys / WebAuthn)** : enregistrement depuis Admin → Sécurité (après connexion), identifiants12  « découvrables », liés à `tv.spboucher.ai`. Défis signés (HMAC, 5 min) dans un cookie HttpOnly limité à `/api/auth`.13- **Sessions** : jeton aléatoire de 256 bits ; seule son empreinte SHA-256 est stockée. Cookie `__Host-sptv` :14  `HttpOnly`, `Secure`, `SameSite=Lax`, `Path=/`, durée configurable (60 jours). Liste et révocation dans l'admin ;15  changer le mot de passe ferme les autres sessions ; `set-password.ts` les ferme toutes.16- **Tentatives répétées** : 5 échecs en 15 minutes bloquent l'adresse 15 minutes ; 30 échecs toutes adresses confondues17  bloquent toute connexion (mot de passe et clé d'accès). Les tentatives sont journalisées et visibles dans l'admin.18- **Double contrôle d'accès** : `src/proxy.ts` redirige vers `/connexion` sans cookie ; la mise en page des pages et chaque19  route d'API revalident la session en base.20- **CSRF** : cookie `SameSite=Lax` + toute requête non-GET doit porter l'en-tête `Origin` de l'application.2122## SSRF (imports M3U / XMLTV, tests de flux)2324Toute URL fournie par une playlist ou par l'administrateur passe par `src/server/ssrf.ts` :25261. protocoles `http`/`https` seulement, pas d'identifiants dans l'URL, noms internes (`localhost`, `.local`, `.lan`, `.internal`) refusés ;272. adresses littérales privées, de bouclage, lien-local, CGNAT/Tailscale (100.64/10), multidiffusion, réservées : refusées (IPv4, IPv6, IPv4 mappé) ;283. pour un nom d'hôte, la vérification est faite **dans la résolution DNS utilisée par la connexion** (pas de fenêtre entre29   contrôle et connexion, donc pas de « DNS rebinding ») ;304. les redirections sont suivies à la main (5 au plus) et chaque saut repasse par les mêmes contrôles ;315. délais d'expiration et tailles maximales sur toutes les réponses.3233L'ajout d'une source exige en plus une confirmation explicite d'autorisation d'usage.3435## Identifiants de fournisseurs et de Jellyfin3637- Chiffrés au repos en AES-256-GCM avec une clé dérivée de `APP_SECRET` (`secrets.ts`) ; ne changez pas `APP_SECRET` sans38  ressaisir ces sources (elles deviendraient illisibles, et l'admin l'indique).39- Saisis une fois dans le formulaire (HTTPS) ; jamais renvoyés par l'API d'administration, jamais écrits dans le journal40  (les messages d'erreur sont expurgés des identifiants et des paramètres `password`, `api_key`, `token`).41- Les adresses de lecture qui les contiennent ne sont pas stockées ni présentes dans les réponses de l'API : le serveur42  répond par une redirection au moment de lire. **Limite inhérente à la lecture directe** : l'appareil qui lit reçoit43  nécessairement cette adresse (dans la redirection), comme avec n'importe quel lecteur IPTV.44- Ajouter un fournisseur exige de cocher une déclaration d'abonnement et d'autorisation ; l'adaptateur n'appelle que les45  points d'accès documentés de l'API du fournisseur avec vos propres identifiants.46- Un serveur Jellyfin peut être sur le réseau de la maison (adresse privée acceptée pour ce connecteur seulement, saisi47  par l'administrateur) ; toutes les autres adresses fournies restent soumises au garde SSRF.4849## Playlists M3U personnelles5051Les applications de télévision ne peuvent pas ouvrir de session : chaque playlist a donc une adresse à jeton52(`/m3u/<jeton>.m3u` et son guide `.xml`), seule partie de l'application lisible sans connexion.5354- Jeton aléatoire de 192 bits ; un jeton inconnu ou mal formé reçoit un simple 404, et 20 essais ratés en 15 minutes55  depuis une même adresse sont bloqués.56- L'adresse ne donne accès qu'à cette liste de chaînes (noms, logos, adresses publiques des flux, programmes) : ni au57  compte, ni à l'administration, ni aux films, ni à la bibliothèque.58- Révocation : « nouvelle adresse » (l'ancienne cesse aussitôt de répondre) ou suppression. La dernière lecture et le59  client qui l'a faite sont affichés.60- Le jeton est conservé en clair dans la base pour pouvoir réafficher l'adresse ; il figure donc aussi dans les sauvegardes61  et, comme toute URL, dans le journal d'accès de la passerelle.62- Réponses en `Cache-Control: private, no-store`, `X-Robots-Tag: noindex`.6364## Fichiers personnels6566- Aucun dossier n'est exposé : pas de service de fichiers statiques, pas d'URL contenant un chemin. Un média est demandé67  par son identifiant numérique (`/api/media/:id/file|hls|subs|thumb`), derrière la session comme toute l'API (401 sinon).68- À chaque demande, le chemin réel du fichier (liens symboliques résolus) doit se trouver dans le dossier déclaré dont il69  provient ; les noms de segments HLS sont limités à `index.m3u8` et `segNNNNN.ts`.70- Un dossier ne peut être déclaré que sous un emplacement autorisé (`LIBRARY_ROOTS`) ; les chemins relatifs, cachés ou71  extérieurs (`/etc`, dossier des secrets…) sont refusés.72- Les réponses média portent `Cache-Control: private` ; les erreurs d'analyse journalisées ne citent que le nom du fichier.73- `ffmpeg` / `ffprobe` sont lancés sans interpréteur de commandes (liste d'arguments), sur des fichiers de la bibliothèque seulement.7475## Requêtes sortantes7677Wikidata, Wikipédia, Internet Archive, GitHub (playlists), `i.mjh.nz` (guides), TMDB (si une clé est fournie) : toutes78passent par le même garde SSRF, avec délais, tailles maximales et cadence limitée (4 requêtes/s vers Internet Archive,791 lot/s vers Wikipédia). Les sous-titres distants ne sont récupérés que depuis `archive.org`.8081## En-têtes8283`Content-Security-Policy` (scripts et styles de la même origine ; images, médias et XHR ouverts aux origines externes84parce que le navigateur lit les flux et les logos directement à leur source ; `frame-ancestors 'none'` ; `frame-src` limité aux lecteurs officiels `onf.ca` / `nfb.ca` / `arte.tv`),85`Strict-Transport-Security`, `X-Content-Type-Options: nosniff`, `X-Frame-Options: DENY`, `Referrer-Policy: same-origin`86(les diffuseurs ne voient jamais l'adresse de la page), `X-Robots-Tag: noindex`, `robots.txt` fermé.87HTTPS est imposé par la passerelle (redirection 308) et par HSTS.8889## Secrets9091Aucun secret dans Git (`.env` ignoré, `.env.example` sans valeur). `APP_SECRET`, chemins et identifiant sont dans92`~/apps/sp-tv/.env` (600) sur le nœud. La base (`600`, dossier `700`) contient l'empreinte du mot de passe, les clés93publiques des passkeys et les empreintes de session ; les sauvegardes ont les mêmes droits.9495## Respect des sources9697- Lecture directe uniquement : **aucun proxy vidéo**, aucune retransmission, aucun enregistrement.98- Aucun contournement : pas de DRM, pas de VPN/relais géographique, pas d'injection d'en-têtes `Referer`/`User-Agent`99  côté navigateur. Un flux qui exige cela est signalé comme non lisible, avec la raison.100- La liste de blocage d'IPTV-org (retraits à la demande d'ayants droit, contenus pour adultes) est appliquée à l'import.101- Les tests de disponibilité sont limités (un test à la fois par serveur, pause entre deux tests, aucun segment téléchargé) ;102  la collecte du guide est plafonnée en nombre de chaînes et en connexions.103- Qu'un flux soit publiquement accessible n'autorise pas sa redistribution : l'instance est privée, à utilisateur unique.104105## Moteur de relais106107MediaMTX n'écoute que sur 127.0.0.1 ; la seule entrée est `/relay/<jeton>/…`, pour une session ouverte par une connexion108SP TV encore valide. Relais refusé pour toute source non déclarée autorisée, pour un flux à en-têtes exigés, et pour une109destination privée. Détail, limites et tests : `RELAY.md`.110111## Limites connues112113- Pas de second facteur distinct : la clé d'accès remplace le mot de passe, elle ne s'y ajoute pas.114- Les sauvegardes ne sont pas chiffrées et restent sur le nœud.115- La CSP autorise `'unsafe-inline'` pour les scripts (amorçage de Next.js sans nonce).116- Le journal d'accès de la passerelle (Caddy) est hors du périmètre de l'application.117
Files main
Menu

Theme