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.tsles 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.tsredirige vers/connexionsans 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êteOriginde 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 :
- protocoles
http/httpsseulement, pas d'identifiants dans l'URL, noms internes (localhost,.local,.lan,.internal) refusés ; - adresses littérales privées, de bouclage, lien-local, CGNAT/Tailscale (100.64/10), multidiffusion, réservées : refusées (IPv4, IPv6, IPv4 mappé) ;
- 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 ») ;
- les redirections sont suivies à la main (5 au plus) et chaque saut repasse par les mêmes contrôles ;
- 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 pasAPP_SECRETsans 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.m3u8etsegNNNNN.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/ffprobesont 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-Agentcô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.