SPB Git

Repository Public

SECURITY.md 8.3 KB

# Sécurité

Application à utilisateur unique, entièrement privée : aucune page ni route d'API (hors connexion et /api/health) ne répond sans session valide.

# Authentification

  • Mot de passe : scrypt (N = 2¹⁵, r = 8, p = 1, sel aléatoire de 16 octets), comparaison à temps constant, 12 caractères minimum. Formulaire standard (autocomplete="username" / current-password" / new-password) : compatible avec les gestionnaires de mots de passe.
  • Clés d'accès (passkeys / WebAuthn) : enregistrement depuis Admin → Sécurité (après connexion), identifiants « découvrables », liés à tv.spboucher.ai. Défis signés (HMAC, 5 min) dans un cookie HttpOnly limité à /api/auth.
  • Sessions : jeton aléatoire de 256 bits ; seule son empreinte SHA-256 est stockée. Cookie __Host-sptv : HttpOnly, Secure, SameSite=Lax, Path=/, durée configurable (60 jours). Liste et révocation dans l'admin ; changer le mot de passe ferme les autres sessions ; set-password.ts les ferme toutes.
  • Tentatives répétées : 5 échecs en 15 minutes bloquent l'adresse 15 minutes ; 30 échecs toutes adresses confondues bloquent toute connexion (mot de passe et clé d'accès). Les tentatives sont journalisées et visibles dans l'admin.
  • Double contrôle d'accès : src/proxy.ts redirige vers /connexion sans cookie ; la mise en page des pages et chaque route d'API revalident la session en base.
  • CSRF : cookie SameSite=Lax + toute requête non-GET doit porter l'en-tête Origin de l'application.

# SSRF (imports M3U / XMLTV, tests de flux)

Toute URL fournie par une playlist ou par l'administrateur passe par src/server/ssrf.ts :

  1. protocoles http/https seulement, pas d'identifiants dans l'URL, noms internes (localhost, .local, .lan, .internal) refusés ;
  2. adresses littérales privées, de bouclage, lien-local, CGNAT/Tailscale (100.64/10), multidiffusion, réservées : refusées (IPv4, IPv6, IPv4 mappé) ;
  3. 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 entre contrôle et connexion, donc pas de « DNS rebinding ») ;
  4. les redirections sont suivies à la main (5 au plus) et chaque saut repasse par les mêmes contrôles ;
  5. délais d'expiration et tailles maximales sur toutes les réponses.

L'ajout d'une source exige en plus une confirmation explicite d'autorisation d'usage.

# Identifiants de fournisseurs et de Jellyfin

  • Chiffrés au repos en AES-256-GCM avec une clé dérivée de APP_SECRET (secrets.ts) ; ne changez pas APP_SECRET sans ressaisir ces sources (elles deviendraient illisibles, et l'admin l'indique).
  • Saisis une fois dans le formulaire (HTTPS) ; jamais renvoyés par l'API d'administration, jamais écrits dans le journal (les messages d'erreur sont expurgés des identifiants et des paramètres password, api_key, token).
  • Les adresses de lecture qui les contiennent ne sont pas stockées ni présentes dans les réponses de l'API : le serveur répond par une redirection au moment de lire. Limite inhérente à la lecture directe : l'appareil qui lit reçoit nécessairement cette adresse (dans la redirection), comme avec n'importe quel lecteur IPTV.
  • Ajouter un fournisseur exige de cocher une déclaration d'abonnement et d'autorisation ; l'adaptateur n'appelle que les points d'accès documentés de l'API du fournisseur avec vos propres identifiants.
  • Un serveur Jellyfin peut être sur le réseau de la maison (adresse privée acceptée pour ce connecteur seulement, saisi par l'administrateur) ; toutes les autres adresses fournies restent soumises au garde SSRF.

# Playlists M3U personnelles

Les applications de télévision ne peuvent pas ouvrir de session : chaque playlist a donc une adresse à jeton (/m3u/<jeton>.m3u et son guide .xml), seule partie de l'application lisible sans connexion.

  • Jeton aléatoire de 192 bits ; un jeton inconnu ou mal formé reçoit un simple 404, et 20 essais ratés en 15 minutes depuis une même adresse sont bloqués.
  • L'adresse ne donne accès qu'à cette liste de chaînes (noms, logos, adresses publiques des flux, programmes) : ni au compte, ni à l'administration, ni aux films, ni à la bibliothèque.
  • Révocation : « nouvelle adresse » (l'ancienne cesse aussitôt de répondre) ou suppression. La dernière lecture et le client qui l'a faite sont affichés.
  • Le jeton est conservé en clair dans la base pour pouvoir réafficher l'adresse ; il figure donc aussi dans les sauvegardes et, comme toute URL, dans le journal d'accès de la passerelle.
  • Réponses en Cache-Control: private, no-store, X-Robots-Tag: noindex.

# Fichiers personnels

  • Aucun dossier n'est exposé : pas de service de fichiers statiques, pas d'URL contenant un chemin. Un média est demandé par son identifiant numérique (/api/media/:id/file|hls|subs|thumb), derrière la session comme toute l'API (401 sinon).
  • À chaque demande, le chemin réel du fichier (liens symboliques résolus) doit se trouver dans le dossier déclaré dont il provient ; les noms de segments HLS sont limités à index.m3u8 et segNNNNN.ts.
  • Un dossier ne peut être déclaré que sous un emplacement autorisé (LIBRARY_ROOTS) ; les chemins relatifs, cachés ou extérieurs (/etc, dossier des secrets…) sont refusés.
  • Les réponses média portent Cache-Control: private ; les erreurs d'analyse journalisées ne citent que le nom du fichier.
  • ffmpeg / ffprobe sont lancés sans interpréteur de commandes (liste d'arguments), sur des fichiers de la bibliothèque seulement.

# Requêtes sortantes

Wikidata, Wikipédia, Internet Archive, GitHub (playlists), i.mjh.nz (guides), TMDB (si une clé est fournie) : toutes passent par le même garde SSRF, avec délais, tailles maximales et cadence limitée (4 requêtes/s vers Internet Archive, 1 lot/s vers Wikipédia). Les sous-titres distants ne sont récupérés que depuis archive.org.

# En-têtes

Content-Security-Policy (scripts et styles de la même origine ; images, médias et XHR ouverts aux origines externes parce 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), Strict-Transport-Security, X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Referrer-Policy: same-origin (les diffuseurs ne voient jamais l'adresse de la page), X-Robots-Tag: noindex, robots.txt fermé. HTTPS est imposé par la passerelle (redirection 308) et par HSTS.

# Secrets

Aucun secret dans Git (.env ignoré, .env.example sans valeur). APP_SECRET, chemins et identifiant sont dans ~/apps/sp-tv/.env (600) sur le nœud. La base (600, dossier 700) contient l'empreinte du mot de passe, les clés publiques des passkeys et les empreintes de session ; les sauvegardes ont les mêmes droits.

# Respect des sources

  • Lecture directe uniquement : aucun proxy vidéo, aucune retransmission, aucun enregistrement.
  • Aucun contournement : pas de DRM, pas de VPN/relais géographique, pas d'injection d'en-têtes Referer/User-Agent côté navigateur. Un flux qui exige cela est signalé comme non lisible, avec la raison.
  • La liste de blocage d'IPTV-org (retraits à la demande d'ayants droit, contenus pour adultes) est appliquée à l'import.
  • Les tests de disponibilité sont limités (un test à la fois par serveur, pause entre deux tests, aucun segment téléchargé) ; la collecte du guide est plafonnée en nombre de chaînes et en connexions.
  • Qu'un flux soit publiquement accessible n'autorise pas sa redistribution : l'instance est privée, à utilisateur unique.

# Moteur de relais

MediaMTX n'écoute que sur 127.0.0.1 ; la seule entrée est /relay/<jeton>/…, pour une session ouverte par une connexion SP TV encore valide. Relais refusé pour toute source non déclarée autorisée, pour un flux à en-têtes exigés, et pour une destination privée. Détail, limites et tests : RELAY.md.

# Limites connues

  • Pas de second facteur distinct : la clé d'accès remplace le mot de passe, elle ne s'y ajoute pas.
  • Les sauvegardes ne sont pas chiffrées et restent sur le nœud.
  • La CSP autorise 'unsafe-inline' pour les scripts (amorçage de Next.js sans nonce).
  • Le journal d'accès de la passerelle (Caddy) est hors du périmètre de l'application.
Files main
Menu

Theme