Ir al contenido

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.

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 @context es 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:Approve y aa:Asset son tipos de pleno derecho: sin degradarlos a Note / Image por 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.

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:):

TipoPropósito
aa:Share / aa:UnshareConceder / 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:AssetAmplía Document con metadatos técnicos (perfil de color, EXIF, hash del contenido, herramienta DCC de origen).
aa:Approve / aa:RequestChanges / aa:MarkReviewedAcciones de revisión federadas.
aa:AnnotationUna 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:WorkflowTransitionCambios de estado de flujo de trabajo federados.
aa:AssetVersionCambios de versión sin reenviar los bytes.
aa:Subscribe / aa:MentionSuscribirse 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.

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 POST al 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 Ed25519 incrustada, hecha por el actor emisor sobre el sobre sin el campo signature, 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 nombre Ed25519. 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 signature y encryption, pero actualmente conserva los campos desconocidos de nivel superior en lugar de rechazarlos.
  • Entrega. Los sobres se envían con POST al 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.

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=12345

En 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).

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).

  • 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:Unshare y 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.