Registro de auditoría (audit log)
Última actualización
Un registro de auditoría es un registro cronológico de quién hizo qué, cuándo y sobre qué. Qué recoge uno bueno, y qué registra y conserva el de AI CodeOps.
Un registro de auditoría es un registro cronológico de las acciones relevantes para la seguridad en un sistema: quién actuó, qué hizo, sobre qué objeto, cuándo y desde dónde. Existe para que alguien pueda reconstruir después lo que pasó, ya sea para una investigación, una revisión de cumplimiento o un simple «¿quién cambió esto?».
Qué es
Cada entrada es un evento con una marca de tiempo, un actor (un usuario, una clave o el propio sistema), una acción, un objetivo y contexto como la dirección IP. Los buenos registros de auditoría son de solo anexado (append-only) desde el punto de vista de las personas auditadas, cubren los cambios administrativos además del acceso a los datos y se conservan durante un periodo definido.
Un registro de auditoría no es lo mismo que un log de aplicación. Los logs de aplicación ayudan a los ingenieros a depurar; los registros de auditoría responden a preguntas de responsabilidad y los leen los equipos de seguridad y de cumplimiento.
Por qué importa
Marcos de cumplimiento como SOC 2 e ISO 27001 esperan que puedas demostrar quién cambió accesos, claves y configuración. Cuando los agentes de IA actúan en tus sistemas, el registro también tiene que mostrar qué cambios hizo una persona y cuáles produjo una IA, y quién los aprobó.
En AI CodeOps
Abre Measure → Audit Log. Cada fila muestra When, Action, Account, Target, IP y Detail, con 50 entradas por página y filtro por acción. Algunas de las acciones registradas:
member.invited member.removed role.changed
apikey.created apikey.revoked apikey.scope.updated
provider.credential.added provider.credential.removed
policy.updated budget.updated
secret.created secret.updated secret.toggled secret.deleted
approval.decided approval.canceled
mcp_server.created mcp_server.updated mcp_server.deleted
session.code.edited session.code.created session.code.deleted
change.evidence_exported workspace.share_enabled
Las entradas session.code.* registran las ediciones que una persona hace en el código que generó una sesión, antes de que se convierta en un pull request, para que puedas distinguir las líneas escritas por la IA de las ediciones humanas. Los inicios de sesión, los cambios en la autenticación en dos pasos y la configuración de SSO se registran en la cuenta o en la organización, no en la página del espacio de trabajo.
La conservación depende del plan de la organización:
Free 7 days
Individual 30 days
Pro 90 days
Enterprise as long as the organization exists
Las entradas más antiguas se eliminan una vez al día. Para leer el registro se necesita el permiso workspace:audit.read; consulta control de acceso basado en roles.
Para tener un registro que puedas entregar a un auditor, exporta el paquete de evidencias del cambio: un registro firmado de los hallazgos, las pruebas, los votos de aprobación, las decisiones de política y las entradas de auditoría relacionadas del cambio, que puedes verificar sin conexión con la clave pública de la plataforma.
Términos relacionados
- Control de acceso basado en roles (RBAC): quién puede leer el registro y qué registra
role.changed. - Motor de políticas: cada vez que se guarda una política se crea una entrada
policy.updated. - Humano en el bucle (human-in-the-loop): las aprobaciones registradas como
approval.decided.
Preguntas frecuentes
¿Quién puede leer el registro de auditoría de AI CodeOps?
Los roles Owner, Admin y Security Admin, o cualquier rol personalizado con el permiso workspace:audit.read.
¿Cuánto tiempo se conservan las entradas de auditoría?
7 días en Free, 30 días en Individual, 90 días en Pro y, en Enterprise, mientras exista la organización.
¿Puedo exportar el registro de auditoría?
Todavía no. En la beta abierta no hay exportación. Los paquetes de evidencias te dan un registro firmado de un único cambio, y la exportación de los datos de tu cuenta incluye tus propios eventos de auditoría.