Acerca del establecimiento de la configuración predeterminada a gran escala
La configuración predeterminada para el code scanning permite proteger rápidamente el código de los repositorios de toda la organización.
Puedes habilitar code scanning para todos los repositorios aptos en tu organización para la configuración predeterminada. Después de habilitar la configuración predeterminada, el código escrito en lenguajes compatibles con CodeQL en repositorios de la organización se analizará:
- En cada envío de cambios a la rama predeterminada del repositorio o cualquier rama protegida. Para más información sobre las ramas protegidas, consulta "Acerca de las ramas protegidas".
- Al crear o confirmar una solicitud de cambios basado en la rama por defecto del repositorio, o cualquier rama protegida, excluyendo pull requests de forks.
Para obtener más información, consulta "Establecimiento de la configuración predeterminada para todos los repositorios aptos de una organización".
También puedes usar la información general de seguridad para buscar un conjunto de repositorios de la organización y habilitar o deshabilitar la configuración predeterminada para todos ellos al mismo tiempo. Para obtener más información, consulta "Establecimiento de la configuración predeterminada para un subconjunto de repositorios de una organización".
También puedes crear configuraciones predeterminadas diferentes para repositorios individuales. Para obtener más información sobre cómo establecer la configuración predeterminada a nivel de repositorio, consulta "Establecimiento de la configuración predeterminada para el examen del código".
En el caso de los repositorios que no son aptos para la configuración predeterminada, puedes establecer la configuración avanzada a nivel de repositorio o a nivel de la organización con un script. Para obtener más información, vea «Establecimiento de la configuración avanzada para el examen de código con CodeQL a gran escala».
Repositorios aptos para la configuración predeterminada de CodeQL a gran escala
Note
La capacidad de habilitar y deshabilitar la configuración predeterminada de code scanning para repositorios aptos en una organización se encuentra actualmente en beta y está sujeta a cambios.
Un repositorio debe cumplir todos los criterios siguientes para ser aptos para la configuración predeterminada; de lo contrario, debes usar la configuración avanzada.
-
La configuración avanzada para code scanning aún no está habilitada.
-
GitHub Actions se han habilitado.
-
Usa Go, JavaScript/TypeScript, Python o Ruby.
-
GitHub Advanced Security está habilitado.
Note
La configuración predeterminada de todos los repositorios de una organización a través de la página de configuración de la organización no invalidará las configuraciones existentes de la configuración predeterminada. Sin embargo, la configuración predeterminada en un subconjunto de repositorios de una organización mediante la información general sobre seguridad invalidará los ajustes existentes de la configuración predeterminada en esos repositorios.
Establecimiento de la configuración predeterminada para todos los repositorios aptos de una organización
En la página de configuración de la organización "Seguridad y análisis del código", puedes habilitar la configuración predeterminada para todos los repositorios aptos de la organización. Para obtener más información sobre la idoneidad de los repositorios, consulta "Repositorios aptos para la configuración predeterminada de CodeQL a gran escala".
Note
La capacidad de habilitar y deshabilitar la configuración predeterminada de code scanning para repositorios aptos en una organización se encuentra actualmente en beta y está sujeta a cambios.
- En la esquina superior derecha de GitHub, seleccione la foto del perfil y haga clic en Sus organizaciones.
- Junto a la organización, haga clic en Settings.
- En la sección "Seguridad" de la barra lateral, haga clic en Análisis y seguridad del código.
- Haz clic en Enable all junto a "Code scanning".
- En el cuadro de diálogo "Habilitar code scanning para repositorios aptos", haz clic en Habilitar para repositorios aptos para habilitar la definición de la configuración predeterminada.
Note
- Si deshabilitas CodeQL code scanning para todos los repositorios, este cambio no se reflejará en la información de cobertura que se muestra en la información general de seguridad de la organización. Los repositorios seguirán teniendo code scanning habilitado en la vista "Cobertura de seguridad".
- La habilitación de code scanning para todos los repositorios aptos de una organización no invalidará las configuraciones existentes de code scanning. Para obtener información sobre cómo definir la configuración predeterminada con diferentes opciones para repositorios específicos, consulta “Establecimiento de la configuración predeterminada para el examen del código” y “Establecimiento de la configuración predeterminada para un subconjunto de repositorios de una organización”.
Establecimiento de la configuración predeterminada para un subconjunto de repositorios de una organización
La información general de seguridad de la organización permite buscar repositorios aptos para la configuración predeterminada y habilitar esta configuración en todos los repositorios simultáneamente. Para obtener más información sobre la idoneidad de los repositorios, consulta "Repositorios aptos para la configuración predeterminada de CodeQL a gran escala".
Búsqueda de repositorios aptos para la configuración predeterminada
-
En GitHub, navega a la página principal de tu organización.
-
En el nombre de la organización, haga clic en Seguridad .
-
En la barra lateral, haz clic en Cobertura para mostrar la vista "Cobertura de seguridad".
-
En la barra de búsqueda, escribe una de las siguientes consultas:
code-scanning-default-setup:eligible advanced-security:enabled
muestra qué repositorios se pueden agregar a la configuración predeterminada inmediatamente.code-scanning-default-setup:eligible advanced-security:not-enabled
muestra qué repositorios tienen idiomas adecuados para la configuración predeterminada pero no tienen habilitado GitHub Advanced Security. Una vez que habilite GitHub Advanced Security para estos repositorios, también se pueden agregar a la configuración predeterminada.code-scanning-default-setup:not-eligible
muestra los repositorios que no son aptos para habilitar la configuración predeterminada a gran escala por cualquiera de los siguientes motivos:- Los repositorios ya tienen ajustes existentes de configuración avanzada.
- Los repositorios solo contienen lenguajes que la configuración predeterminada no puede analizar.
- Los repositorios no tienen habilitado GitHub Advanced Security.
Puedes seleccionar todos los repositorios mostrados, o un subconjunto de ellos, y habilitar o deshabilitar la configuración predeterminada de code scanning para ellos al mismo tiempo. Para obtener más información, consulta el paso 5 de "Establecimiento de la configuración predeterminada a gran escala para varios repositorios de una organización".
Establecimiento de la configuración predeterminada a gran escala para varios repositorios de una organización
-
En GitHub, navega a la página principal de tu organización.
-
En el nombre de la organización, haga clic en Seguridad .
-
En la barra lateral, haz clic en Cobertura para mostrar la vista "Cobertura de seguridad".
-
Puedes usar la barra de búsqueda para restringir los repositorios visibles en la vista "Cobertura de seguridad" en función del nombre o en el estado de habilitación de las características de seguridad. Por ejemplo, para filtrar los repositorios que son aptos para la configuración predeterminada y que actualmente no la tienen habilitada, busca
code-scanning-default-setup:eligible
. -
En la lista de repositorios, selecciona cada repositorio para el que quieres habilitar el code scanning.
- Para habilitar code scanning para todos los repositorios en la página, marca la casilla situada junto a NÚMERO activos.
- Para habilitar code scanning para todos los repositorios que coincidan con la búsqueda actual, marca la casilla situada junto a NÚMERO activos y, a continuación, haz clic en Seleccionar los NÚMERO repositorios.
-
Haz clic en Configuración de seguridad junto a NÚMERO seleccionados.
-
En el panel lateral, en la sección "Configuración predeterminada de CodeQL", selecciona Sin cambios y haz clic en Habilitar.
-
Para confirmar la habilitación del code scanning para los repositorios seleccionados, haz clic en Aplicar cambios NÚMERO. Como alternativa, para seleccionar o anular la selección de más repositorios para la habilitación del code scanning, haz clic en para cerrar el panel sin aplicar los cambios.
Note
Al habilitar code scanning en varios repositorios de una organización mediante la información general sobre seguridad se invalidarán las configuraciones de code scanning existentes para los repositorios seleccionados, incluidas las selecciones previas del conjunto de consultas y los flujos de trabajo de las configuraciones avanzadas.
Si no puedes habilitar el code scanning debido a una directiva empresarial, puedes ver el repositorio afectado en la vista "Cobertura de seguridad" y acceder al panel lateral desde el botón Configuración de seguridad. Sin embargo, verás un mensaje en el panel lateral que indica que no puedes habilitar el code scanning para los repositorios seleccionados. Para obtener más información sobre las directivas empresariales, consulta "Aplicación de directivas de seguridad y análisis de código de la empresa".