Cloudflare propone un método para que los agentes de IA auditen código en busca de vulnerabilidades

Cloudflare ha publicado Security Audit Skill, una herramienta de código abierto que permite a los agentes de programación con inteligencia artificial realizar auditorías de seguridad mediante un proceso dividido en seis fases. El sistema organiza la inspección del código, contrasta los posibles fallos con verificaciones independientes y clasifica los resultados para reducir los falsos positivos antes de incorporarlos a un informe.

Las claves de las auditorías de seguridad con IA en 30 segundos

  • Cloudflare ha publicado una habilidad para que los agentes de programación participen en auditorías de seguridad de repositorios.
  • El proceso se divide en seis fases, desde el reconocimiento de la arquitectura hasta la elaboración de informes.
  • Cada vulnerabilidad candidata debe superar una comprobación independiente que intente refutarla.
  • Los resultados se clasifican como confirmados, pendientes de validación o rechazados.
  • La herramienta incorpora validadores sin dependencias externas y permite repetir auditorías para buscar problemas que hayan quedado sin detectar.

La propuesta responde a uno de los problemas de utilizar modelos de inteligencia artificial para revisar código: encontrar patrones sospechosos no significa necesariamente haber descubierto una vulnerabilidad. Un agente puede señalar una función aparentemente insegura sin demostrar que un atacante pueda alcanzar ese punto, superar las comprobaciones existentes y provocar un resultado explotable.

Security Audit Skill intenta reducir esa distancia entre la sospecha y la evidencia. En lugar de pedir a un único agente que examine un repositorio y entregue una lista de posibles problemas, estructura el trabajo en varias etapas y asigna tareas de revisión a agentes independientes. El objetivo es que cada hallazgo tenga una justificación verificable y que los informes distingan los fallos demostrados de los asuntos que todavía necesitan pruebas.

Seis fases para pasar de una sospecha a un hallazgo verificable

La primera fase consiste en reconocer la arquitectura del proyecto. El sistema analiza la organización del código, los límites de confianza, los puntos de entrada y las superficies expuestas, además de revisar evidencias anteriores y determinar qué partes del repositorio están cubiertas por la auditoría.

Esta etapa genera dos archivos: architecture.md, que recoge información sobre la arquitectura, y coverage-ledger.json, un registro estructurado de las unidades que deben inspeccionarse. Este segundo documento permite seguir qué zonas del código se han revisado y cuáles siguen pendientes.

Después comienza la búsqueda guiada por cobertura. Varios agentes independientes pueden inspeccionar distintas unidades del registro, mientras que otros revisan si quedan huecos en la cobertura. La separación del trabajo permite examinar diferentes partes del proyecto sin depender de una única lectura global del repositorio.

La tercera fase introduce una comprobación adversarial. Cada posible vulnerabilidad pasa por un verificador nuevo que intenta refutarla. La idea es que el sistema no acepte automáticamente la primera explicación que encuentra un agente, sino que busque evidencias que demuestren que el problema no es explotable o que las protecciones existentes impiden el escenario descrito.

Esta validación resulta especialmente relevante en auditorías asistidas por IA. Los modelos pueden interpretar de forma incorrecta el flujo de datos, pasar por alto controles de acceso o confundir una condición teóricamente peligrosa con un fallo que realmente pueda aprovecharse. Una segunda revisión independiente no elimina todos esos riesgos, pero obliga a justificar mejor cada resultado.

La cuarta fase convierte los hallazgos en datos estructurados. El sistema utiliza tres estados: confirmed, needs_validation y rejected. Los resultados se almacenan en findings.json y se contrastan con el esquema definido en report-schema.json.

La quinta fase vuelve a revisar las afirmaciones relacionadas con el código fuente. Nuevos agentes comprueban de manera independiente que las referencias y explicaciones de cada registro se corresponden con el código inspeccionado. Si un cambio altera de forma material un hallazgo, la herramienta exige otra verificación.

Por último, la sexta fase genera los informes. La salida incluye REPORT.md, FINDINGS-DETAIL.md y NEEDS-VALIDATION.md, con una separación entre los resultados principales, el detalle de los hallazgos y los asuntos que todavía requieren comprobaciones.

La clasificación de resultados evita presentar sospechas como vulnerabilidades

Uno de los aspectos más importantes de Security Audit Skill es la diferencia entre los tres estados que puede asignar a un hallazgo.

confirmed se reserva para problemas con trazabilidad completa hasta el código fuente y un resultado observado que demuestra el fallo dentro de los límites descritos. La herramienta pretende evitar que una explicación plausible se convierta en una vulnerabilidad confirmada sin pruebas suficientes.

needs_validation identifica un hecho concreto que todavía necesita comprobación. No recibe una clasificación de severidad mientras siga pendiente de validación. De esta manera, el informe puede conservar información útil sin presentarla como un fallo demostrado.

rejected recoge los candidatos que la revisión ha conseguido refutar. Esta categoría permite dejar constancia de las comprobaciones realizadas y evitar que una misma sospecha vuelva a aparecer como un descubrimiento nuevo en revisiones posteriores.

Cloudflare también incluye dos validadores que funcionan sin dependencias externas: validate-findings.cjs y validate-coverage-ledger.cjs. El primero comprueba la estructura y consistencia de los hallazgos, mientras que el segundo revisa el registro de cobertura.

La herramienta también distingue entre una vulnerabilidad y una carencia de defensa en profundidad. Que un sistema carezca de una protección adicional no significa automáticamente que exista un fallo explotable. Para confirmar una vulnerabilidad, el proceso exige demostrar que se rompe un límite de seguridad y que el resultado observado encaja con el problema descrito.

Esta separación ayuda a que los informes de auditoría sean más útiles para los equipos de desarrollo. Una lista extensa de advertencias puede generar trabajo innecesario si mezcla fallos reales, recomendaciones generales y sospechas que no han superado una validación.

Auditorías repetidas, agentes paralelos y ejecución aislada

Security Audit Skill contempla que una auditoría no termine necesariamente con una única ejecución. Las revisiones sucesivas sobre el mismo repositorio pueden utilizar los registros y hallazgos anteriores para buscar zonas que hayan quedado sin cubrir y volver a comprobar las partes del código que han cambiado.

El sistema trata estas ejecuciones como acumulativas. Las evidencias antiguas no se consideran automáticamente válidas para el código actual, y los asuntos pendientes no cuentan como cobertura completada. Así, una nueva revisión puede concentrarse en las modificaciones recientes sin perder el seguimiento de los resultados anteriores.

La herramienta está pensada para agentes de programación capaces de utilizar herramientas y ejecutar tareas con subagentes en paralelo. También necesita Node.js para sus validadores. La descripción del proyecto no presenta el proceso como una función que cualquier chatbot pueda ejecutar por sí solo: requiere un entorno de agente con capacidad para inspeccionar el repositorio y realizar las comprobaciones necesarias.

La seguridad del entorno de ejecución es otro requisito importante. Cloudflare recomienda utilizar un aislamiento impuesto por el sistema operativo para las compilaciones, pruebas, procesos, navegadores, emuladores, herramientas de fuzzing y otros elementos controlados por el código auditado.

Ese entorno debe bloquear el acceso a redes externas, utilizar un entorno saneado, limitar los recursos disponibles y restringir las escrituras a directorios temporales asignados. Si no se dispone de estas medidas, los hallazgos afectados deben permanecer en needs_validation y el sistema no debe ejecutar código del objetivo.

La salida se guarda por defecto en ~/security-audit-skill/ dentro de un directorio asociado al repositorio y a cada ejecución. Esto permite conservar los resultados de distintas auditorías y consultar cómo han cambiado las evidencias con el tiempo.

La herramienta cubre diferentes familias de problemas, desde errores de memoria, binarios y kernel hasta fallos en aplicaciones web, autenticación, protocolos, sistemas de inteligencia artificial, cadena de suministro, servicios cloud, RPC, mensajería y agotamiento de recursos. También contempla problemas relacionados con el aislamiento, el ciclo de vida de los datos y la comunicación entre procesos en aplicaciones de escritorio y móviles.

Cloudflare señala que, en sus propias pruebas, una ejecución aislada encontró aproximadamente la mitad de las vulnerabilidades detectadas al combinar varias ejecuciones. Ese resultado pertenece a las pruebas del proyecto y no debe interpretarse como una garantía de que repetir una auditoría vaya a duplicar los descubrimientos en cualquier repositorio.

La herramienta se distribuye bajo licencia MIT y puede instalarse con Skills CLI:

npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit

Para instalarla de forma global:

npx skills add https://github.com/cloudflare/security-audit-skill \
  --skill security-audit \
  --global

Una vez disponible, el agente puede recibir instrucciones como security audit this codebase o find security vulnerabilities in ./src. También se puede indicar un directorio concreto para guardar los resultados de la revisión.

La propuesta de Cloudflare ofrece una estructura más rigurosa para utilizar agentes de IA en auditorías de código. Su principal aportación está en separar la búsqueda de vulnerabilidades de su validación y exigir evidencias antes de presentar un problema como confirmado. La calidad final seguirá dependiendo del agente utilizado, del repositorio, de las pruebas disponibles y del aislamiento del entorno, pero el método permite organizar el trabajo y revisar con más precisión qué ha encontrado realmente la inteligencia artificial.

Preguntas frecuentes

¿Qué es Cloudflare Security Audit Skill?

Es una herramienta de código abierto que organiza auditorías de seguridad de repositorios mediante agentes de programación con inteligencia artificial. Divide el proceso en seis fases y genera informes estructurados.

¿Cómo evita los falsos positivos en las auditorías con IA?

Cada vulnerabilidad candidata pasa por una revisión independiente que intenta refutarla. Además, el sistema distingue entre problemas confirmados, asuntos pendientes de validación y candidatos rechazados.

¿Qué necesita Security Audit Skill para funcionar?

Necesita un agente de programación con capacidad para utilizar herramientas y trabajar con subagentes en paralelo, además de Node.js para ejecutar sus validadores. También requiere un entorno aislado para realizar pruebas de forma segura.

¿Es gratuita la herramienta de Cloudflare?

El proyecto se distribuye bajo licencia MIT y puede instalarse mediante Skills CLI desde su repositorio de GitHub.

Scroll al inicio