Configuración del inicio de sesión único en GitHub Enterprise Server con el identificador de Microsoft Entra

En este artículo, aprenderá a integrar GitHub Enterprise Server con Microsoft Entra ID. Al integrar GitHub Enterprise Server con microsoft Entra ID, puede hacer lo siguiente:

• Controlar en microsoft Entra ID quién tiene acceso a GitHub Enterprise Server.
• Permitir que los usuarios inicien sesión automáticamente en GitHub Enterprise Server con sus cuentas de Microsoft Entra.
• Administre sus cuentas en una ubicación central.

Prerrequisitos

Para empezar, necesitas los siguientes elementos:

• Una suscripción a Microsoft Entra. Si no tiene una suscripción, puede obtener una cuenta gratuita.
• GitHub Enterprise Server, listo para la inicialización.
• Junto con el administrador de aplicaciones en la nube, el administrador de aplicaciones también puede agregar o administrar aplicaciones en Microsoft Entra ID. Para más información, consulte Roles integrados en Azure.

Descripción del escenario

En este artículo, configura y prueba Microsoft Entra SSO en un entorno de prueba.

• GitHub Enterprise Server admite el inicio de sesión único iniciado por SP e IDP .
• GitHub Enterprise Server admite el aprovisionamiento de usuarios Just-In-Time .
• GitHub Enterprise Server admite el aprovisionamiento automatizado de usuarios.

Adición de GitHub Enterprise Server desde la galería

Para configurar la integración de GitHub Enterprise Server en Microsoft Entra ID, debe agregar GitHub Enterprise Server desde la galería a la lista de aplicaciones SaaS administradas.

1. Inicie sesión en el Centro de administración de Microsoft Entra siendo al menos un Administrador de aplicaciones en la nube.
2. Navegue a Entra ID>Aplicaciones empresariales>Nueva aplicación.
3. En la sección Agregar desde la galería , escriba GitHub Enterprise Server en el cuadro de búsqueda.
4. Seleccione GitHub Enterprise Server en el panel de resultados y agregue la aplicación. Espere unos segundos mientras la aplicación se agrega a su arrendatario.

Como alternativa, también puede usar el Asistente para configuración de aplicaciones empresariales. En este asistente, puede agregar una aplicación al inquilino, agregar usuarios o grupos a la aplicación, asignar roles y recorrer también la configuración de SSO. Obtenga más información sobre los asistentes de Microsoft 365.

Configuración y prueba del inicio de sesión único de Microsoft Entra para GitHub Enterprise Server

Configure y pruebe el inicio de sesión único de Microsoft Entra con GitHub Enterprise Server mediante un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, es preciso establecer una relación de vinculación entre un usuario de Microsoft Entra y el usuario relacionado de GitHub Enterprise Server.

Para configurar y probar el inicio de sesión único de Microsoft Entra con GitHub Enterprise Server, siga estos pasos:

1. Configura Microsoft Entra SSO para permitir que tus usuarios usen esta característica.
   1. Creación de un usuario de prueba de Microsoft Entra : para probar el inicio de sesión único de Microsoft Entra con B.Simon.
   2. Asigne el usuario de prueba de Microsoft Entra : para permitir que B.Simon use el inicio de sesión único de Microsoft Entra.
2. Configuración del inicio de sesión único en GitHub Enterprise Server : para configurar los valores de inicio de sesión único en la aplicación.
   1. Creación de un usuario de prueba de GitHub Enterprise Server: para tener un homólogo de B.Simon en GitHub Enterprise Server vinculado a la representación del usuario en Microsoft Entra.
3. Prueba SSO – para comprobar si la configuración funciona.

Configurar el SSO de Microsoft Entra

Siga estos pasos para activar el SSO de Microsoft Entra.

1. Inicie sesión en el Centro de administración de Microsoft Entra siendo al menos un Administrador de aplicaciones en la nube.

2. Vaya a Aplicacionesempresariales>de Entra ID>GitHub Enterprise Server>Inicio de sesión único.

3. En la página Seleccione un método de inicio de sesión único, elija SAML.

4. En la página Configurar inicio de sesión único con SAML, seleccione el icono de lápiz para Configuración básica SAML y edite la configuración.

   

5. En la sección Configuración básica de SAML , si desea configurar la aplicación en modo iniciado por IDP , realice los pasos siguientes:

   a) En el cuadro de texto Identificador (id. de entidad), escriba una dirección URL con el siguiente patrón: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>

   b. En el cuadro de texto URL de respuesta , escriba una dirección URL con el siguiente patrón: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/saml/consume

6. Seleccione Establecer direcciones URL adicionales y realice el paso siguiente si desea configurar la aplicación en modo iniciado por SP :

   En el cuadro de texto URL de inicio de sesión , escriba una dirección URL con el siguiente patrón: https://<YOUR-GITHUB-ENTERPRISE-SERVER-HOSTNAME>/sso

   Nota:

   Estos valores no son reales. Actualice estos valores con el identificador real, la dirección URL de respuesta y la dirección URL de inicio de sesión. Póngase en contacto con el equipo de soporte técnico de GitHub Enterprise Server para obtener estos valores. También puede consultar los patrones que se muestran en la sección Configuración básica de SAML .

7. La aplicación GitHub Enterprise Server espera las aserciones de SAML en un formato específico, lo que requiere que se agreguen asignaciones de atributos personalizados a la configuración de los atributos del token de SAML. En la captura de pantalla siguiente se muestra la lista de atributos predeterminados.

   

8. Editar atributos de usuario y notificaciones.

9. Seleccione Agregar nueva notificación y escriba el nombre como administrator en el cuadro de texto (el administrator valor distingue mayúsculas de minúsculas).

10. Expanda Condiciones de notificación y seleccione Miembros en Tipo de usuario.

11. Seleccione Seleccionar grupos y busque el grupo que desea incluir esta notificación, donde sus miembros deben ser administradores para GHES.

12. Seleccione Atributo para Origen y escriba true (sin comillas) para el valor.

13. Haga clic en Guardar.

    

14. En la página Configurar inicio de sesión único con SAML , en la sección Certificado de firma de SAML , busque Certificado (Base64) y seleccione Descargar para descargar el certificado y guardarlo en el equipo.

    

15. En la sección Set up GitHub Enterprise Server (Configurar GitHub Enterprise Server ), copie las direcciones URL adecuadas según sus necesidades.

    

Creación y asignación de un usuario de prueba de Microsoft Entra

Siga las instrucciones de creación y asignación de una cuenta de usuario de inicio rápido para crear una cuenta de usuario de prueba llamada B.Simon.

Configuración del inicio de sesión único de GitHub Enterprise Server

Para configurar el inicio de sesión único en GitHub Enterprise Server, debe seguir las instrucciones mencionadas aquí.

Creación de un usuario de prueba de GitHub Enterprise Server

En esta sección, se crea un usuario llamado B.Simon en GitHub Enterprise Server. GitHub Enterprise Server admite el aprovisionamiento de usuarios Just-In-Time, que está habilitado de forma predeterminada. No hay ningún elemento de acción para usted en esta sección. Si un usuario aún no existe en GitHub Enterprise Server, se crea uno después de la autenticación.

GitHub Enterprise Server también admite el aprovisionamiento automático de usuarios. Puede encontrar más detalles aquí sobre cómo configurar el aprovisionamiento automático de usuarios.

Prueba de SSO

En esta sección vas a probar la configuración de inicio de sesión único de Microsoft Entra con las siguientes opciones.

Iniciado por SP:

• Seleccione Probar esta aplicación, esta opción redirige a la dirección URL de inicio de sesión de GitHub Enterprise Server, donde puede iniciar el flujo de inicio de sesión.

• Vaya directamente a la dirección URL de inicio de sesión de GitHub Enterprise Server e inicie el flujo de inicio de sesión desde allí.

IDP iniciado:

• Seleccione Probar esta aplicación y debería iniciar sesión automáticamente en la instancia de GitHub Enterprise Server para la que configuró el inicio de sesión único.

También puede usar Aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al seleccionar el icono de GitHub Enterprise Server en Aplicaciones, si se ha configurado en modo SP, se le redirigirá a la página de inicio de sesión de la aplicación para comenzar el flujo de inicio de sesión y, si se ha configurado en modo IDP, debería iniciar sesión automáticamente en la instancia de GitHub Enterprise Server para la que configuró el inicio de sesión único. Para obtener más información, consulte Microsoft Entra My Apps.

Contenido relacionado

• Configuración del aprovisionamiento de SCIM para administrar usuarios.

• Una vez configurado GitHub Enterprise Server, puede aplicar el control de sesión, que protege la filtración e infiltración de la información confidencial de la organización en tiempo real. El control de sesión se extiende desde el acceso condicional. Obtenga información sobre cómo aplicar el control de sesión con Microsoft Defender for Cloud Apps.