Acerca de la activación GitHub Advanced Security
Las características de GitHub Advanced Security ayudan a los desarrolladores a mejorar y mantener la seguridad y la calidad del código. Para más información, consulta Acerca de GitHub Advanced Security.
Cuando se habilita GitHub Advanced Security para su empresa, los administradores de repositorios de todas las organizaciones pueden habilitar las características a menos que configure una directiva para restringir el acceso. Consulta Aplicación de directivas de seguridad y análisis de código de la empresa.
También puedes habilitar o deshabilitar características de GitHub Advanced Security a través de la API. Para más información, consulta Puntos de conexión de la API REST para el examen de secretos en la documentación de la API REST.
Para obtener instrucciones sobre una implementación por fases de GitHub Advanced Security, consulte Introducción a la adopción de GitHub Advanced Security a escala.
Comprobación de si la licencia incluye Advanced Security
- En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Enterprise settings.
- En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Settings.
- En Settings, haz clic en License.
- Si la licencia incluye GitHub Advanced Security, la página de licencia incluye una sección que muestra los detalles del uso actual.
Requisitos previos para habilitar Advanced Security
-
Actualice la GitHub Enterprise licencia para incluir Advanced Security. Para información sobre el funcionamiento de las licencias, consulta GitHub Advanced Security facturación de licencias.
-
Descarga el archivo de licencia nuevo. Consulta Descarga de la licencia para GitHub Enterprise.
-
Cargue el nuevo archivo de licencia en GitHub Enterprise Server. Consulta Carga de una nueva licencia en GitHub Enterprise Server.
-
Revisa los prerequisitos para las características que piensas habilitar.
- Code scanning, consulte Configuración del examen de código para el dispositivo.
- Secret scanning, consulte Configurar el escaneo de secretos para tu aplicativo.
- Dependabot, consulte Habilitación de Dependabot para la empresa.
Activar y desactivar Advanced Security características
Advertencia
- El cambio de esta configuración hará que se reinicien los servicios orientados al usuario en GitHub Enterprise Server. Debes sincronizar este cambio cuidadosamente para minimizar el tiempo de inactividad de los usuarios.
- Cualquier cambio que planees realizar en la configuración de habilitación de características debes comunicarlo a los propietarios de la organización antes de hacerlos, para que las configuraciones de seguridad existentes que han implementado las organizaciones de tu empresa no resulten afectadas.
-
Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haz clic en .
-
Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.
-
En la barra lateral " Site admin", haz clic en Consola de administración.
-
En la barra lateral Settings, haga clic en Seguridad.
-
Debajo de "Seguridad", selecciona las características que quieres habilitar y quita la selección las que quieres deshabilitar.
-
En la barra lateral "Configuración" , haga clic en Guardar configuración.
Nota:
Al guardar la configuración en Consola de administración se restablecen los servicios del sistema, lo que podría generar un tiempo de inactividad visible para el usuario.
-
Espera que se complete la fase de configuración.
Cuando GitHub Enterprise Server haya terminado de reiniciarse, estará listo para configurar los recursos adicionales necesarios para las características recién habilitadas. Consulta Configuración del examen de código para el dispositivo.
Habilitar o deshabilitar Advanced Security funcionalidades mediante el shell administrativo (SSH)
Puede habilitar o deshabilitar características mediante programación en GitHub Enterprise Server. Para obtener más información sobre el shell administrativo y las utilidades de línea de comandos para GitHub Enterprise Server, vea Acceder al shell administrativo (SSH) y Utilidades de la línea de comandos.
Por ejemplo, puede habilitar cualquier Advanced Security característica con sus herramientas de infraestructura como código al implementar una instancia para el entorno de preproducción o la recuperación ante desastres.
-
SSH en tu instancia de GitHub Enterprise Server Si la instancia consta de varios nodos, por ejemplo, si la alta disponibilidad o la replicación geográfica están configuradas, utiliza SSH en el nodo principal. Si usas un clúster, puedes utilizar SSH en cualquier nodo. Reemplace HOSTNAME por el nombre de host de la instancia, o el nombre de host o la dirección IP de un nodo. Para más información, consulta Acceder al shell administrativo (SSH).
Shell ssh -p 122 admin@HOSTNAME
ssh -p 122 admin@HOSTNAME -
Habilite las características de Advanced Security.
-
Para habilitar code scanning, escriba los siguientes comandos.
Shell ghe-config app.minio.enabled true ghe-config app.code-scanning.enabled true
ghe-config app.minio.enabled true ghe-config app.code-scanning.enabled true -
Para habilitar secret scanning, escriba el siguiente comando.
Shell ghe-config app.secret-scanning.enabled true
ghe-config app.secret-scanning.enabled true -
Para habilitar el gráfico de dependencias, escribe el siguiente comando.
Shell ghe-config app.dependency-graph.enabled true
ghe-config app.dependency-graph.enabled true
-
-
Opcionalmente, deshabilite las características de Advanced Security.
-
Para deshabilitar code scanning, escriba los siguientes comandos.
Shell ghe-config app.code-scanning.enabled false
ghe-config app.code-scanning.enabled false-
Opcionalmente, si deshabilita code scanning, también puede deshabilitar el servicio MinIO interno para Advanced Security. Si Dependabot updates están habilitados para la instancia y desea deshabilitar este servicio, también debe deshabilitar Dependabot updates. Deshabilitar el servicio no afecta al almacenamiento minIO para GitHub Actions o GitHub Packages. Para obtener más información sobre Dependabot updates, consulta Habilitación de Dependabot para la empresa.
-
Para deshabilitar Dependabot updates, escriba el siguiente comando.
Shell ghe-config app.dependabot.enabled false
ghe-config app.dependabot.enabled false -
Para deshabilitar MinIO, escribe el siguiente comando.
Shell ghe-config app.minio.enabled false
ghe-config app.minio.enabled false
-
-
-
Para deshabilitar secret scanning, escriba el siguiente comando.
Shell ghe-config app.secret-scanning.enabled false
ghe-config app.secret-scanning.enabled false -
Para deshabilitar el gráfico de dependencias, escribe el siguiente comando.
ghe-config app.dependency-graph.enabled false
-
-
Para aplicar la configuración, ejecuta el siguiente comando.
Nota:
Durante la ejecución de una configuración, los servicios de tu instancia de GitHub Enterprise Server pueden reiniciarse, y esto puede provocar un breve tiempo de inactividad para los usuarios.
Shell ghe-config-apply
ghe-config-apply -
Espera que se complete la fase de configuración.