Registros de auditoría, roles y políticas para programar con IA
Gobierna el código de IA con registro de auditoría, roles integrados y personalizados, políticas, MFA, SSO en Enterprise y paquetes de evidencias firmados y verificables por cambio.
En AI CodeOps, la gobernanza es el conjunto de controles que rodean cada sesión de IA: los roles deciden quién puede hacer qué, las políticas deciden qué puede hacer la IA y qué necesita aprobación, el registro de auditoría recoge quién cambió qué, y cada cambio recibe un paquete de evidencias firmado. Juntos responden a las tres preguntas que hace un auditor sobre el código escrito por IA: quién lo permitió, qué hizo la IA y si puedes demostrarlo.
Qué agentes intervienen
La gobernanza se aplica a todos los agentes, así que trata del control más que del trabajo de un agente concreto:
- Políticas por agente. Una regla sobre
agent.dispatchpuede permitir, pedir aprobación o denegar el paso de un agente concreto, como el Builder o el DevOps Engineer. Una sesión que contiene un agente denegado no empieza. - Agentes del espacio de trabajo. Un espacio de trabajo puede sustituir las instrucciones y el modelo de un agente integrado en Configure, Agents, y restringir qué herramientas MCP puede llamar ese agente. La sustitución solo se aplica a los pasos de ese agente.
- Registrado por paso. Cada paso de agente se guarda con su agente, su modelo, sus tokens y su costo, y acaba en el paquete de evidencias.
Consulta el catálogo de agentes para ver qué hace cada agente integrado.
Políticas
Las políticas del espacio de trabajo deciden qué puede hacer una sesión de IA. Una regla indica una acción, un patrón de recurso opcional y una decisión:
| Acción | Qué cubre | Recurso |
|---|---|---|
workflow.dispatch | Iniciar una sesión | id del flujo de trabajo |
agent.dispatch | Ejecutar un paso de agente | id del agente |
mcp.invoke | Llamar a una herramienta MCP | servidor/herramienta |
diff.apply | Cambiar un archivo | ruta del archivo |
shell.command | Ejecutar el comando de pruebas | comando |
github.push | Abrir un pull request | propietario/repositorio |
release.deploy | Desplegar automáticamente | entorno |
Cuando coinciden varias reglas, gana la más estricta, de modo que una regla añadida más tarde nunca puede relajar en silencio una anterior. Las acciones que no pueden esperar a una persona (llamadas a herramientas MCP, comandos de pruebas y despliegues automáticos) solo admiten allow o deny. Un ajuste de confianza cubre las acciones con las que no coincide ninguna regla: trusted las permite, limited (el valor por defecto) pide una aprobación antes del pull request de una sesión, y none hace que las sesiones sean de solo lectura. El conjunto de reglas tal como lo guarda la página Policies mediante PUT /api/policies:
{
"enabled": true,
"workspaceTrust": "limited",
"rules": [
{
"id": "infra-needs-review",
"action": "diff.apply",
"resource": "infra/**",
"decision": "ask",
"description": "Infra changes need an approval"
},
{ "id": "no-auto-prod", "action": "release.deploy", "resource": "production", "decision": "deny" },
{ "id": "payments-repo", "action": "github.push", "resource": "acme/payments", "decision": "ask" }
],
"expectedVersion": 7
}
Un conjunto de reglas no válido se rechaza con la lista de todos sus problemas. Cada decisión deny y ask queda registrada.
Roles
Cada miembro tiene un rol por espacio de trabajo:
| Rol | Para qué sirve |
|---|---|
| Owner | Acceso completo, incluido nombrar a otros Owner. |
| Admin | Todo excepto nombrar Owner o cambiar el rol de un Owner. |
| Developer | Ejecutar sesiones; gestionar proyectos, programaciones, despliegues, incidentes, agentes personalizados y el triaje de hallazgos. |
| Member | Ejecutar sesiones; gestionar despliegues, incidentes y ADR. |
| Viewer | Solo lectura. No puede ejecutar sesiones ni crear claves de API. |
| Security Admin | Políticas, el registro de auditoría y las aprobaciones. Sin facturación ni secretos. |
| DevOps Admin | Proyectos, runbooks, programaciones, despliegues, incidentes y servidores MCP. No puede cambiar modelos ni proveedores. |
| Billing Admin | Facturación, presupuesto y uso. Sin acceso al código, a los secretos ni a los miembros. |
| Secret Manager | Solo los secretos del espacio de trabajo. |
Solo un Owner puede asignar un rol que conlleve derechos administrativos, y un espacio de trabajo nunca puede quedarse sin su último Owner. Los roles personalizados (Enterprise) se construyen con los mismos permisos, en Settings, Roles & Permissions. Consulta miembros y roles.
Controles de calidad implicados
- Aprobaciones. Todo cambio de la IA necesita la aprobación de alguien autorizado a decidirlo, por defecto los roles Owner, Admin y Security Admin. La persona que inició la sesión no puede dar el voto de aprobación mientras exista otro aprobador en el espacio de trabajo; un espacio de trabajo de una sola persona puede autoaprobar. Un rechazo pone fin a la solicitud. Se pueden designar equipos como aprobadores.
- Retenciones por política. Un ask sobre el inicio de un flujo de trabajo abre una aprobación, y la sesión espera. Un ask sobre archivos o sobre el repositorio retiene el pull request hasta que se aprueba.
- Fallo en cerrado. Si la política no se puede cargar, la sesión no empieza.
La página de controles de calidad explica cómo se combinan las aprobaciones, las pruebas y los hallazgos.
Registro de auditoría
El Audit Log (registro de auditoría, en Measure) recoge quién cambió qué: miembros y roles, claves de API y sus alcances, políticas y decisiones de aprobación, secretos, claves de proveedor, presupuestos, servidores MCP, agentes, programaciones, personas que editan el código de una sesión de IA y descargas de paquetes de evidencias. Cada entrada guarda la hora, la cuenta, la acción, el destino, la dirección IP, el user agent y una breve descripción. Los intentos rechazados o fallidos también se registran. Para leerlo hace falta acceso de auditoría. Cuánto tiempo se conservan las entradas depende de tu plan; en Enterprise se conservan indefinidamente. Todavía no hay exportación a CSV.
Seguridad del inicio de sesión
- Autenticación en dos pasos con una aplicación de autenticación o una passkey, además de códigos de recuperación. Los roles Owner y Admin, y los roles que gestionan ajustes sensibles, deben usarla.
- Inicio de sesión único con SAML 2.0 u OIDC en Enterprise, después de verificar tu dominio de correo electrónico.
- Claves de API con alcance limitado por permisos, rangos de IP, límite de peticiones y caducidad. Una clave actúa como el miembro que la creó, con el rol actual de ese miembro.
Paquetes de evidencias firmados
Cada cambio tiene un botón Download evidence pack. El paquete JSON recoge la tarea, los modelos y niveles usados, los tokens y el costo de cada ejecución, las aprobaciones y los votos, las decisiones de política, los hallazgos y su triaje, los resultados de las pruebas, el pull request, el despliegue y cualquier incidente, y las entradas de auditoría sobre todo ello. El código en sí no se incluye; un hash SHA-256 del diff vincula el paquete con el pull request. El paquete se firma con Ed25519, y cualquiera puede comprobarlo en /evidence/verify sin una cuenta. Consulta paquetes de evidencias.
Preguntas frecuentes
¿Puedo exportar el registro de auditoría?
Todavía no como CSV. Puedes leerlo mediante la API JSON, y el paquete de evidencias de cada cambio incluye las entradas de auditoría sobre ese cambio.
¿Los roles personalizados están disponibles en todos los planes?
No. Los roles personalizados son una función de Enterprise. Todos los planes tienen los roles integrados.
¿AI CodeOps admite el aprovisionamiento SCIM?
No. El SSO de Enterprise crea las cuentas en el primer inicio de sesión con un rol por defecto que tú eliges. SCIM no está disponible.
¿Puede alguien verificar un paquete de evidencias sin una cuenta de AI CodeOps?
Sí. Cualquiera puede comprobar un paquete en /evidence/verify, o sin conexión con las claves públicas publicadas y un breve script de Node.js.
¿Se registran las ediciones que las personas hacen en el código escrito por IA?
Sí. Cuando alguien edita, añade o elimina un archivo en el cambio de una sesión de IA, la edición se anota en el registro de auditoría y cualquier aprobación de ese cambio vuelve a pendiente.
¿Puedo probar una política antes de aplicarla?
Sí. Con la política desactivada no se aplica nada, pero cada decisión que habría tomado se registra igualmente, así que puedes ver qué bloquearía una regla.