Empieza con un solo hallazgo cuya evidencia consideres válida. Genera un parche, revísalo y comprueba si el problema original persiste en el código modificado. Generar o aplicar un parche aún no confirma que el problema esté resuelto.
En la interfaz de escritorio, generar el parche deja intacta la copia local seleccionada. Aplicarlo modifica esa copia. Durante la verificación, Codex comprueba el parche y registra la evidencia sin cerrar automáticamente el hallazgo.
Corregir un hallazgo en la interfaz
Abre un hallazgo aceptado desde Hallazgos o desde un análisis completado en Análisis. Revisa la evidencia y usa Parche para generar, revisar, aplicar y verificar la corrección.
-
Genera un parche
Abre el hallazgo, selecciona la pestaña Parche y luego Generar parche. Cuando es posible, Codex valida o reproduce el problema. Guarda el parche como artefacto sin modificar la copia local seleccionada.
-
Revisa el diff propuesto
Revisa el código y las pruebas afectados. Confirma que el cambio resuelva el problema sin introducir refactorizaciones ajenas al hallazgo ni debilitar los controles de seguridad.
-
Aplica el parche de forma local
Selecciona Aplicar parche solo cuando consideres aceptable el diff. Codex aplica el parche generado tal cual al árbol de trabajo y registra ese estado. Revisa el diff del árbol de trabajo antes de continuar.
-
Verifica la corrección
Selecciona Verificar corrección. Codex vuelve a ejecutar el procedimiento original que reproduce el problema u otra prueba de explotación. Si puede ejecutar una prueba de regresión, comprueba que falle antes de la corrección y pase después. De lo contrario, registra qué quedó sin verificar y qué comprobaciones pudo completar. También comprueba que el comportamiento legítimo se mantenga, busca otras formas de eludir los controles en el código cercano y revisa las pruebas del repositorio.
-
Cierra el hallazgo
La verificación no cierra el hallazgo automáticamente. Revisa los comandos, los resultados y lo que aún falta por demostrar. Luego, cierra el hallazgo indicando el motivo preciso o déjalo abierto para seguir trabajando en él.
Revisa la corrección de seguridad generada antes de aplicarla a tu copia local.
Corregir un hallazgo en una conversación
Usa el complemento instalado con un hallazgo de un análisis, un ticket, un aviso de seguridad u otra revisión. Indica el ID del hallazgo y la ruta del informe. Si tienes un procedimiento para reproducir el problema o un comando de validación, inclúyelo:
Usa $codex-security:fix-finding para corregir el hallazgo <finding-id> del informe <report-path>. Verifica el problema en esta copia local y corrígelo. Luego, ejecuta pruebas para comprobar que el fallo original ya no se produzca y que se mantenga el comportamiento legítimo. Registra las comprobaciones que no hayas podido completar.Con esta instrucción autorizas cambios en la copia local. Codex puede inspeccionar el repositorio para encontrar los detalles técnicos que falten, pero quizá necesite que aclares qué política de seguridad debe aplicarse antes de elegir una corrección.
Corregir hallazgos sin interacción
Para repetir los análisis y la generación de parches, usa los comandos de validación y generación de parches de la CLI independiente.
Para invocar el complemento instalado desde la CLI de Codex, primero instala Codex Security en
el CODEX_HOME del runner. Un runner nuevo no incluye complementos de Marketplace
por defecto. Usa una copia local o un trabajo independiente para cada hallazgo aceptado:
codex exec --sandbox workspace-write 'Usa $codex-security:fix-finding para corregir el hallazgo <finding-id> del informe <report-path>. Verifica el problema en esta copia local y corrígelo. Luego, ejecuta pruebas para comprobar que el fallo original ya no se produzca y que se mantenga el comportamiento legítimo. Registra las comprobaciones que no hayas podido completar.'El sandbox con permisos de escritura permite que el flujo de trabajo modifique el código fuente y las pruebas. Conserva el parche y la evidencia de verificación para revisarlos. Para obtener detalles sobre la instalación, la configuración de los análisis y el manejo de los artefactos, consulta Automatizar las revisiones en CI/CD.
Después de verificar la corrección, integra el cambio siguiendo tu proceso habitual de revisión de código. Si la verificación está incompleta, mantén abierto el hallazgo e indica qué queda pendiente.