Paquetes de evidencias firmados: la prueba de cómo se entregó el código escrito por IA
Matt · · Última actualización · 6 min de lectura · Producto
Qué incluye un paquete de evidencias de AI CodeOps, por qué lo firmamos con Ed25519 sobre JSON canónico y cómo un auditor puede verificarlo sin conexión y sin fiarse de nosotros.
En esta página
Tarde o temprano, alguien le hace una pregunta razonable a un equipo que usa IA para escribir código: ¿cómo llegó este cambio a producción? ¿Quién lo pidió, qué modelo lo escribió, quién lo revisó, qué se probó y qué se aprobó?
Las respuestas ya están en AI CodeOps. La sesión, los hallazgos de la revisión, las ejecuciones de pruebas, las aprobaciones y el registro de auditoría están todos ahí. Pero «entra en nuestra herramienta y echa un vistazo» no es una respuesta que un auditor pueda guardar, y una captura de pantalla no demuestra nada. Por eso hoy lanzamos los paquetes de evidencias: un archivo firmado por cambio que contiene las respuestas y que cualquiera puede comprobar, sin cuenta y sin tener que fiarse de nosotros.
Qué contiene un paquete
Abre Changes, elige un cambio y selecciona Download evidence pack. Obtienes un archivo JSON con:
- La tarea. El prompt que se dio a la IA, el modelo, el proveedor y el nivel, y los archivos de contexto.
- Las ejecuciones. La sesión y cada ejecución de seguimiento, con el estado, los tiempos, los tokens y el costo, además del proveedor y el modelo de cada paso de agente.
- El resultado. El resumen, la lista de archivos modificados y un hash SHA-256 del diff.
- Aprobaciones. Cada solicitud de aprobación, quién podía aprobarla y cada voto con su hora y su nota.
- Decisiones de política. Cada allow, deny o ask que tomaron las políticas del espacio de trabajo durante el cambio.
- Hallazgos y pruebas. Los hallazgos de la revisión con su triaje, y los resultados de las pruebas: superadas, fallidas, omitidas y cobertura.
- Entrega. El pull request, el despliegue y cualquier incidente vinculado al cambio.
- El registro de auditoría. Las entradas del registro de auditoría sobre cualquiera de los puntos anteriores.
- Personas. La dirección de correo electrónico que hay detrás de cada ID de cuenta del paquete, para que el archivo se entienda por sí solo.
El código en sí no está en el paquete. Fue una decisión deliberada. El código fuente suele ser lo más sensible que tiene una empresa, y un archivo de evidencias tiende a acabar reenviado por correo. El hash del diff hace de vínculo: calcula el hash del diff del pull request y, si coincide, el paquete describe exactamente ese código.
Para descargar un paquete hace falta acceso de auditoría en el espacio de trabajo. Lo tienen los roles Owner, Admin y Security Admin. Cada descarga queda registrada a su vez en el registro de auditoría, así que puedes ver quién exportó qué. La guía de paquetes de evidencias explica los detalles.
Por qué firmarlo
Un archivo JSON es fácil de editar. Si un paquete se pudiera modificar después de descargarlo, no valdría más que una hoja de cálculo que alguien rellenó a mano. La firma es lo que lo convierte en evidencia.
Cada paquete tiene tres partes: una cadena format, el payload con todo lo anterior y una signature. La firma es Ed25519 (RFC 8032) sobre el payload. Elegimos Ed25519 porque es pequeño, rápido, no tiene parámetros que se puedan configurar mal y viene incluido en las bibliotecas estándar que casi todo el mundo ya tiene, como el módulo de Node.js, Go, el paquete cryptography de Python y OpenSSL. No deberías necesitar nuestro código para comprobar lo que afirmamos.
JSON canónico
Firmar JSON tiene una trampa. Los mismos datos se pueden escribir de muchas formas: claves en otro orden, espacios de más, un salto de línea. Si firmas exactamente los bytes que enviamos, basta con que un editor de texto o una herramienta de JSON vuelva a guardar el archivo, sin mala intención, para romper la firma, y no puedes distinguir un cambio de formato de una falsificación.
Por eso firmamos la forma canónica del payload: las claves de los objetos ordenadas en todos los niveles y sin espacios en blanco. La vuelva a serializar quien la vuelva a serializar, los bytes canónicos son los mismos y la firma sigue siendo válida. La función canónica ocupa unas diez líneas:
const canonical = (v) =>
v === null || typeof v !== "object"
? JSON.stringify(v)
: Array.isArray(v)
? `[${v.map(canonical).join(",")}]`
: `{${Object.keys(v)
.sort()
.map((k) => `${JSON.stringify(k)}:${canonical(v[k])}`)
.join(",")}}`
Verificar un paquete
Hay dos formas.
En el navegador. Abre /evidence/verify y elige el archivo. No hace falta ninguna cuenta. La página te dice si la firma es válida, qué clave lo firmó, a qué cambio se refiere y cuándo se generó.
Sin conexión. Esta es la que importa en una auditoría, porque no te pide que te fíes de nuestro verificador. Nuestras claves públicas están publicadas en /api/evidence?action=keys. Guárdalas una vez y después ejecuta sobre el paquete un breve script de Node.js, que está en la guía. El script canonicaliza el payload, busca la clave que nombra el paquete y comprueba la firma con node:crypto. Si alguien ha cambiado un solo carácter del payload, imprime «NOT VERIFIED».
Además, ejecutamos ese mismo script de la guía en nuestras propias pruebas, contra un paquete real firmado. Si algún día el código y la documentación no coinciden, fallan nuestras pruebas, no tu auditoría.
Las claves y cuánto tiempo siguen siendo válidos los paquetes
Cada paquete nombra la clave que lo firmó mediante un ID de clave: los primeros 16 caracteres hexadecimales del SHA-256 de la clave pública. La clave privada se genera la primera vez que se usa y se guarda cifrada.
Las claves nunca se eliminan. Cuando una clave se retira, deja de firmar paquetes nuevos, pero su mitad pública sigue publicada, así que todos los paquetes que firmó se siguen verificando. Un paquete que descargues hoy debería seguir superando la comprobación dentro de muchos años.
Lo que un paquete no demuestra
Conviene ser precisos. Un paquete demuestra que AI CodeOps registró estos hechos sobre este cambio y que nadie los ha alterado desde entonces. No demuestra que el código sea correcto, ni nada sobre los pasos que ocurrieron fuera de la plataforma, como un commit que alguien subió directamente a la rama con un push. El hash del diff es la forma de comprobar que el código del pull request es el código que describe el paquete.
Dentro de esos límites, le da a un auditor algo que rara vez tiene con el código escrito por IA: un archivo por cambio que muestra todo el recorrido del prompt a producción y que se puede comprobar de forma independiente. Si trabajas en un sector regulado, la página para equipos regulados muestra cómo encajan los paquetes con el resto de los controles, la página de auditoría y RBAC describe el registro de auditoría del que se nutren, y Dónde poner las aprobaciones humanas explica las aprobaciones que registra un paquete.
Puntos clave
- Un paquete de evidencias es un archivo JSON por cambio: la tarea, las ejecuciones, las aprobaciones, las decisiones de política, los hallazgos, las pruebas, la entrega y el registro de auditoría.
- El código no está en el paquete; un hash SHA-256 del diff vincula el paquete al pull request exacto.
- Se firma con Ed25519 sobre JSON canónico, así que un cambio de formato no lo rompe y cualquier edición sí.
- Cualquiera puede verificarlo en el navegador en /evidence/verify o sin conexión con un breve script de Node.js y nuestras claves publicadas.
- Demuestra lo que registró AI CodeOps y que nadie lo ha cambiado desde entonces, no que el código sea correcto.
Relacionado
- Paquetes de evidencias
- Registros de auditoría, roles y políticas para programar con IA
- AI CodeOps para equipos en sectores regulados
- Las mejores herramientas de revisión de código con IA en 2026: una comparativa honesta
- Por qué cada cambio de la IA en AI CodeOps tiene que superar un control
- Alternativas a la revisión de código de Gemini Code Assist y cómo migrar
- Todo el blog