Registros de auditoría
Revisa un historial inmutable que permite detectar manipulaciones en las acciones que modifican 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 de las acciones administrativas admitidas en tu organización, con opciones de búsqueda y filtrado. Incluyen la asignación de roles, la edición de motores y la emisión de claves de API. Consulta las limitaciones de cobertura. Están disponibles con el plan Enterprise, junto con Roles y permisos.
En la base de datos, el registro solo permite añadir entradas: la conexión de la aplicación no puede actualizar, eliminar ni truncar las filas de auditoría. Lo que se escribe queda registrado para siempre.
Qué se registra #
Cada evento recoge el actor, la acción, el destino 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 tipado, como engine.created o member.role_changed |
| Destino | La entidad sobre la que se actuó (p. ej., 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 recogen cuando la llamada llega por HTTP |
| Marca de tiempo | UTC y 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. La interfaz los vincula con los nombres actuales al consultar los datos, por lo que cambiar el nombre de un motor o de un usuario no reescribe el historial. Así se evitan también conflictos entre las filas de auditoría y el derecho de supresión del RGPD: no hay contenido que suprimir.
Acciones cubiertas #
Los eventos se agrupan en categorías que coinciden con las del filtro del panel.
| Categoría | Acciones registradas 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 aparece siempre en Configuración, dentro de Administración. Si la función no está habilitada para tu organización, la página muestra "El registro de auditoría no está disponible en tu plan" en lugar de la cronología. Dentro encontrarás:
- Lista con filtros: filtra por Acción, Actor y Periodo (un intervalo predefinido como Últimos 7 días, o un intervalo de fechas Desde / Hasta). No se permiten fechas futuras.
- Cargar eventos anteriores: los eventos más recientes aparecen primero; haz clic en Cargar eventos anteriores, al pie de la lista, para cargar la siguiente página.
- Detalles del evento: haz clic en cualquier fila para desplegarla y ver todos los metadatos, el ID de la solicitud, la IP y el agente de usuario.
- Vistas que puedes compartir: los filtros y el evento abierto se reflejan en la URL, por lo que puedes compartir cualquier vista.
Quién puede verlo #
El acceso a la página depende de dos requisitos:
- Acceso a la función: 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 predefinido Acceso completo lo incluye por defecto; los propietarios siempre lo tienen.
Los miembros que no tienen el permiso ven una página de "sin acceso" en lugar de la cronología. Si la organización no tiene habilitada la función, sus miembros ven una pantalla de acceso de pago.
Si tu plan Enterprise deja de estar activo
Los registros de auditoría comparten las condiciones de acceso del nivel 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 puntos de acceso de lectura devuelven 403 hasta que se restablece el plan.
Detección de manipulaciones #
Los registros de auditoría no son solo un historial: están diseñados para que resulte realmente difícil alterarlos a posteriori.
- En la base de datos solo se pueden añadir entradas. La migración que crea la tabla ejecuta
REVOKE UPDATE, DELETE, TRUNCATEsobre el rol de la API. Postgres rechaza cualquier vía de ejecución futura —un error, un nuevo punto de acceso o incluso una inyección SQL— antes de que pueda modificar una fila. - Secuencia monótona. Cada fila incluye una columna
seqcuyo valor aumenta estrictamente. Al revisar la secuencia, un auditor puede detectar eliminaciones por los saltos que dejan.
Esto es suficiente para controles de tipo SOC 2. No protege frente a un atacante con credenciales de acceso directo a la base de datos de producción; hay medidas de protección más estrictas (un rol de propietario independiente o una réplica WORM) disponibles bajo petición.
Conservación #
Los eventos de auditoría se conservan indefinidamente por defecto. Los periodos de conservación personalizados —normalmente de 1, 3 o 7 años— están disponibles con Enterprise. Ponte en contacto con nosotros si necesitas una política de conservación específica para cumplir requisitos normativos o responder a cuestionarios de seguridad.
Qué no se cubre #
Estas son algunas limitaciones deliberadas de la v1 que conviene conocer:
- Emisión con el mejor esfuerzo posible, no transaccional. La emisión transaccional está prevista a corto plazo. El evento de auditoría se escribe después de la acción que describe, no dentro de la misma transacción de base de datos. En casos excepcionales de fallo (una acción se completa correctamente y después falla la inserción de auditoría), la acción puede realizarse sin que exista un evento correspondiente.
- Algunos tipos de acciones aún no se registran. Los cambios en los miembros de un motor, la conexión, actualización o desconexión de integraciones, las modificaciones de 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. Los nombres de estas acciones ya están reservados para que aparezcan en las categorías de filtro existentes cuando se habilite su registro. - Las lecturas no se auditan. Consultar el propio registro de auditoría, explorar los registros de solicitudes de un motor o descargar un glosario no genera eventos. Solo los generan las acciones que modifican el estado.
- Aún no hay exportaciones. Los datos de auditoría se consultan a través del panel. La exportación a CSV, un webhook para SIEM y una réplica en S3 están previstos; dinos si los necesitas.
- No hay una vista por motor. Todos los eventos de auditoría de la organización se muestran en una única cronología. Filtra por acción o actor para acotar los resultados.
- No hay seguimiento en tiempo real. No hay botón de Actualizar ni flujo WebSocket: recarga la página para ver los eventos más recientes.