Usa $codex-security:vulnerability-writeup para crear un informe independiente para cada vulnerabilidad. Puedes partir de los resultados de un análisis de Codex Security o usar directamente los hallazgos, las notas de divulgación, las pruebas de concepto (PoC) y el código fuente que tengas. El análisis de Codex Security es opcional.
Prepara la evidencia
Proporciona los siguientes elementos al flujo de trabajo:
- Los hallazgos, las notas de divulgación o los documentos de evaluación que se deben revisar.
- El árbol de código fuente que se va a analizar y la revisión o versión afectada.
- Las PoC, los registros, las trazas, las capturas de pantalla o los resultados de diagnóstico disponibles.
- Los commits de corrección o los diffs, si están disponibles.
Antes de redactar el informe, Codex contrasta cada afirmación con el código fuente afectado. Si falta el código fuente o la revisión afectada, decide si quieres continuar con un informe que indique qué afirmaciones quedan sin verificar.
Ejecuta el flujo de trabajo
Envía un prompt como este:
Usa $codex-security:vulnerability-writeup para crear un informe independiente por cada vulnerabilidad distinta que se describa en [input paths]. Verifica las afirmaciones con el código fuente indicado en [source path and revision], conserva o mejora las PoC proporcionadas y guarda los informes en [output directory]. Usa un entorno de pruebas local para reproducir las vulnerabilidades.Codex hace un inventario del material proporcionado, agrupa los informes que describen la misma causa raíz y la misma ruta vulnerable, y crea un directorio para el informe de cada vulnerabilidad. Cada directorio contiene un informe en Markdown y, si hay archivos de apoyo para la PoC, un directorio poc/.
Revisa cada informe
Antes de distribuir un informe, verifica que cumpla con estos criterios:
- Explica cómo se desencadena el fallo desde el punto de entrada que controla el atacante, qué invariante de seguridad se vulnera y cuál es el impacto.
- Distingue el comportamiento verificado de las hipótesis y las limitaciones aún sin resolver.
- Incluye fragmentos de código fuente con sus rutas, las funciones correspondientes y la revisión afectada.
- Cuando sea viable usar una PoC, incluye su código fuente, las instrucciones para compilarla o ejecutarla, una muestra representativa de la salida y las limitaciones de seguridad.
- Usa rutas portables y evita depender del almacenamiento interno o de rutas absolutas locales.
Usa los informes de un análisis
Los informes detallados de vulnerabilidades son opcionales en los análisis estándar, los análisis profundos y los análisis de cambios. Cuando los solicitas, Codex guarda cada informe en findings/<slug>/<slug>.md, almacena los archivos de apoyo en findings/<slug>/poc/ e incluye un enlace al informe en report.md.
Cuando compartas o archives un análisis, conserva el directorio completo con toda su estructura. Para identificar mejoras que aborden patrones comunes a varios informes, continúa con Propón medidas para reforzar la seguridad.