ArchivePub
ArchivePub es el protocolo de federación (wire protocol) que hay detrás de Artist Alley, definido por el proyecto Artist Alley. Está diseñado para que dos instancias de gestión de activos digitales (DAM) operadas de forma independiente puedan compartir directamente assets, posts, comentarios, revisiones, kits de marca y estados de flujo de trabajo, sin un proveedor intermediario.
Hoy Artist Alley implementa la conexión de estudio a estudio. Emparejar dos instancias abre un canal entre ellas, pero por sí solo no intercambia nada: los «me gusta» y los comentarios sobre un post solo llegan a un par una vez que el post se ha compartido explícitamente con ese par. Enviar assets y posts a un par, las acciones de revisión y los eventos de flujo de trabajo están previstos; consulta Qué funciona hoy.
Donde ActivityPub resuelve la mensajería social federada, ArchivePub apunta al archivo y la colaboración creativa federados. Los estudios que se revisan el trabajo unos a otros van primero; el vocabulario también deja espacio para museos que comparten informes de estado, equipos de marca que distribuyen kits a agencias asociadas y archivos que prestan colecciones sin centralizar la autoridad. Ninguno de esos flujos de trabajo está construido todavía.
La forma
Sección titulada «La forma»ArchivePub toma prestado el modelo de ActivityPub (Actor /
Activity / Object / Collection) y gran parte del vocabulario de
ActivityStreams que usa ActivityPub, de modo que el modelo mental resulta
familiar. No es ActivityPub: Artist Alley no interopera con servidores
ActivityPub como Mastodon, y un puente con el fediverso público sería un
trabajo futuro aparte. Se aparta de ActivityPub deliberadamente de tres
maneras que importan para el dominio de los DAM:
- JSON simple y versionado: sin JSON-LD. El
@contextes un marcador de versión, no un contexto de Linked Data que resolver, y por diseño no se publica ningún documento de contexto JSON-LD para él. Sin resolvedor de contexto, sin las trampas de las firmas LD. - Tipos de actividad y de objeto personalizados desde el primer día.
Cada par es un DAM, así que
aa:Approveyaa:Assetson tipos de pleno derecho: sin degradarlos aNote/Imagepor compatibilidad. - URI direccionadas por contenido (previsto). El diseño referencia los
bytes de un asset mediante
cas://<sha256>, de modo que los bytes idénticos se almacenan una sola vez. La transferencia de assets entre instancias todavía no está implementada.
La federación es de tipo jardín amurallado (walled garden): los pares se emparejan explícitamente, no se pueden descubrir abiertamente, y cada objeto compartido es una aceptación aparte.
Vocabulario
Sección titulada «Vocabulario»Tipos de actividad estándar del vocabulario: Create, Update, Delete,
Follow, Accept, Reject, Undo, Like, Announce, Block.
Tipos de extensión propios del DAM (el espacio de nombres aa:):
| Tipo | Propósito |
|---|---|
aa:Share / aa:Unshare | Conceder / revocar el acceso a un objeto para un par emparejado. La instancia emisora solo entrega actividades sobre un objeto a los pares con los que lo ha compartido. |
aa:Asset | Amplía Document con metadatos técnicos (perfil de color, EXIF, hash del contenido, herramienta DCC de origen). |
aa:Approve / aa:RequestChanges / aa:MarkReviewed | Acciones de revisión federadas. |
aa:Annotation | Una pincelada, un resaltado o un comentario de región anclado a un asset, a un timecode de vídeo o a una página de PDF. |
aa:WorkflowTransition | Cambios de estado de flujo de trabajo federados. |
aa:AssetVersion | Cambios de versión sin reenviar los bytes. |
aa:Subscribe / aa:Mention | Suscribirse a la salida de una colección o un espacio de trabajo; menciones entre instancias. |
Tipos de objeto personalizados: aa:Asset, aa:Post, aa:Workspace,
aa:BrandKit, aa:Collection.
Estos tipos son el vocabulario en la red, no una lista de funciones que ya
operan. Hoy una instancia receptora aplica las actividades Like y los
Create de comentarios; acepta y registra los demás tipos sin actuar sobre
ellos.
El sobre
Sección titulada «El sobre»Cada actividad de federación es un sobre JSON con un bloque de firma
incrustado, entregado en la bandeja de entrada (inbox) del par mediante una
solicitud que lleva la firma HTTP (HTTP Signature) de la instancia
emisora. El protocolo de emparejamiento que va antes es aparte: envía su
propio sobre, firmado con la clave que la instancia ofrece, en una
solicitud sin firma HTTP. Esa firma demuestra que el sobre no fue alterado,
no que la clave pertenezca a la instancia que dice ser. El campo
@context lleva la cadena canónica de la versión del protocolo, nada más:
{ "@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" }}El ejemplo muestra el sobre tal como lo define la especificación. Sus
identificadores son ilustrativos y el valor de su campo signature es un
marcador de posición, no una firma calculada, por lo que no es un sobre
criptográficamente válido. Artist Alley todavía no actúa sobre un
aa:Approve recibido, y el bloque signature que envía hoy es un marcador
de posición, como explican las reglas siguientes.
Reglas del protocolo en la red (según el ADR 0043 y la especificación), con lo que hace hoy Artist Alley:
- Autenticación de la instancia (aplicada). Cada
POSTal inbox lleva una firma HTTP de la instancia emisora, y el receptor la verifica con la clave del par emparejado antes de aceptar la solicitud. - Firma por actor (todavía no implementada). La especificación exige
una firma
Ed25519incrustada, hecha por el actor emisor sobre el sobre sin el camposignature, canonicalizada con la RFC 8785 (JSON Canonicalization Scheme), y exige que el receptor la verifique con la clave publicada del actor antes de procesar la actividad interna. Artist Alley todavía no lo hace: envía un bloque de firma de marcador de posición, y el receptor solo comprueba que el bloque esté presente y nombreEd25519. Hasta que llegue, las actividades se autentican por instancia, no por actor, y la firma incrustada no da ninguna garantía de retransmisión, almacenamiento ni reproducción de auditoría. - Análisis estricto (implementado en parte). La especificación exige
que los campos desconocidos se rechacen, no que se ignoren en silencio.
El analizador de Artist Alley rechaza los campos desconocidos dentro de
los bloques
signatureyencryption, pero actualmente conserva los campos desconocidos de nivel superior en lugar de rechazarlos. - Entrega. Los sobres se envían con
POSTal inbox de un destinatario (POST /federation/inbox), con una variante por lotes (POST /federation/inbox/batch) para colas con más de una actividad pendiente por par.
Confianza y compartición
Sección titulada «Confianza y compartición»Esta es la propiedad de seguridad sobre la que descansa todo. Emparejar un par establece un canal de confianza, nada más. No comparte ningún post, colección, espacio de trabajo, kit de marca ni comentario. Tras el emparejamiento, ambas instancias simplemente se conocen y pueden autenticar las solicitudes firmadas de la otra.
Cada objeto compartido es una aceptación explícita y aparte. Para
compartir un objeto con un par emparejado (o con un usuario concreto de
él), el propietario del objeto o un administrador concede un recurso
compartido, lo que emite una actividad aa:Share con un alcance (como
view, comment o annotate) y una caducidad opcional. La instancia
emisora entrega entonces las actividades sobre ese objeto solo a los pares
con los que se ha compartido; hoy esa entrega cubre solo posts. Una
concesión todavía no envía el objeto en sí: la instancia receptora registra
el aa:Share sin actuar sobre él, y el envío de assets y posts está
previsto. La especificación también exige que la instancia receptora
rechace las actividades sobre objetos para los que el par emisor no tiene
ninguna concesión; Artist Alley todavía no aplica esa comprobación de
entrada. El modelo es un canal privado entre dos estudios emparejados, no
el fediverso abierto.
Los niveles de confianza describen lo que puede transportar el canal:
connected (el nivel estándar), directory-listed (opta por un
directorio de descubrimiento opcional) y auto-sync (compartición
automática basada en políticas, por adhesión, dentro de un mismo dominio de
confianza). Hoy el nivel es una etiqueta: el protocolo de emparejamiento
establece connected, un administrador puede establecer cualquiera de los
tres, y Artist Alley se comporta igual sea cual sea el que esté
establecido. El descubrimiento por directorio funciona aparte del nivel:
una instancia puede suscribirse a directorios de descubrimiento y puede
pedir figurar en uno tras demostrar su dominio con un registro DNS. Las
políticas de auto-sync no están implementadas.
Federación direccionada por contenido (prevista)
Sección titulada «Federación direccionada por contenido (prevista)»En el diseño del protocolo, toda referencia a los bytes de un asset usa una URI direccionada por contenido:
cas://<sha256>?content-type=image/png&size=12345En ese diseño, el par receptor comprueba primero el almacenamiento local (si el SHA-256 ya está presente, no hay transferencia) y, si no, obtiene los bytes del origen con una solicitud firmada y los guarda en caché, de modo que los bytes idénticos se almacenan una sola vez por instancia. Artist Alley todavía no transfiere bytes de assets entre instancias; es trabajo previsto (#72).
Cifrado
Sección titulada «Cifrado»El nivel de cifrado es ortogonal al nivel de confianza. Según la política
del emisor de la especificación, la carga útil de una actividad va dentro
de un bloque encryption NaCl-box, dirigido a la clave publicada del
actor destinatario, siempre que el emisor pueda cifrar: el par ha
negociado la compatibilidad con el cifrado y la clave de cifrado del
destinatario está disponible. Las actividades sobre contenido de nivel
restricted y embargo solo se envían de esa manera; si el emisor no
puede cifrar para un destinatario, no envía nada a ese destinatario en
lugar de recurrir al texto sin cifrar. Las actividades sobre contenido de
nivel public y team se envían en texto sin cifrar en ese caso.
Artist Alley aplica la regla de cifrar cuando es posible a todo lo que
envía. Hoy solo envía actividades sobre posts y las trata como de nivel
public, así que todavía no se llega a la negativa para el contenido
restringido y bajo embargo. En la recepción, rechaza una actividad sin
cifrar sobre un asset local cuyo nivel exige cifrado. Un límite actual: el
receptor descifra con la clave del emisor que conoce en ese momento, de
modo que un sobre sellado con una clave anterior del emisor no se
descifra. Consulta el
ADR 0049 para el
diseño de la federación cifrada y su validación en uso real (dogfood).
Qué funciona hoy
Sección titulada «Qué funciona hoy»- Implementado: el emparejamiento de pares; las solicitudes al inbox con firma HTTP, verificadas al recibirlas; las concesiones de compartición, que deciden qué pares reciben las actividades sobre un post; los «me gusta» y los comentarios aplicados en la instancia receptora; el cifrado de la carga útil cuando el par y el destinatario lo admiten; la entrega al inbox individual y por lotes; la suscripción a directorios de descubrimiento y la solicitud de figurar en uno.
- En el vocabulario, todavía sin efecto: la instancia receptora acepta
y registra las acciones de revisión (
aa:Approve,aa:RequestChanges,aa:MarkReviewed), las anotaciones, las transiciones de flujo de trabajo, las versiones de assets, las suscripciones, las menciones,aa:Share/aa:Unsharey los demás tipos estándar, sin aplicarlos. - Todavía no implementado: la firma y la verificación de sobres por actor; el rechazo de campos desconocidos de nivel superior; la comprobación de entrada de las concesiones de compartición; el envío de assets y posts compartidos, incluida la transferencia de assets direccionada por contenido entre instancias; la consulta del nivel de las actividades salientes, por lo que la negativa para el contenido restringido y bajo embargo no está en vigor; las políticas de auto-sync; el descifrado de sobres sellados con una clave anterior del emisor.
- No admitido: la interoperabilidad con servidores ActivityPub como Mastodon. Ninguna implementación distinta de Artist Alley ha demostrado interoperabilidad con ArchivePub.
La sección Implementation status de la especificación describe con más detalle las carencias de firma, análisis, concesiones de compartición, CAS y claves de cifrado.
Sigue leyendo
Sección titulada «Sigue leyendo»- ADR 0043 - Federation walled-garden protocol: la decisión sobre el protocolo: forma, sobre, modelo de confianza, transporte.
- ADR 0049 - Encrypted federation & dogfood: el sobre de cifrado de extremo a extremo y su validación.
- ADR 0044 - Activities ledger (CQRS-lite): cómo se registran y se proyectan las actividades localmente.
- ADR 0042 - Distributed catalogs, typed per package: dónde viven los catálogos de tipos de actividad y de niveles de confianza.
- ADR 0007 - Federation, thinking ahead: el trabajo previo sobre el esquema (sustituido por el ADR 0043).
- Libro blanco: por qué la federación es una capacidad de primer orden y no algo que se piensa después.