- Inicio
- Documentación
- Paquetes de evidencias
Paquetes de evidencias
Descarga un registro firmado de cómo se hizo un cambio (tarea, modelos, aprobaciones, hallazgos, pruebas, entrega) y verifícalo en el navegador o sin conexión.
Un paquete de evidencias es un registro firmado de cómo se hizo un cambio en AI CodeOps. Es para auditores, revisiones de cumplimiento y clientes que necesitan mostrar cómo llegó a producción el código escrito por IA.
Qué contiene un paquete
Para un cambio (Develop → Changes, y después un cambio):
- 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, los archivos modificados y un hash SHA-256 del diff. El código en sí no se incluye; el hash te permite cotejarlo con el pull request.
- Aprobaciones: cada solicitud de aprobación, quién la pidió (en la aprobación propia de una sesión, el miembro que lanzó la sesión), quién podía aprobar (
eligibleApprovers: los aprobadores que nombraba y los roles autorizados a decidir), quién aprobó o rechazó (approvedByyrejectedBy) y cada voto (votes). - Cada voto:
votestiene una entrada por voto, en el orden en que se emitieron: la cuenta del votante (accountID), su rol en el espacio de trabajo (role), el voto (approveoreject), la hora (decidedAt) y la nota.roleAsOfindica de qué fecha es el rol:votees el rol registrado cuando se emitió el voto;exportes el rol que tenía cuando se generó el paquete, y se usa para los votos emitidos antes de que se registraran los roles, ynullsi el votante ha dejado desde entonces el espacio de trabajo.selfApprovales true cuando el votante aprobó un cambio que lanzó él mismo, yselfApprovalAllowedBydice por qué se permitió.gateOverridelleva el motivo que dio el votante, y lo que dijo la comprobación de publicación, cuando aprobó un cambio cuya comprobación de publicación estaba fallando. La listadecisionssin procesar sigue ahí, sin cambios. Las dos contienen solo la ronda actual: cuando una aprobación se reabre, por ejemplo después de editar un cambio aprobado, se vacían, y los votos anteriores siguen en la secciónauditdel paquete como entradasapproval.decided. - 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, 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.
Descargar un paquete
Abre Changes, elige un cambio y selecciona Download evidence pack. Necesitas acceso de auditoría en el espacio de trabajo: lo tienen los roles Owner, Admin y Security Admin. Cada descarga queda anotada en el registro de auditoría del espacio de trabajo.
Verificar un paquete en el navegador
Abre /evidence/verify y elige el archivo. No hace falta ninguna cuenta. La página te dice si la firma coincide y qué clave lo firmó.
Verificar un paquete sin conexión
No tienes que fiarte de nuestro verificador. La signature del paquete es Ed25519 sobre el JSON canónico de su payload: las claves de los objetos ordenadas en todos los niveles, sin espacios en blanco. Las claves públicas de la plataforma están en /api/evidence?action=keys. Con Node.js 20 o posterior:
// verify-evidence.mjs <pack.json> <keys.json>
import { readFileSync } from "node:fs"
import { createPublicKey, verify } from "node:crypto"
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(",")}}`
const pack = JSON.parse(readFileSync(process.argv[2], "utf8"))
const { keys } = JSON.parse(readFileSync(process.argv[3], "utf8"))
const key = keys.find((k) => k.kid === pack.signature.kid)
if (!key) throw new Error(`unknown key ${pack.signature.kid}`)
const ok = verify(
null,
Buffer.from(canonical(pack.payload)),
createPublicKey(key.publicKey),
Buffer.from(pack.signature.value, "base64url"),
)
console.log(ok ? "VERIFIED" : "NOT VERIFIED: the pack was altered")
Guarda las claves una vez y después ejecuta el script:
curl -o keys.json "https://console.aicodeops.dev/api/evidence?action=keys"
node verify-evidence.mjs evidence-chg_....json keys.json
Claves y rotación
Las claves nunca se eliminan. Cuando una clave se retira, deja de firmar paquetes nuevos, y los paquetes que firmó se siguen verificando. Guarda una copia de keys.json con tus registros de auditoría si quieres una verificación que no dependa de llegar a la plataforma.
Siguientes pasos
Preguntas frecuentes
¿El paquete contiene nuestro código fuente?
No. Lista los archivos modificados y un hash SHA-256 del diff, de modo que puedes cotejarlo con el pull request sin que el código salga de tu repositorio.
¿Los paquetes antiguos se siguen verificando después de retirar una clave?
Sí. Las claves nunca se eliminan. Una clave retirada deja de firmar paquetes nuevos, y los paquetes que firmó se siguen verificando.