Seguridad en Artist Alley
Artist Alley guarda tres clases de datos valiosos: el trabajo creativo de los artistas (a menudo confidencial, a menudo sujeto a NDA), los metadatos del estudio (nombres de proyectos, comentarios internos de revisión, propiedad intelectual sin anunciar) y las credenciales del operador (autenticación, claves de API de terceros, material de firma de licencias). La postura de seguridad está construida para proteger las tres frente a la exposición accidental y frente a atacantes decididos con acceso credencial.
Esta página documenta las reglas fundamentales. Toda PR que toque una ruta de autenticación, un almacén de credenciales, una comprobación de permisos, una ruta de bytes de assets o una integración externa las sigue.
Modelo de amenazas
Sección titulada «Modelo de amenazas»Tres adversarios concretos dan forma al diseño:
- El usuario con credenciales pero sin privilegios. Un usuario con un inicio de sesión válido pero sin motivo legítimo para leer assets restringidos. Es el atacante contra el que se construye el sistema de permisos.
- La credencial filtrada. Una sesión robada, un token de API publicado, un archivo de licencia extraviado. La mitigación es la revocación y un registro de auditoría: las sesiones caducan tras un periodo de inactividad y pueden revocarse, los tokens de API pueden tener una caducidad y revocarse en cualquier momento, y los inicios de sesión y los cambios relevantes para la seguridad se auditan. Los tokens de API no caducan a menos que quien los crea establezca una caducidad, y la lista de scopes de un token todavía no limita lo que puede hacer (consulta Autenticación).
- El par / conector / add-on comprometido. Un par federado, una fuente de importación, un plugin de terceros que ejecuta código malicioso. El objetivo del diseño es que cada uno solo merezca la confianza que una decisión explícita le concede. En la federación, el emparejamiento no comparte nada: una nueva solicitud de emparejamiento espera a que un administrador acepte la clave ofrecida, y las actividades sobre un post solo van a los pares con los que se ha compartido de forma explícita. El handshake de emparejamiento inicial está autofirmado en lugar de enviarse como una petición firmada por HTTP. Quedan lagunas conocidas: los mensajes federados se autentican por instancia, no por actor, porque las firmas por actor todavía no se crean ni se verifican; una instancia receptora aún no comprueba que el remitente tenga una concesión de compartición para el objeto; y la negativa del remitente a enviar contenido restringido o bajo embargo sin cifrar aún no está conectada. Consulta Lo que funciona hoy en ArchivePub. Los add-ons están previstos, por lo que todavía no hay una frontera de aislamiento de plugins en la que apoyarse.
Fuera de alcance:
- Ataques dirigidos de un Estado. Fuera del alcance del modelo de amenazas del proyecto; los operadores con ese perfil de riesgo ejecutan su instancia tras una infraestructura aislada (air-gapped).
- Acceso físico al servidor. Si el atacante puede leer el disco, no hay garantías de confidencialidad de los datos; el cifrado de disco es responsabilidad del operador, no nuestra.
- Ataques de canal lateral contra el sistema operativo del host. Ejecución especulativa, sesgo del RNG por hardware, etc. Fuera de alcance.
Autenticación
Sección titulada «Autenticación»- Las sesiones son del lado del servidor. La tabla
sessionsguarda un resumen SHA-256 del token; el cliente recibe una cookie opaca con el valor en claro, que nunca llega a la base de datos. No hay ningún contenido de sesión legible por el cliente. - Los tokens de API son Personal Access Tokens, con el prefijo
aa_pat_: cadenas aleatorias de alta entropía. Solo su resumen SHA-256 llega aapi_tokens.token_hash; el valor en claro se muestra una única vez al crearlo y nunca se persiste, de modo que un volcado de la base de datos no revela ningún token utilizable. Un token tiene una caducidad opcional y puede revocarse en cualquier momento. También puede recibir una lista de scopes, pero los scopes se registran, todavía no se aplican: un token actúa hoy con todos los permisos del usuario que lo creó, así que trata cada token como una credencial completa de esa cuenta. Un token solo puede crearse desde una sesión de cookie; no puedes generar uno usando otro token. - Las contraseñas reciben un pepper mediante HMAC-SHA256 (con la clave
AA_SCRAMBLE_KEY) y después se hashean con bcrypt. El pepper hace que una base de datos robada por sí sola no pueda descifrarse sin conexión si no se posee también la clave de mezcla. Las contraseñas en texto plano nunca deben escribirse en registros, eventos de auditoría ni cuerpos de respuesta; cualquier ruta que lo haga es un bug. Hay una excepción deliberada para el administrador del primer arranque: cuando todavía no existe ningún administrador, el servidor genera una contraseña aleatoria, la imprime en el registro de arranque e intenta escribirla enbootstrap-admin.txtcon modo 0600. Si esa escritura falla, el registro es la única copia. Protege cualquier registro de arranque que la contenga y cambia la contraseña tras el primer inicio de sesión. - El SSO todavía no está disponible. El código incluye proveedores LDAP y SAML, pero solo se registran con una función de licencia que hoy no se puede obtener, y no hay ningún proveedor OAuth ni OIDC. Está previsto un SSO genérico para la v0.17.0 que no necesitará licencia (ADR 0066); los puentes específicos de cada proveedor (Okta / Auth0 / WorkOS) están previstos como add-ons según el ADR 0038.
Autorización
Sección titulada «Autorización»- Los códigos de capacidad son la unidad de permiso, no los nombres de rol. El código que comprueba «¿es admin este usuario?» está mal; el código que comprueba «¿tiene este usuario la capacidad
assets.delete?» está bien. - Las capacidades viven en la tabla
capabilities; los roles agrupan capacidades medianterole_capabilities; los usuarios reciben roles medianteuser_roles. Las excepciones por usuario (user_capability_grantsyuser_capability_revokes) permiten a un admin conceder o retirar una capacidad concreta sin inventar un rol puntual. - La comprobación de capacidad ocurre en la entrada del handler, no más adentro. Un método de repositorio no comprueba capacidades; lo hace el handler que lo llama. Así la frontera de confianza se mantiene visible.
Estas son las reglas que sigue el código nuevo. No garantizan que todos los endpoints existentes apliquen ya una comprobación de capacidad: algunos endpoints comprueban hoy solamente que quien llama ha iniciado sesión.
Sensibilidad de los assets
Sección titulada «Sensibilidad de los assets»Parcialmente entregado; el resto está previsto para la v0.15.0 (ADR 0020). Los assets ya llevan un nivel de sensibilidad. Un asset restringido o bajo embargo sigue apareciendo como un marcador de posición bloqueado en las páginas de posts y en las colecciones (el feed por defecto lo oculta): su título, sus campos y su miniatura se ocultan a los lectores sin acceso, que pueden solicitarlo, y las rutas que entregan el contenido del asset por ID de asset se niegan a servírselo. El desenfoque en el servidor, la acción
Revealy la tarjeta de embargo descritos a continuación están previstos.
- Nivel de sensibilidad por asset, entregado (
public/team/restricted/embargo, según el ADR 0020). El nivel se aplica en el servidor, no solo en la interfaz, mediante las rutas que entregan el contenido de un asset por ID de asset: su archivo original, sus variantes derivadas, sus flujos de vídeo y el contenido de sus archivos comprimidos solo se sirven tras comprobar el acceso de quien llama, incluido el nivel. - Previsto para la v0.15.0: desenfoque en el servidor para assets restringidos y bajo embargo. El desenfoque sería una variante de previsualización generada en el servidor, de modo que incluso una fuga por interceptación de red sin autenticar mostraría bytes desenfocados, y una acción
Reveallevantaría el desenfoque durante la sesión y escribiría un evento de auditoría. - Previsto para la v0.15.0: levantamiento del embargo mediante el motor de acciones programadas. El levantamiento sería una acción programada, registrada en la auditoría cuando se dispare.
Gestión de secretos
Sección titulada «Gestión de secretos»- Cifrado en reposo. La clave maestra del host,
AA_MASTER_KEY(obligatoria al arrancar), cifra determinados valores sensibles de la base de datos: los secretos de autenticación en dos pasos (TOTP), la identidad de federación, las claves de actor y de usuario, y la contraseña SMTP. No todos los secretos introducidos en los ajustes de administración se cifran de este modo, así que trata la base de datos y todas sus copias de seguridad como sensibles: restringe quién puede conectarse a ella y mantén las copias cifradas y con el acceso controlado. Las credenciales almacenadas nunca las devuelve la API de administración. - La rotación de la clave maestra no está soportada en la v1: no hay ninguna herramienta para volver a cifrar los valores existentes con una clave nueva, así que mantén
AA_MASTER_KEYestable y con copia de seguridad. - Los Cloudflare Worker Secrets guardarán la clave de firma Ed25519 para la emisión de los
.licde licencia (una vez que se publique la gestión de licencias, prevista para la v0.18.0, según el ADR 0017); la clave de firma nunca sale del Worker.
Registro de auditoría
Sección titulada «Registro de auditoría»- Los cambios relevantes para la seguridad escriben una fila en
audit_events: inicios de sesión (correctos, fallidos, limitados por tasa), bloqueos de cuenta, sesiones que caducan o se revocan, concesiones y retiradas de capacidades, solicitudes de acceso, acciones programadas, comparticiones de federación, borrados y restauraciones de assets por parte de un admin, cambios de configuración por parte de un admin y purgas de retención de la auditoría. El registro es de mejor esfuerzo (best-effort): una operación puede no tener entrada de auditoría si el registro falla. - Los eventos todavía no se vinculan mediante un identificador común de petición o de trabajo. Cada evento registra su tipo, su hora y metadatos propios del evento, además del actor, el sujeto, la dirección IP y el user agent cuando están disponibles. Estos pueden faltar, en particular en el trabajo que inicia el propio sistema.
- La retención de la auditoría es de 7 años por defecto. Los admins pueden exportar el registro de auditoría como CSV o JSON delimitado por saltos de línea; la exportación no está firmada. Se prevé una exportación firmada junto con el trabajo de licencias (ADR 0017).
Enlaces para compartir
Sección titulada «Enlaces para compartir»Previsto para la v0.15.0. El diseño que sigue (ADR 0018) es la postura prevista; los enlaces para compartir todavía no están publicados.
URL para compartir firmadas y con caducidad para colaboradores externos (según el ADR 0018):
- El token es un ID aleatorio de 32 bytes, no un JWT. La revocación es el borrado de una sola fila: sin rotación de claves, sin superficie de lista negra de tokens.
- Scope por enlace:
view/comment/annotate/download. El scope se aplica en el handler; saltarse el visor del enlace para llegar al endpoint canónico sigue requiriendo la capacidad correspondiente. - Contraseña opcional en el enlace, almacenada con hash. Los intentos fallidos de contraseña están limitados por tasa y se auditan.
- Registro de auditoría por acceso: IP, user agent, resultado de la contraseña, scope satisfecho. El operador puede ver quién ha usado un enlace sin contactar con el destinatario.
Tratamiento de las entradas
Sección titulada «Tratamiento de las entradas»- Decodificación de peticiones y comprobaciones en los handlers. Las peticiones se decodifican en los tipos generados a partir de la especificación OpenAPI, y un cuerpo de petición que no se puede decodificar se rechaza con un 400; más allá de eso, los handlers aplican su propia validación donde corresponda. No hay montado ningún middleware aparte de validación de esquemas OpenAPI.
- Sin concatenación de cadenas SQL. Usa las consultas parametrizadas que genera sqlc; cuando una consulta deba construirse en tiempo de ejecución, pasa los valores como parámetros en lugar de formatearlos dentro de la cadena SQL. Un
db.Exec(fmt.Sprintf(...))en bruto es motivo de bloqueo en la revisión de código. - Sin concatenación de HTML en las plantillas. El escapado automático de Svelte es la opción por defecto;
{@html ...}es motivo de bloqueo en la revisión de código y exige una justificación. - Path traversal: los archivos almacenados se direccionan por clave, no por una ruta que aporte quien llama. La capa de almacenamiento valida cada clave antes de que un backend la toque: el nombre del objeto debe ser un hash SHA-256, y una clave de variante no puede contener
.., una barra inicial ni una barra duplicada. Ambos backends de almacenamiento ejecutan esta comprobación en cada operación, así que los handlers no tienen que repetirla.
Privacidad y consentimiento
Sección titulada «Privacidad y consentimiento»Según el ADR 0024:
- Primero, borrado lógico (entregado): los assets, posts y colecciones eliminados siguen siendo recuperables durante 30 días por defecto, y los usuarios archivados durante 90 días, antes de pasar a ser aptos para el borrado definitivo. Los operadores pueden cambiar estos periodos de retención.
- El banner de cookies / rastreadores, previsto para la v0.16.0, solo se mostrará cuando se use una categoría no esencial; una instalación de estudio básica sin analítica no muestra ningún banner.
- Las herramientas DSAR, previstas para la v0.16.0: cada usuario podrá exportar sus datos personales como JSON y solicitar su eliminación; el borrado definitivo reasigna el contenido creado a un tombstone
deleted-userpara que el trabajo colaborativo sobreviva. - El acceso al registro de auditoría está a su vez sujeto a una capacidad. La lectura del registro de auditoría no se registra a su vez como un evento de auditoría.
Informar de una vulnerabilidad
Sección titulada «Informar de una vulnerabilidad»Si crees que has encontrado un problema de seguridad:
- No abras una issue pública en GitHub. Infórmalo en privado: abre un aviso de seguridad privado desde la pestaña Security del repositorio (Report a vulnerability), o escribe a
security@artist-alley.org. - Incluye los pasos para reproducirlo, la versión afectada y el impacto que has observado.
- Acusaremos recibo de tu informe y te mantendremos al tanto mientras investigamos y trabajamos en una corrección.
Todavía no tenemos un programa de bug bounty. El reconocimiento público por el informe (a tu elección, opcional) aparece en las notas de la versión de la corrección.
Lo que parece una función de seguridad pero no lo es
Sección titulada «Lo que parece una función de seguridad pero no lo es»- Anti-AdBlock. Hoy no existe ningún add-on de publicidad, y el plan no es combatir a los bloqueadores de anuncios; no entramos en una carrera armamentística contra ellos desde el núcleo AGPL.
- DRM sobre los bytes de los assets. No ciframos los bytes de los assets en reposo dentro del backend de almacenamiento más allá de lo que el propio backend ofrece (el cifrado del lado del servidor de S3 es una opción que configura el operador, no una función de Artist Alley). La entrega protegida con DRM está fuera de alcance.
- Anti-compartición de cuentas. Cuando se publique la gestión de licencias (prevista para la v0.18.0, ADR 0017), los puestos activos se contarán para la licencia, no para la vigilancia: únicamente «cuántos usuarios distintos han estado activos en los últimos 30 días»; no tomamos huellas de las sesiones ni vinculamos los inicios de sesión a un dispositivo.