AI CodeOps

Agente Security Auditor

El agente Security Auditor busca en los cambios fallos de autorización, inyección, secretos filtrados, exposición de datos y riesgos de la cadena de suministro. Está en nueve flujos integrados.

El agente Security Auditor mira un cambio como lo haría un atacante. Lo analiza en busca de riesgos de seguridad, cubriendo la autorización, la inyección, los secretos, la exposición de datos y la cadena de suministro, y enumera los hallazgos por gravedad con una corrección para cada uno.

Se ejecuta en nueve de los dieciséis flujos de trabajo integrados. En Security-Sensitive Change se ejecuta dos veces: Risk analysis antes de que se escriba el cambio, y Audit diff después de que se escriba y se pruebe.

Dónde se ejecuta

Flujo de trabajoPaso
Security-Sensitive ChangeRisk analysis, Audit diff
Parallel ReviewSecurity review
DevOps ChangeRisk review
Threat ModelSTRIDE analysis
Swarm InspectionSecurity slice
Feature SDLCSecurity review
Release ReadinessSecurity review
Dependency RefreshVerify secure
Data MigrationSecurity

Cuándo se ejecuta un paso depende de dónde está en el flujo de trabajo:

  • Antes de escribir el código. Risk analysis en Security-Sensitive Change y Risk review en DevOps Change van antes del paso que implementa el cambio, así que le dan forma.
  • Después de escribir el código. Audit diff en Security-Sensitive Change, Security review en Feature SDLC, Verify secure en Dependency Refresh y Security en Data Migration siguen al paso de implementación. Esperan a que el código esté escrito y las pruebas del proyecto se hayan ejecutado, y auditan ese cambio.
  • Antes de la pasada de código. Parallel Review, Swarm Inspection y Release Readiness no tienen paso de implementación, así que todos sus pasos se ejecutan antes de que se escriba ningún código. El auditor trabaja a partir de la tarea y del código que ya está en el repositorio.
  • Sin código. Threat Model termina con sus documentos.

Entradas

  • La tarea de la sesión y una instantánea de solo lectura de los archivos relevantes del repositorio del proyecto.
  • Los pasos anteriores. En Threat Model trabaja a partir de la descripción del alcance y del flujo de datos del Architect; en DevOps Change, a partir del plan del DevOps Engineer.
  • Cuando se ejecuta después de escribir el código: el cambio como diff, recortado para que quepa y con el recorte marcado cuando es largo, y el resultado de pruebas registrado. Se le indica que cite los archivos que leyó.
  • Herramientas de los servidores MCP conectados, si la política de tu espacio de trabajo las permite.

Salidas

Su paso devuelve hallazgos por gravedad, con correcciones, en texto. Los pasos posteriores lo leen, y en Threat Model el ADR Writer convierte su análisis en un registro de decisión.

Cuando el Security Auditor se ejecuta en una sesión, se le atribuyen los hallazgos estructurados de la revisión del diff final. Cada hallazgo lleva una gravedad (de critical a info), una categoría, una recomendación y, cuando procede, un archivo. Los hallazgos aparecen en la sesión y en la página Security del espacio de trabajo, y el control de publicación comprueba la revisión de hallazgos antes de que el cambio se pueda entregar. Consulta controles de calidad.

Con el nivel Auto, sus pasos van primero al nivel Premium.

Ejemplo de ejecución

Ejemplo ilustrativo, no una sesión registrada. En Security-Sensitive Change, Matt pide un enlace «descargar factura» en los correos. En el paso Risk analysis, el Security Auditor advierte de que un enlace que lleva el id de la factura permite que cualquiera que adivine ids lea las facturas de otros clientes, y pide en su lugar un token firmado que caduque. El Builder describe el token, la sesión lo escribe y se ejecutan las pruebas del proyecto. En el paso Audit diff, el auditor lee el cambio escrito y señala que la caducidad del token va codificada en el enlace pero no se comprueba en el servidor. Después, la pasada de hallazgos revisa el mismo diff y registra lo que encuentra en el archivo de verificación del token.

Límites

  • Lee código. No ejecuta escáneres, no ataca un sistema en vivo ni consulta bases de datos de vulnerabilidades, salvo que se lo proporcione una herramienta MCP que hayas conectado.
  • Un paso que se ejecuta después de escribir el código lee el diff, y un diff largo se recorta para que quepa, con el recorte marcado. Los hallazgos que condicionan el paso del cambio por el control salen de la pasada de hallazgos, que también lee el diff.
  • Un paso que se ejecuta antes de escribir el código ve un plan, no el cambio. Sus observaciones dan forma a la implementación, y la pasada de hallazgos comprueba el resultado.
  • Puede producir falsos positivos y pasar por alto problemas reales. Pasa los hallazgos por triaje; no tomes una lista vacía como prueba de seguridad.
  • Los SBOM de los proyectos se registran aparte; consulta DevSecOps y SBOM.

Preguntas frecuentes

¿Los hallazgos de seguridad están vinculados a archivos reales?

Sí. Después de escribir el código, una pasada de hallazgos revisa el diff real y registra cada hallazgo con una gravedad, una categoría y, cuando procede, el archivo.

¿El Security Auditor sustituye a un escáner de seguridad?

No. Es un modelo que lee código. Detecta cosas distintas de las que detecta un escáner y puede pasar por alto cosas que un escáner encuentra, así que usa ambos.