Registros de auditoría
Revisa un historial que solo permite agregar entradas y deja evidencia de alteraciones en las acciones que cambian el estado de tu organización: quién hizo qué, cuándo y desde dónde.
Los registros de auditoría ofrecen una cronología que puedes consultar y filtrar con las acciones administrativas compatibles de tu organización, como asignaciones de roles, cambios en motores y emisión de claves de API. Consulta las limitaciones de cobertura. Están disponibles en el plan Enterprise, junto con Roles y permisos.
A nivel de base de datos, el registro solo permite agregar entradas: la conexión de la aplicación no puede actualizar, eliminar ni truncar las filas de auditoría. Lo que se registra queda registrado.
Qué se registra #
Cada evento registra el actor, la acción, la entidad afectada y el contexto HTTP en el que se recibió la solicitud.
| Campo | Notas |
|---|---|
| Actor | El usuario o la clave de API que realizó la acción |
| Acción | Un valor con un tipo definido, como engine.created o member.role_changed |
| Entidad afectada | La entidad sobre la que se actuó (por ejemplo, un motor, un rol o una entrada del glosario) |
| Metadatos | IDs de entidades relacionadas: nunca nombres, correos electrónicos ni fragmentos de contenido |
| Contexto de la solicitud | request_id, dirección IP y agente de usuario: se registran cuando la llamada se recibe por HTTP |
| Marca de tiempo | UTC, más un número de secuencia monótono para detectar saltos |
Solo IDs, por diseño
La columna de metadatos almacena IDs, no valores legibles para las personas. Al consultar los datos, la interfaz los vincula con los nombres actuales, de modo que cambiar el nombre de un motor o usuario no reescribe el historial. Esto también evita conflictos entre las filas de auditoría y el derecho de supresión del GDPR: no hay contenido que ocultar.
Acciones cubiertas #
Los eventos se agrupan en categorías que coinciden con las del filtro del panel.
| Categoría | Acciones implementadas actualmente |
|---|---|
| Organización | org.created, org.settings_updated, org.deleted |
| Miembros | member.invited, member.removed, member.role_changed |
| Roles | role.created, role.updated, role.deleted |
| Motores | engine.created, engine.updated, engine.deleted |
| Claves de API | api_key.created, api_key.revoked |
| Contenido | glossary_item.*, instruction.*, brand_voice.* (solo operaciones individuales) |
Cómo acceder al registro #
La opción Registro de auditoría siempre aparece en Configuración, dentro de Administración. Sin el derecho correspondiente, la página muestra "El registro de auditoría no está disponible en tu plan" en lugar de la cronología. Allí encontrarás:
- Lista con filtros: acota los resultados por Acción, Actor y Período (una opción predefinida como Últimos 7 días, o un rango de fechas Desde / Hasta). No se pueden seleccionar fechas futuras.
- Cargar eventos anteriores: los eventos más recientes aparecen primero; haz clic en Cargar eventos anteriores al final de la lista para cargar la siguiente página.
- Detalle del evento: haz clic en cualquier fila para expandirla en el mismo lugar y ver todos los metadatos, el ID de la solicitud, la IP y el agente de usuario.
- Vistas para compartir: los filtros y el evento abierto se reflejan en la URL, así que puedes compartir cualquier vista.
Quién puede ver el registro #
Dos requisitos controlan el acceso a la página:
- Derecho: la función de registros de auditoría debe estar habilitada para la organización (plan Enterprise).
- Permiso: el rol de quien consulta el registro debe incluir
org:view_audit_logs. El rol Acceso completo, creado de forma predeterminada, incluye este permiso; los propietarios siempre lo tienen.
Los miembros sin el permiso ven una página de "sin acceso" en lugar de la cronología. Los miembros de una organización sin el derecho correspondiente ven una pantalla que exige contratar un plan de pago.
Si tu plan Enterprise vence
Los registros de auditoría están sujetos al mismo derecho de RBAC. Los eventos anteriores permanecen en la base de datos, pero la página muestra "El registro de auditoría no está disponible en tu plan" y los endpoints de lectura devuelven 403 hasta que se restablezca el plan.
Evidencia de alteraciones #
Los registros de auditoría no son solo un historial: también son difíciles de alterar una vez registrados.
- Solo se pueden agregar entradas a nivel de base de datos. La migración que instala la tabla ejecuta
REVOKE UPDATE, DELETE, TRUNCATEsobre el rol de la API. Postgres rechaza cualquier ruta de ejecución futura —un error, un nuevo endpoint o incluso una inyección SQL— antes de que pueda modificar una fila. - Secuencia monótona. Cada fila contiene una columna
seqcon valores estrictamente crecientes. Al revisar la secuencia, quien realiza la auditoría puede detectar eliminaciones por los saltos en la numeración.
Esto es suficiente para controles de tipo SOC 2. No protege contra un atacante con credenciales de acceso directo a la base de datos de producción; puedes solicitar medidas de protección más sólidas (un rol de propietario separado o una réplica WORM).
Retención #
De forma predeterminada, los eventos de auditoría se conservan indefinidamente. Los períodos de retención personalizados —normalmente de 1, 3 o 7 años— están disponibles en Enterprise. Contáctanos si necesitas una política de retención específica para cumplir requisitos normativos o responder cuestionarios de seguridad.
Qué no se cubre #
Estas son algunas limitaciones intencionales de la v1 que debes tener en cuenta:
- Emisión no garantizada ni transaccional. La emisión transaccional está prevista a corto plazo. El evento de auditoría se registra después de la acción que describe, no dentro de la misma transacción de base de datos. En casos poco frecuentes (cuando una acción se completa correctamente, pero luego falla la inserción del evento de auditoría), la acción puede ocurrir sin que se registre el evento correspondiente.
- Algunos tipos de acciones aún no están implementados. Los cambios en los miembros de los motores, la conexión / actualización / desconexión de integraciones, los cambios en la configuración de modelos, los cambios en las suscripciones de facturación y las operaciones masivas de contenido (carga de CSV,
createMany/updateMany/deleteMany) aún no generan eventos. El vocabulario de acciones ya está reservado para que estas aparezcan en las categorías de filtro existentes una vez que se implementen. - Las lecturas no se auditan. Consultar el propio registro de auditoría, explorar los registros de solicitudes del motor o descargar un glosario no genera eventos. Solo los generan las acciones que cambian el estado.
- Aún no hay exportaciones. Los datos de auditoría se muestran en el panel. La exportación a CSV, un webhook para SIEM y una réplica en S3 están previstos; avísanos si los necesitas.
- No hay una vista por motor. Todos los eventos de auditoría de la organización se muestran en una sola cronología. Filtra por acción o actor para acotar los resultados.
- No hay seguimiento en tiempo real. No hay un botón Actualizar ni un flujo de WebSocket: vuelve a cargar la página para ver los eventos más recientes.