Qué cambia con la actualización del 13 de noviembre
GitHub ha añadido repository_scan a los endpoints existentes de configuración de AI Scan para organizaciones y repositorios, en versión preliminar pública. GET y PATCH utilizan /orgs/{org}/code-scanning/ai-scan o /repos/{owner}/{repo}/code-scanning/ai-scan. La nueva propiedad admite enabled o disabled, junto con el control pr_scan ya existente para las solicitudes de cambios.
Esto permite incorporar un cambio de configuración a scripts de despliegue y definiciones de infraestructura. No convierte esos scripts en un programador de análisis. Para los repositorios de organizaciones, el anuncio incluye los públicos y los privados o internos que cuentan con GitHub Code Security o GitHub Advanced Security. GitHub Enterprise Server no es compatible con esta actualización. Consulta la documentación actual de requisitos para el tipo de propietario y la visibilidad de los repositorios que utilizas.
Consulta la jerarquía de políticas antes de modificar una opción
Si una organización desactiva el análisis de repositorios, sus repositorios no pueden activarlo por su cuenta. Cuando la organización lo activa, los repositorios aptos heredan esa configuración y sus administradores pueden desactivarla individualmente. Las restricciones de la empresa siguen teniendo prioridad: un intento de activar AI Scan que incumpla una de ellas devuelve 422. El valor deseado para un repositorio no puede imponerse a una política de nivel superior.
La API también distingue entre consultar y administrar. Los requisitos de los tokens de permisos detallados varían según el endpoint: las consultas de organizaciones requieren permiso de lectura de Administration, mientras que las de repositorios requieren permiso de lectura de Code scanning alerts; las actualizaciones necesitan permiso de escritura de Administration en el nivel correspondiente. Verifica tanto el rol de quien realiza la solicitud como los permisos del endpoint concreto. Un proceso de inventario de solo lectura no debe recibir permisos de escritura simplemente porque una fase posterior del despliegue los necesite.
Una actualización conjunta bloqueada no modifica ninguno de los campos
GitHub permite incluir pr_scan y repository_scan en una misma solicitud. Si alguno de los cambios solicitados no puede aplicarse, la solicitud falla y ninguna de las dos opciones cambia. Por ejemplo, una solicitud que modifica el análisis de solicitudes de cambios y activa el análisis del repositorio no debe registrarse como un despliegue parcialmente correcto si uno de los campos está bloqueado.
Trata este proceso como una comprobación de que el estado real coincide con el deseado. Guarda los valores iniciales, envía únicamente el cambio previsto y autorizado y compara después la respuesta y una nueva consulta con los valores deseados. Un 422 no demuestra que uno de los campos se haya actualizado, y tampoco identifica siempre la misma causa: la referencia REST también contempla errores de validación. Conserva el error devuelto en el registro del despliegue y resuelve su causa real antes de reintentar.
Activado, analizado y revisado son estados distintos
Activar repository_scan no inicia un análisis. Los usuarios con permiso de escritura ejecutan los análisis bajo demanda; cada ejecución consume créditos de Code Security AI. La documentación actual limita los análisis de repositorios a la rama predeterminada e indica que no se admiten análisis programados ni automáticos al hacer push. Por tanto, el presupuesto y la ejecución del análisis necesitan responsables y pruebas propios.
Un análisis terminado también es una búsqueda limitada, no una prueba de que todo el repositorio esté libre de vulnerabilidades. GitHub describe un agente que selecciona el código que examina dentro de un límite de tiempo. Su documentación advierte de vulnerabilidades que pueden pasar desapercibidas, alertas duplicadas con CodeQL y hallazgos de IA inexactos. Revisa cada alerta y sus pruebas; no conviertas una opción activada ni un resultado vacío en un certificado de ausencia de vulnerabilidades.
Un registro del despliegue que otro desarrollador pueda revisar
Para una prueba piloto pequeña, Codorc propone registrar por separado los siguientes puntos de control. Son comprobaciones operativas propuestas, no resultados de una prueba real de la API ni una evaluación de la calidad de detección de GitHub.
- Identifica la organización, la visibilidad del repositorio y la política de empresa aplicable. Confirma que se cumplen los requisitos, quién es el administrador responsable y cuál es el presupuesto de créditos aprobado antes de cambiar nada.
- Guarda la configuración actual de la organización y del repositorio con una marca de tiempo. Evita que las credenciales aparezcan en los registros y utiliza solo los permisos que necesita cada fase.
- Registra los cambios previstos en los campos y el estado devuelto. En una actualización conjunta, verifica ambos campos a la vez; si la respuesta es incierta, consulta el estado antes de enviar otra escritura.
- Registra un análisis iniciado deliberadamente por separado de la activación: qué revisión de la rama predeterminada se examinó, cuándo terminó la ejecución y qué consumo se notificó.
- Asigna a una persona la revisión de los hallazgos y la verificación de las correcciones. Registra por qué una alerta se aceptó, se descartó o se consideró duplicada, y ten presentes las limitaciones documentadas de los nuevos análisis al comprobar una corrección.
La fecha del suceso corresponde al anuncio original. La fecha de publicación indica cuándo apareció el artículo en Codorc.



