Ejecutar un análisis de seguridad profundo
Ejecuta revisiones de seguridad repetidas de un repositorio o una carpeta y establece límites de concurrencia y duración.
Un análisis profundo ejecuta varios análisis estándar independientes sobre el mismo repositorio o carpeta y combina sus hallazgos. Úsalo cuando quieras realizar revisiones repetidas y puedas asumir el tiempo de ejecución y el consumo de tokens adicionales.
Empieza con un análisis estándar para comprobar que el alcance y el contexto de seguridad se ajustan a tu objetivo. Las revisiones repetidas pueden detectar problemas que una revisión anterior pasó por alto, pero no garantizan una detección completa ni resultados idénticos entre ejecuciones.
Elegir entre análisis estándar y profundos
| Análisis estándar | Análisis profundo | |
|---|---|---|
| Revisión | Un análisis estándar | Varios análisis estándar con hallazgos combinados |
| Úsalo para | Un primer análisis o la revisión de un alcance definido | Revisiones independientes adicionales de ese alcance |
| Alcance | Repositorio o carpeta | Repositorio o carpeta |
| Cambios | Usa el flujo de trabajo de revisión de cambios | No compatible |
Inicia el análisis profundo
Para obtener la mejor calidad de análisis, usa gpt-5.6-sol
con un nivel de esfuerzo de razonamiento xhigh.
- Abre Seguridad > Análisis y selecciona + Análisis.
- Elige un repositorio o una carpeta, selecciona Base de código y activa Análisis profundo. El análisis revisa todo el repositorio o la carpeta seleccionados.
- Elige el modelo y el nivel de esfuerzo de razonamiento. Añade contexto del modelo de amenazas o del despliegue en Contexto adicional.
- Selecciona Iniciar análisis.
También puedes iniciarlo desde una conversación de Codex:
Use $codex-security:deep-security-scan to run a deep security scan of this repository.Para un solo componente, sustituye "this repository" por la ruta de su carpeta.
Los procesos de análisis profundo heredan el modelo y la configuración de razonamiento seleccionados. Cada proceso ejecuta un análisis estándar completo, y Codex Security agrega los resultados completados. Sigue el análisis guardado desde Análisis, o selecciona Ver actividad para inspeccionar su tarea de Codex. Configura los límites de ejecución antes de empezar si necesitas limitar la concurrencia o la duración.
Revisa el resultado
Los análisis profundos usan los mismos detalles de análisis guardados y el mismo directorio de análisis completo que
los análisis estándar. Abre el análisis completado en Análisis o revisa sus hallazgos en
Hallazgos. El archivo report.md generado enlaza a informes detallados de vulnerabilidades
o a recomendaciones de refuerzo estructural cuando solicitas esos resultados.
Conserva los directorios findings/ y hardening/ enlazados junto con el informe al
compartir o archivar el resultado.
Revisa el resumen de cobertura antes que los hallazgos. Incluso un análisis profundo tiene límites, así que comprueba las superficies pendientes y las lagunas de evidencia restantes antes de sacar una conclusión. Para un hallazgo que aceptes, continúa con Corrige y verifica un hallazgo.
Para revisar una pull request, un commit, un rango de ramas o un parche local, usa Revisa los cambios de código. Los análisis profundos no admiten objetivos de tipo diff.
Configurar el tiempo de ejecución del análisis profundo
Para controlar la concurrencia y la duración de un análisis profundo, crea o edita
~/.codex/codex-security/config.toml. Si estableces CODEX_HOME, usa
$CODEX_HOME/codex-security/config.toml en su lugar.
Por ejemplo, este perfil ejecuta un análisis más corto con concurrencia limitada:
[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5| Configuración | Valor predeterminado | Descripción |
|---|---|---|
workers |
4 |
Número de trabajadores independientes de análisis estándar que pueden ejecutarse al mismo tiempo. El valor heredado "auto" también se resuelve como 4. |
subagents |
3 |
Número de subagentes que puede iniciar cada trabajador. Establécelo en 0 para deshabilitarlos. |
stop_after_no_new |
4 |
Se detiene después de que esta cantidad de análisis consecutivos completados por trabajadores no produzca ningún hallazgo nuevo. |
stop_after_consecutive_errors |
3 |
Se detiene después de esta cantidad de errores consecutivos de los trabajadores. |
max_discovery_runs |
40 |
Limita el número de ejecuciones independientes del análisis estándar antes de la agregación. |
max_time_hours |
96 |
Limita la ejecución de los trabajadores a un número positivo de horas, hasta 96; usa fracciones si es necesario. |
Los valores más bajos pueden reducir el tiempo de análisis y el uso de tokens, pero podrían omitir hallazgos. Los cambios de configuración se aplican a los análisis profundos nuevos, no a los que ya están en curso.
Cuando vence el límite de tiempo, Codex Security detiene los trabajadores que no hayan terminado, conserva los resultados de los análisis completados y los agrega al informe final. Si ningún trabajador termina la revisión del código fuente antes de la fecha límite, el informe registra una cobertura parcial.
La configuración max_time_hours requiere la versión 0.1.19 del plugin o una posterior. Consulta el
registro de cambios del plugin para conocer los detalles de la versión.