Security Review
Configura y ejecuta revisiones de seguridad exhaustivas para solicitudes de incorporación de GitHub.
Codex Security Review está disponible para clientes de ChatGPT Enterprise, Business, Edu y Pro. No está disponible en Plus. Las revisiones de seguridad consumen la cuota incluida de Codex o créditos de ChatGPT.
Usa Security Review para comprobar si una solicitud de incorporación de cambios de GitHub tiene problemas de seguridad en sus diferencias y en el código de apoyo. Usa el contexto del modelo de amenazas o las directrices de seguridad cuando están configurados y publica los hallazgos que alcanzan el umbral de notificación.
Code Review también puede notificar problemas de seguridad durante su revisión general, por lo que ambas revisiones pueden notificar el mismo hallazgo.
Antes de comenzar
Para configurar Codex Security Review automático, necesitas:
- Acceso a Codex Security Review para tu espacio de trabajo
- Codex en la nube configurado con un repositorio de GitHub conectado
- Permiso de envío de cambios o de administración en GitHub para la configuración del repositorio
Un análisis existente de Codex Security es opcional.
Configurar Codex Security Review
La configuración del repositorio es compartida. Cambiarla afecta a las solicitudes de incorporación de cambios seleccionadas por la política Revisión del repositorio, no solo a tus propias solicitudes. Las preferencias personales se aplican a tus solicitudes de incorporación de cambios cuando el repositorio sigue las preferencias personales.
- Ve a Configuración de Codex y elige un repositorio.
- En Revisar vulnerabilidades de seguridad, activa Revisión de seguridad automática.
- Usa Revisión para elegir qué pull requests reciben Codex Security Review:
- Seguir las preferencias personales permite que cada colaborador active la función con su configuración personal de Codex Security Review.
- Todas las PR se aplica a cada pull request del repositorio.
- PR del equipo, cuando está disponible, se aplica a las pull requests abiertas por miembros de tu espacio de trabajo de ChatGPT, no por miembros de un equipo de GitHub.
- Usa Activador para elegir cuándo se ejecuta Codex Security Review:
- Al abrir una PR se ejecuta de forma independiente cuando se abre una pull request.
- Con cada envío de cambios se ejecuta de forma independiente después de enviar nuevos commits.
- Siempre que se ejecute la revisión de código requiere Code Review y ejecuta Codex Security Review junto con ella.
Conectar GitHub o habilitar las revisiones personales para otro colaborador no solicita una revisión adicional de sus solicitudes de incorporación de cambios. La configuración del repositorio y la personal determinan si se ejecuta una revisión automática; no crean una revisión por cada usuario conectado. Los envíos posteriores pueden activar otra revisión según Activador, y puedes solicitar revisiones adicionales manualmente.
Añadir contexto del modelo de amenazas
Puedes configurar un modelo de amenazas para proporcionar a Codex contexto sobre los activos de tu aplicación, los límites de confianza, las suposiciones de seguridad y los riesgos específicos del repositorio. Si el repositorio ya tiene una configuración de análisis de Codex Security, puedes usar su modelo de amenazas. De lo contrario, proporciona la ruta a un archivo de modelo de amenazas incluido en el repositorio. Si no especificas una fuente, Codex vuelve a generar el modelo de amenazas para cada revisión.
Establecer umbrales de informes
De forma predeterminada, las revisiones automáticas de Codex Security informan de hallazgos de gravedad Alta y Crítica, mientras que las revisiones solicitadas manualmente informan de hallazgos de gravedad Media, Alta y Crítica. Puedes cambiar la gravedad mínima de forma independiente para las revisiones automáticas y manuales, y añadir excepciones basadas en rutas.
Los hallazgos publicados en una solicitud de incorporación de cambios heredan la visibilidad de esa solicitud en GitHub. Cualquier persona que pueda ver la solicitud puede ver esos hallazgos, incluso en repositorios públicos o en solicitudes de colaboradores ajenos a tu espacio de trabajo. El umbral de notificación controla lo que Codex publica en GitHub. El informe completo de Codex Security Review permanece en Codex.
Solicitar una revisión de Codex Security
Para solicitar manualmente una revisión de Codex Security, añade este comentario a una solicitud de incorporación de cambios:
@codex security review
Codex reacciona mientras se ejecuta la revisión y luego publica los hallazgos que cumplen tu umbral de notificación manual directamente en la solicitud de incorporación de cambios. Abre la tarea de Codex asociada y selecciona la pestaña Informe de seguridad para ver el informe completo, que incluye la gravedad, la ruta de ataque, las pruebas de respaldo, la validación y las recomendaciones de corrección. Si ningún problema alcanza el umbral de notificación, Codex no publica hallazgos en la solicitud de incorporación de cambios. Comprueba el estado de la tarea y el informe completo antes de interpretar la ausencia de comentarios como una revisión completada sin hallazgos.
Documentación relacionada
- Revisar solicitudes de incorporación de GitHub con Codex explica Code Review y la integración con GitHub.
- Codex Security ofrece una descripción general del producto.
- Configuración de Codex Security en la nube explica los análisis de repositorios y la revisión de hallazgos.
- Mejorar el modelo de amenazas explica cómo ajustar el contexto del repositorio.