Aller au contenu

La sécurité dans Artist Alley

Artist Alley détient trois catégories de données de valeur : le travail créatif des artistes (souvent confidentiel, souvent soumis à un NDA), les métadonnées de studio (noms de projets, commentaires de revue internes, propriété intellectuelle non annoncée) et les identifiants des opérateurs (authentification, clés d’API tierces, matériel de signature des licences). La posture de sécurité est conçue pour protéger ces trois catégories à la fois contre l’exposition accidentelle et contre des attaquants déterminés disposant d’identifiants valides.

Cette page documente les règles porteuses. Toute PR qui touche un chemin d’authentification, un magasin d’identifiants, une vérification de permissions, un chemin d’octets d’asset ou une intégration externe les suit.

Trois adversaires concrets façonnent la conception :

  • L’utilisateur authentifié mais sans privilèges. Un utilisateur disposant d’un identifiant valide mais sans raison légitime de lire des assets restreints. C’est l’attaquant contre lequel le système de permissions est construit.
  • L’identifiant qui a fuité. Une session volée, un jeton d’API publié, un fichier de licence égaré. La parade est la révocation et une piste d’audit : les sessions expirent après une période d’inactivité et peuvent être révoquées, les jetons d’API peuvent recevoir une date d’expiration et être révoqués à tout moment, et les connexions ainsi que les changements pertinents pour la sécurité sont audités. Les jetons d’API n’expirent pas à moins que leur créateur ne définisse une expiration, et la liste de scopes d’un jeton ne limite pas encore ce qu’il peut faire (voir Authentification).
  • Le pair / connecteur / add-on compromis. Un pair fédéré, une source d’import, un plugin tiers exécutant du code malveillant. L’objectif de conception est que chacun ne soit approuvé que dans la mesure où une décision explicite le permet. Pour la fédération, l’appairage ne partage rien : une nouvelle demande d’appairage attend qu’un administrateur accepte la clé proposée, et les activités concernant un post ne vont qu’aux pairs avec lesquels il a été explicitement partagé. La poignée de main d’appairage initiale est auto-signée plutôt qu’envoyée comme une requête signée HTTP. Des lacunes connues subsistent : les messages fédérés sont authentifiés par instance, et non par acteur, car les signatures par acteur ne sont pas encore créées ni vérifiées ; une instance réceptrice ne vérifie pas encore que l’expéditeur détient une autorisation de partage pour l’objet ; et le refus de l’expéditeur d’envoyer du contenu restreint ou sous embargo non chiffré n’est pas encore câblé. Voir la section Ce qui fonctionne à ce jour d’ArchivePub. Les add-ons sont prévus ; il n’existe donc pas encore de frontière d’isolation des plugins sur laquelle s’appuyer.

Hors périmètre :

  • Le ciblage par un État. Hors du périmètre du modèle de menaces du projet ; les opérateurs ayant ce profil de risque exécutent leur instance derrière une infrastructure isolée (air-gapped).
  • L’accès physique au serveur. Si l’attaquant peut lire le disque, toute garantie de confidentialité des données tombe ; le chiffrement du disque relève de la responsabilité de l’opérateur, pas de la nôtre.
  • Les attaques par canaux auxiliaires contre l’OS hôte. Exécution spéculative, biais matériel des générateurs aléatoires, etc. Hors périmètre.
  • Les sessions sont côté serveur. La table sessions contient un condensat SHA-256 du jeton ; le client reçoit un cookie opaque portant la valeur en clair, qui n’atteint jamais la base de données. Il n’y a aucune charge utile de session lisible par le client.
  • Les jetons d’API sont des Personal Access Tokens, préfixés aa_pat_ : des chaînes aléatoires à forte entropie. Seul leur condensat SHA-256 arrive dans api_tokens.token_hash ; la valeur en clair est affichée une seule fois à la création et jamais persistée, si bien qu’un dump de la base ne livre aucun jeton utilisable. Un jeton a une expiration facultative et peut être révoqué à tout moment. Il peut aussi recevoir une liste de scopes, mais les scopes sont enregistrés, pas encore appliqués : un jeton agit actuellement avec toutes les permissions de l’utilisateur qui l’a créé ; traitez donc chaque jeton comme un identifiant complet pour ce compte. Un jeton ne peut être créé que depuis une session par cookie ; vous ne pouvez pas en émettre un à l’aide d’un autre jeton.
  • Les mots de passe reçoivent un poivre (pepper) par HMAC-SHA256 (avec la clé AA_SCRAMBLE_KEY) puis sont hachés avec bcrypt. Grâce au poivre, une base volée seule ne peut pas être cassée hors ligne sans détenir aussi la clé de brouillage. Les mots de passe en clair ne doivent jamais être écrits dans les journaux, les événements d’audit ni les corps de réponse ; tout chemin qui le fait est un bug. Il existe une exception délibérée pour l’administrateur du premier démarrage : quand aucun administrateur n’existe encore, le serveur génère un mot de passe aléatoire, l’affiche dans le journal de démarrage et tente de l’écrire dans bootstrap-admin.txt avec le mode 0600. Si cette écriture échoue, le journal est la seule copie. Protégez tout journal de démarrage qui le contient, et changez le mot de passe après la première connexion.
  • Le SSO n’est pas encore disponible. Le code contient des fournisseurs LDAP et SAML, mais ils ne s’enregistrent qu’avec une fonctionnalité de licence qui ne peut pas être obtenue aujourd’hui, et il n’existe aucun fournisseur OAuth ni OIDC. Un SSO générique est prévu pour la v0.17.0 et ne nécessitera pas de licence (ADR 0066) ; des passerelles propres à certains fournisseurs (Okta / Auth0 / WorkOS) sont prévues sous forme d’add-ons selon l’ADR 0038.
  • Les codes de capacité sont l’unité de permission, pas les noms de rôles. Un code qui vérifie « cet utilisateur est-il admin ? » est faux ; un code qui vérifie « cet utilisateur a-t-il la capacité assets.delete ? » est correct.
  • Les capacités vivent dans la table capabilities ; les rôles regroupent des capacités via role_capabilities ; les utilisateurs reçoivent des rôles via user_roles. Des exceptions par utilisateur (user_capability_grants et user_capability_revokes) permettent à un admin d’accorder ou de retirer une capacité précise sans inventer un rôle ponctuel.
  • La vérification de capacité se fait à l’entrée du handler, pas plus profond. Une méthode de dépôt ne vérifie pas les capacités ; c’est le handler qui l’appelle qui le fait. Cela garde la frontière de confiance visible.

Ce sont les règles que suit le nouveau code. Elles ne garantissent pas que chaque endpoint existant applique déjà une vérification de capacité : certains endpoints vérifient aujourd’hui seulement que l’appelant est connecté.

Partiellement livré ; le reste est prévu pour la v0.15.0 (ADR 0020). Les assets portent dès aujourd’hui un niveau de sensibilité. Un asset restreint ou sous embargo apparaît toujours comme un espace réservé verrouillé sur les pages de posts et dans les collections (le fil par défaut le masque) : son titre, ses champs et sa miniature sont retenus pour les lecteurs sans accès, qui peuvent demander l’accès, et les routes qui délivrent le contenu de l’asset par ID d’asset refusent de le servir à ces lecteurs. Le floutage côté serveur, l’action Reveal et la carte d’embargo décrits ci-dessous sont prévus.

  • Niveau de sensibilité par asset, livré (public / team / restricted / embargo, selon l’ADR 0020). Le niveau est appliqué sur le serveur, pas seulement dans l’interface, par les routes qui délivrent le contenu d’un asset par ID d’asset : son fichier d’origine, ses variantes dérivées, ses flux vidéo et le contenu de ses archives ne sont servis qu’après vérification de l’accès de l’appelant, niveau compris.
  • Prévu pour la v0.15.0 : floutage côté serveur pour les assets restreints et sous embargo. Le flou serait une variante d’aperçu générée côté serveur, de sorte que même une fuite par écoute réseau non authentifiée ne montre que des octets floutés, et une action Reveal lèverait le flou pour la session et écrirait un événement d’audit.
  • Prévu pour la v0.15.0 : levée d’embargo via le moteur d’actions planifiées. La levée serait une action planifiée, journalisée dans l’audit lorsqu’elle se déclenche.
  • Chiffrement au repos. La clé maîtresse de l’hôte, AA_MASTER_KEY (obligatoire au démarrage), chiffre certaines valeurs sensibles de la base de données : les secrets d’authentification à deux facteurs (TOTP), l’identité de fédération, les clés d’acteur et d’utilisateur, et le mot de passe SMTP. Tous les secrets saisis dans les paramètres d’administration ne sont pas chiffrés de cette manière ; traitez donc la base de données et chacune de ses sauvegardes comme sensibles : restreignez qui peut s’y connecter, et gardez les sauvegardes chiffrées et à accès contrôlé. Les identifiants stockés ne sont jamais renvoyés par l’API d’administration.
  • La rotation de la clé maîtresse n’est pas prise en charge en v1 : il n’existe pas d’outil pour rechiffrer les valeurs existantes avec une nouvelle clé ; gardez donc AA_MASTER_KEY stable et sauvegardée.
  • Les Cloudflare Worker Secrets contiendront la clé de signature Ed25519 pour l’émission des .lic de licence (une fois la gestion des licences livrée, prévue pour la v0.18.0, selon l’ADR 0017) ; la clé de signature ne quitte jamais le Worker.
  • Les changements pertinents pour la sécurité écrivent une ligne audit_events : connexions (réussies, échouées, limitées en débit), verrouillages de compte, sessions qui expirent ou sont révoquées, octrois et retraits de capacités, demandes d’accès, actions planifiées, partages de fédération, suppressions et restaurations d’assets par un admin, changements de configuration par un admin, et purges de rétention de l’audit. L’enregistrement se fait au mieux (best-effort) : une opération peut n’avoir aucune entrée d’audit si l’enregistrement échoue.
  • Les événements ne sont pas encore reliés par un identifiant commun de requête ou de tâche. Chaque événement enregistre son type, son horodatage et des métadonnées propres à l’événement, ainsi que l’acteur, le sujet, l’adresse IP et le user agent lorsqu’ils sont disponibles. Ceux-ci peuvent être absents, en particulier pour le travail que le système déclenche lui-même.
  • La rétention de l’audit est de 7 ans par défaut. Les admins peuvent exporter le journal d’audit en CSV ou en JSON délimité par des sauts de ligne ; l’export n’est pas signé. Un export signé est prévu avec le travail sur les licences (ADR 0017).

Prévu pour la v0.15.0. La conception ci-dessous (ADR 0018) est la posture visée ; les liens de partage ne sont pas encore livrés.

URL de partage signées et expirantes pour les collaborateurs externes (selon l’ADR 0018) :

  • Le jeton est un identifiant aléatoire de 32 octets, pas un JWT. La révocation est la suppression d’une seule ligne : pas de rotation de clés, pas de surface de liste noire de jetons.
  • Scope par lien : view / comment / annotate / download. Le scope est appliqué au niveau du handler ; contourner la visionneuse du lien pour atteindre l’endpoint canonique exige toujours la capacité correspondante.
  • Mot de passe facultatif sur le lien, stocké haché. Les tentatives de mot de passe échouées sont limitées en débit et auditées.
  • Piste d’audit par accès : IP, user agent, résultat du mot de passe, scope satisfait. L’opérateur peut voir qui a utilisé un lien sans contacter le destinataire.
  • Décodage des requêtes et vérifications des handlers. Les requêtes sont décodées dans les types générés à partir de la spécification OpenAPI, et un corps de requête qui ne peut pas être décodé est rejeté avec un 400 ; au-delà, les handlers appliquent leur propre validation là où elle s’applique. Aucun middleware distinct de validation de schéma OpenAPI n’est monté.
  • Pas de concaténation de chaînes SQL. Utilisez les requêtes paramétrées générées par sqlc ; quand une requête doit être construite à l’exécution, passez les valeurs en paramètres plutôt que de les formater dans la chaîne SQL. Un db.Exec(fmt.Sprintf(...)) brut est un motif de blocage en revue de code.
  • Pas de concaténation de HTML dans les templates. L’échappement automatique de Svelte est la règle par défaut ; {@html ...} est un motif de blocage en revue de code et exige une justification.
  • Traversée de chemin : les fichiers stockés sont adressés par clé, pas par un chemin fourni par l’appelant. La couche de stockage valide chaque clé avant qu’un backend n’y touche : le nom d’objet doit être un hachage SHA-256, et une clé de variante ne peut pas contenir .., une barre oblique initiale ni une barre oblique doublée. Les deux backends de stockage exécutent cette vérification à chaque opération, donc les handlers n’ont pas à la répéter.

Selon l’ADR 0024 :

  • Suppression logique d’abord (livrée) : les assets, posts et collections supprimés restent récupérables pendant 30 jours par défaut, et les utilisateurs archivés pendant 90 jours, avant de devenir éligibles à la suppression définitive. Les opérateurs peuvent modifier ces durées de rétention.
  • La bannière de cookies / traceurs, prévue pour la v0.16.0, ne s’affichera que lorsqu’une catégorie non essentielle est utilisée ; une installation de studio standard sans analytique n’affiche aucune bannière.
  • L’outillage DSAR, prévu pour la v0.16.0 : chaque utilisateur pourra exporter ses données personnelles en JSON et demander leur suppression ; la suppression définitive réattribue le contenu créé à un tombstone deleted-user afin que le travail collaboratif survive.
  • L’accès au journal d’audit est lui-même soumis à une capacité. La lecture du journal d’audit n’est pas elle-même enregistrée comme un événement d’audit.

Si vous pensez avoir trouvé un problème de sécurité :

  • N’ouvrez pas d’issue GitHub publique. Signalez-le en privé : ouvrez un avis de sécurité privé depuis l’onglet Security du dépôt (Report a vulnerability), ou écrivez à security@artist-alley.org.
  • Indiquez les étapes de reproduction, la version concernée et l’impact que vous avez observé.
  • Nous accuserons réception de votre signalement et vous tiendrons informé pendant que nous enquêtons et travaillons à un correctif.

Nous n’avons pas encore de programme de bug bounty. Un crédit public pour le signalement (à votre choix, sur option) figure dans les notes de version du correctif.

Ce qui ressemble à des fonctions de sécurité mais n’en est pas

Section intitulée « Ce qui ressemble à des fonctions de sécurité mais n’en est pas »
  • Anti-AdBlock. Il n’existe aucun add-on publicitaire aujourd’hui, et le plan n’est pas de combattre les bloqueurs de publicité ; nous ne menons pas de course aux armements contre eux depuis le noyau AGPL.
  • DRM sur les octets des assets. Nous ne chiffrons pas les octets des assets au repos dans le backend de stockage au-delà de ce que le backend fournit lui-même (le chiffrement côté serveur de S3 est une option configurée par l’opérateur, pas une fonctionnalité d’Artist Alley). La livraison protégée par DRM est hors périmètre.
  • Anti-partage de comptes. Une fois la gestion des licences livrée (prévue pour la v0.18.0, ADR 0017), les sièges actifs seront comptés pour la licence, pas pour la surveillance : uniquement « combien d’utilisateurs distincts ont été actifs au cours des 30 derniers jours » ; nous ne prenons pas d’empreinte des sessions et ne lions pas les connexions à un appareil.