Aller au contenu

ArchivePub

ArchivePub est le protocole de fédération (wire protocol) qui sous-tend Artist Alley, défini par le projet Artist Alley. Il est conçu pour que deux instances de gestion d’assets numériques (DAM) exploitées indépendamment puissent partager directement des assets, des posts, des commentaires, des relectures, des kits de marque et des états de flux de travail, sans éditeur intermédiaire.

Aujourd’hui, Artist Alley implémente la connexion de studio à studio. Appairer deux instances ouvre un canal entre elles mais n’échange rien en soi : les mentions « j’aime » et les commentaires concernant un post ne parviennent à un pair qu’une fois le post explicitement partagé avec ce pair. L’envoi d’assets et de posts à un pair, les actions de relecture et les événements de flux de travail sont prévus ; voir Ce qui fonctionne à ce jour.

Là où ActivityPub s’attaque à la messagerie sociale fédérée, ArchivePub vise l’archivage et la collaboration créative fédérés. Les studios qui relisent le travail les uns des autres passent en premier ; le vocabulaire laisse aussi de la place pour des musées qui partagent des rapports d’état, des équipes de marque qui distribuent des kits à des agences partenaires, et des archives qui prêtent des collections sans centraliser l’autorité. Aucun de ces flux de travail n’est encore développé.

ArchivePub reprend le modèle d’ActivityPub (Actor / Activity / Object / Collection) et une grande partie du vocabulaire ActivityStreams qu’utilise ActivityPub ; le modèle mental est donc familier. Ce n’est pas ActivityPub : Artist Alley n’interopère pas avec les serveurs ActivityPub comme Mastodon, et un pont vers le fédiverse public serait un chantier futur distinct. Il s’en écarte volontairement de trois façons qui comptent pour le domaine du DAM :

  • JSON simple, versionné : pas de JSON-LD. Le @context est un marqueur de version, et non un contexte Linked Data à résoudre, et par conception aucun document de contexte JSON-LD n’est publié pour lui. Pas de résolveur de contexte, pas de pièges liés aux signatures LD.
  • Types d’activités et d’objets personnalisés dès le premier jour. Chaque pair est un DAM ; aa:Approve et aa:Asset sont donc des types à part entière : pas de dégradation en Note / Image par souci de compatibilité.
  • URI adressées par le contenu (prévu). La conception référence les octets d’un asset par cas://<sha256>, si bien que des octets identiques ne sont stockés qu’une fois. Le transfert d’assets entre instances n’est pas encore implémenté.

La fédération est de type jardin clos (walled garden) : les pairs sont appairés explicitement, non découvrables publiquement, et chaque objet partagé fait l’objet d’un consentement distinct.

Types d’activités standard présents dans le vocabulaire : Create, Update, Delete, Follow, Accept, Reject, Undo, Like, Announce, Block.

Types d’extension propres au DAM (l’espace de noms aa:) :

TypeRôle
aa:Share / aa:UnshareAccorder / révoquer l’accès à un objet pour un pair appairé. L’instance émettrice ne délivre les activités concernant un objet qu’aux pairs avec lesquels elle l’a partagé.
aa:AssetÉtend Document avec des métadonnées techniques (profil colorimétrique, EXIF, hash du contenu, outil DCC source).
aa:Approve / aa:RequestChanges / aa:MarkReviewedActions de relecture fédérées.
aa:AnnotationUn coup de pinceau, une mise en évidence ou un commentaire de zone ancré à un asset, à un timecode vidéo ou à une page PDF.
aa:WorkflowTransitionChangements d’état de flux de travail fédérés.
aa:AssetVersionChangements de version sans renvoyer les octets.
aa:Subscribe / aa:MentionS’abonner à la sortie d’une collection ou d’un espace de travail ; mentions entre instances.

Types d’objets personnalisés : aa:Asset, aa:Post, aa:Workspace, aa:BrandKit, aa:Collection.

Ces types constituent le vocabulaire sur le réseau, et non une liste de fonctionnalités opérationnelles. Aujourd’hui, une instance réceptrice applique les activités Like et les Create de commentaires ; elle accepte et enregistre les autres types sans agir dessus.

Chaque activité de fédération est une enveloppe JSON contenant un bloc de signature intégré, délivrée à la boîte de réception (inbox) du pair dans une requête qui porte la signature HTTP (HTTP Signature) de l’instance émettrice. La poignée de main d’appairage qui précède est distincte : elle envoie sa propre enveloppe, signée avec la clé que l’instance propose, dans une requête sans signature HTTP. Cette signature montre que l’enveloppe n’a pas été altérée, pas que la clé appartient à l’instance annoncée. Le champ @context porte la chaîne canonique de version du protocole, rien de plus :

{
"@context": "https://artist-alley.org/protocol/v1",
"type": "aa:Approve",
"id": "https://studio-a.example/activities/3f6c2a8e-9b1d-4e7a-8c5f-2d9e0b7a6c41",
"actor": "https://studio-a.example/users/alice",
"published": "2026-06-04T10:00:00Z",
"object": "https://studio-a.example/assets/b2e8d5f1-6a3c-4f09-9e27-71c4a0d3e85b",
"to": ["https://studio-b.example/users/bob"],
"cc": [],
"aa:comment": "Approved with minor lighting note.",
"aa:reviewedAt": "2026-06-04T10:00:00Z",
"signature": {
"type": "Ed25519",
"publicKey": "https://studio-a.example/users/alice#main-key",
"value": "ILLUSTRATIVE-PLACEHOLDER-not-a-computed-signature"
}
}

L’exemple montre l’enveloppe telle que la spécification la définit. Ses identifiants sont illustratifs et la valeur de son champ signature est un substitut, et non une signature calculée ; ce n’est donc pas une enveloppe cryptographiquement valide. Artist Alley n’agit pas encore sur un aa:Approve reçu, et le bloc signature qu’il envoie aujourd’hui est un substitut, comme l’expliquent les règles ci-dessous.

Les règles du protocole sur le réseau (selon l’ADR 0043 et la spécification), avec ce qu’Artist Alley fait aujourd’hui :

  • Authentification de l’instance (appliquée). Chaque POST vers l’inbox porte une signature HTTP de l’instance émettrice, et le destinataire la vérifie avec la clé du pair appairé avant d’accepter la requête.
  • Signature par acteur (pas encore implémentée). La spécification exige une signature Ed25519 intégrée, produite par l’acteur émetteur sur l’enveloppe sans son champ signature, canonicalisée selon la RFC 8785 (JSON Canonicalization Scheme), et exige que le destinataire la vérifie avec la clé publiée de l’acteur avant de traiter l’activité interne. Artist Alley ne le fait pas encore : il envoie un bloc de signature substitut, et le destinataire vérifie seulement que le bloc est présent et qu’il nomme Ed25519. Tant que cela n’est pas en place, les activités sont authentifiées par instance, et non par acteur, et la signature intégrée n’offre aucune garantie de relais, de stockage ni de rejeu d’audit.
  • Analyse stricte (partiellement implémentée). La spécification exige que les champs inconnus soient rejetés, et non ignorés silencieusement. L’analyseur d’Artist Alley rejette les champs inconnus dans les blocs signature et encryption, mais conserve actuellement les champs inconnus de premier niveau au lieu de les rejeter.
  • Livraison. Les enveloppes sont envoyées par POST à l’inbox d’un destinataire (POST /federation/inbox), avec une variante par lots (POST /federation/inbox/batch) pour les files comptant plus d’une activité en attente par pair.

C’est la propriété de sécurité sur laquelle tout repose. Appairer un pair établit un canal de confiance, rien de plus. Cela ne partage aucun post, aucune collection, aucun espace de travail, aucun kit de marque ni aucun commentaire. Après l’appairage, les deux instances se connaissent simplement et peuvent authentifier les requêtes signées l’une de l’autre.

Chaque objet partagé fait l’objet d’un consentement explicite et distinct. Pour partager un objet avec un pair appairé (ou avec un utilisateur précis de ce pair), le propriétaire de l’objet ou un administrateur accorde un partage, ce qui émet une activité aa:Share avec une portée (par exemple view, comment ou annotate) et une date d’expiration facultative. L’instance émettrice ne délivre ensuite les activités concernant cet objet qu’aux pairs avec lesquels il a été partagé ; aujourd’hui, cette livraison ne couvre que les posts. Un partage n’envoie pas encore l’objet lui-même : l’instance réceptrice enregistre l’aa:Share sans agir dessus, et l’envoi d’assets et de posts est prévu. La spécification exige aussi que l’instance réceptrice rejette les activités concernant des objets pour lesquels le pair émetteur ne détient aucun partage ; Artist Alley n’applique pas encore cette vérification en entrée. Le modèle est un canal privé entre deux studios appairés, et non le fédiverse ouvert.

Les niveaux de confiance décrivent ce que le canal peut transporter : connected (le niveau standard), directory-listed (adhère à un annuaire de découverte facultatif) et auto-sync (partage automatique piloté par des règles, sur adhésion, au sein d’un même domaine de confiance). Aujourd’hui, le niveau est une simple étiquette : la poignée de main d’appairage définit connected, un administrateur peut définir l’un des trois, et Artist Alley se comporte de la même façon quel que soit celui qui est défini. La découverte par annuaire fonctionne indépendamment du niveau : une instance peut s’abonner à des annuaires de découverte, et peut demander à figurer dans l’un d’eux après avoir prouvé son domaine avec un enregistrement DNS. Les règles d’auto-sync ne sont pas implémentées.

Dans la conception du protocole, toute référence aux octets d’un asset utilise une URI adressée par le contenu :

cas://<sha256>?content-type=image/png&size=12345

Dans cette conception, le pair récepteur vérifie d’abord son stockage local (si le SHA-256 est déjà présent, aucun transfert n’a lieu) ; sinon, il récupère les octets depuis l’origine avec une requête signée et les met en cache, si bien que des octets identiques ne sont stockés qu’une fois par instance. Artist Alley ne transfère pas encore d’octets d’assets entre instances ; c’est un chantier prévu (#72).

Le niveau de chiffrement est orthogonal au niveau de confiance. Selon la politique d’émission de la spécification, la charge utile d’une activité est placée dans un bloc encryption NaCl-box, adressé à la clé publiée de l’acteur destinataire, chaque fois que l’émetteur peut chiffrer : le pair a négocié la prise en charge du chiffrement et la clé de chiffrement du destinataire est disponible. Les activités concernant du contenu de niveau restricted ou embargo ne sont envoyées que de cette façon ; si l’émetteur ne peut pas chiffrer pour un destinataire, il n’envoie rien à ce destinataire plutôt que de se rabattre sur du texte en clair. Les activités concernant du contenu de niveau public ou team sont envoyées en clair dans ce cas.

Artist Alley applique la règle « chiffrer quand c’est possible » à tout ce qu’il envoie. Aujourd’hui, il n’envoie que des activités concernant des posts, et les traite comme étant de niveau public ; le refus pour le contenu restreint et sous embargo n’est donc pas encore atteint. À la réception, il rejette une activité en clair concernant un asset local dont le niveau exige le chiffrement. Une limite actuelle : le destinataire déchiffre avec la clé de l’émetteur actuellement connue ; une enveloppe scellée avec une ancienne clé de l’émetteur ne se déchiffre donc pas. Voir l’ADR 0049 pour la conception de la fédération chiffrée et sa validation en conditions réelles (dogfood).

  • Implémenté : l’appairage de pairs ; les requêtes d’inbox signées en HTTP, vérifiées à la réception ; les partages accordés, qui déterminent quels pairs reçoivent les activités concernant un post ; les mentions « j’aime » et les commentaires appliqués sur l’instance réceptrice ; le chiffrement de la charge utile quand le pair et le destinataire le prennent en charge ; la livraison à l’inbox à l’unité et par lots ; l’abonnement à des annuaires de découverte et la demande d’y figurer.
  • Dans le vocabulaire, pas encore suivi d’effet : l’instance réceptrice accepte et enregistre les actions de relecture (aa:Approve, aa:RequestChanges, aa:MarkReviewed), les annotations, les transitions de flux de travail, les versions d’assets, les abonnements, les mentions, aa:Share / aa:Unshare et les autres types standard, sans les appliquer.
  • Pas encore implémenté : la signature et la vérification des enveloppes par acteur ; le rejet des champs inconnus de premier niveau ; la vérification en entrée des partages accordés ; l’envoi d’assets et de posts partagés, y compris le transfert d’assets adressé par le contenu entre instances ; la consultation du niveau des activités sortantes, si bien que le refus pour le contenu restreint et sous embargo n’est pas en vigueur ; les règles d’auto-sync ; le déchiffrement des enveloppes scellées avec une ancienne clé de l’émetteur.
  • Non pris en charge : l’interopérabilité avec les serveurs ActivityPub comme Mastodon. Aucune implémentation autre qu’Artist Alley n’a démontré d’interopérabilité avec ArchivePub.

La section Implementation status de la spécification décrit plus en détail les écarts concernant la signature, l’analyse, les partages accordés, le CAS et les clés de chiffrement.