Habilitación de GitHub Advanced Security para su empresa

Acerca de habilitar la GitHub Advanced Security

La GitHub Advanced Security ayuda a que los desarrolladores mejoren y mantengan la seguridad y la calidad del código. Para obtener más información, vea «Acerca de GitHub Advanced Security».

Cuando habilitas GitHub Advanced Security para la empresa, los administradores de repositorios de todas las organizaciones pueden habilitar las características, a menos que configure una directiva para restringir el acceso. Consulte "Aplicación de directivas de seguridad y análisis de código de la empresa".

También puedes habilitar o deshabilitar características de 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 REST API.

Para obtener instrucciones sobre cómo hacer una implementación por fases de GitHub Advanced Security, consulta "Introducción a la adopción de la Seguridad Avanzada de GitHub a escala".

Verificar si tu licencia incluye a la GitHub Advanced Security

1. En la esquina superior derecha de GitHub Enterprise Server, haz clic en la foto de perfil y luego en Configuración de empresa.

   

2. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Configuración.

3. En Configuración, haz clic en Licencia.

4. Si tu licencia incluye a la GitHub Advanced Security, la página de licencia incluirá una sección que muestra los detalles de uso actuales.

Prerequisitos para habilitar la GitHub Advanced Security

1. Mejora tu licencia de GitHub Enterprise Server para que incluya la GitHub Advanced Security. Para información sobre el funcionamiento de las licencias, consulta "Acerca de la facturación de GitHub Advanced Security".

2. Descarga el archivo de licencia nuevo. Consulte "Descargar tu licencia de GitHub Enterprise".

3. Cargue el nuevo archivo de licencia en GitHub Enterprise Server. Consulte "Cargar una licencia nueva a GitHub Enterprise Server".

4. Revisa los prerequisitos para las características que piensas habilitar.

   • Code scanning, consulta "Configuración la digitalización de código para el dispositivo."
   • Secret scanning, consulta "Configurar el escaneo de secretos para tu aplicativo".
   • Dependabot, consulta "Habilitación de Dependabot para la empresa".

Habilitar e inhabilitar las característcicas de la GitHub Advanced Security

1. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .

2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

3. En la barra lateral " Administrador del sitio", haz clic en Consola de administración .

4. En la barra lateral Settings, haga clic en Seguridad.

5. Debajo de "Seguridad", selecciona las características que quieres habilitar y quita la selección las que quieres deshabilitar.

6. En la barra lateral "Configuración" , haga clic en Guardar configuración.

   Nota: Al guardar la configuración en la Consola de administración se restablecen los servicios de sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

7. Espera que se complete la fase de configuración.

Cuando GitHub Enterprise Server termina de reiniciarse, estás listo para configurar cualquier recurso adicional que se requiera para las características recién habilitadas. Consulte "Configuración la digitalización de código para el dispositivo".

Habilitar o inhabilitar las características de la GitHub Advanced Security a través del 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, consulta "Acceder al shell administrativo (SSH)" y "Utilidades de la ea de comandos".

Por ejemplo, puedes habilitar cualquier característica de GitHub Advanced Security con tus herramientas de infraestructura-como-código cuando despliegas una instancia para hacer pruebas o para recuperación de desastres.

1. 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 obtener más información, vea «Acceder al shell administrativo (SSH)».

   Shell

   ssh -p 122 admin@HOSTNAME
   

2. Habilita las características de GitHub Advanced Security.

   • Para habilitar el code scanning, introduce los siguientes comandos.

     Shell

     ghe-config app.minio.enabled true
     ghe-config app.code-scanning.enabled true
     

   • Para habilitar el secret scanning, introduce el siguiente comando.

     Shell

     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
     

3. Opcionalmente, deshabilita las características de GitHub Advanced Security.

   • Para deshabilitar code scanning, escribe el siguiente comando.

     Shell

     ghe-config app.code-scanning.enabled false
     

     • Opcionalmente, si deshabilitas code scanning, también puedes deshabilitar el servicio MinIO interno para GitHub Advanced Security. Si Dependabot updates están habilitados para la instancia y deseas deshabilitar este servicio, también debes 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 inhabilitar Dependabot updates, introduce el siguiente comando.

         Shell

         ghe-config app.dependabot.enabled false
         

       • Para deshabilitar MinIO, escribe el siguiente comando.

         Shell

         ghe-config app.minio.enabled false
         

   • Para inhabilitar el secret scanning, ingresa el siguiente comando.

     Shell

     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
     

4. 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
   

5. Espera que se complete la fase de configuración.