AI CodeOps

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.

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.