Comparteix a través de

Tutorial: integración del inicio de sesión único de Microsoft Entra con GitHub Enterprise Server

  • Article

En este tutorial, aprenderá a integrar GitHub Enterprise Server con Microsoft Entra ID. Al integrar GitHub Enterprise Server con Microsoft Entra ID, puede:

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

Requisitos previos

Para empezar, necesita 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 tutorial va a configurar y probar el inicio de sesión único de Microsoft Entra 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 automático de usuarios.

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

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
  2. Vaya a Identidad>Aplicaciones>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, después, agregue la aplicación. Espere unos segundos mientras la aplicación se agrega al inquilino.

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

Configure y pruebe Microsoft Entra SSO para GitHub Enterprise Server

Configure y pruebe el inicio de sesión único de Microsoft Entra en GitHub Enterprise Server con un usuario de prueba llamado B.Simon. Para que el inicio de sesión único funcione, necesita establecer una relación de vínculo entre un usuario de Microsoft Entra y el usuario relacionado en GitHub Enterprise Server.

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

  1. Configure el inicio de sesión único de Microsoft Entra: para que los usuarios puedan utilizar esta característica.
    1. Cree 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 de GitHub Enterprise Server: para configurar los valores de inicio de sesión único en la aplicación.
    1. Crear un usuario de prueba de GitHub Enterprise Server: para tener un homólogo de B.Simon en GitHub Enterprise Server que esté vinculado a la representación del usuario en Microsoft Entra.
  3. Prueba del inicio de sesión único : para comprobar si la configuración funciona.

Configuración del inicio de sesión único de Microsoft Entra

Siga estos pasos para habilitar el SSO de Microsoft Entra.

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.

  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>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 Configuración del inicio de sesión único con SAML, haga clic en el icono de lápiz de Configuración básica de SAML para editar la configuración.

    Screenshot shows to edit Basic S A M L Configuration.

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

    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. Haga clic en Establecer direcciones URL adicionales y siga este paso si desea configurar la aplicación en el 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 y las direcciones URL de inicio de sesión y de respuesta reales. 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. Para ello, es necesario agregar asignaciones de atributos personalizados a la configuración de los atributos del token SAML. La siguiente captura de muestra la lista de atributos predeterminados.

    Screenshot shows the image of Enterprise Server application.

  8. Edite Atributos y notificaciones de usuario.

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

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

  11. Haga clic en Seleccionar grupos y busque el grupo en el que desee incluir esta notificación, donde sus miembros deben ser administradores de GHES.

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

  13. Haga clic en Save(Guardar).

    Screenshot shows to manage claim for attributes.

    Nota:

    Para ver las instrucciones sobre cómo agregar una notificación, consulte el vínculo.

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

    Screenshot shows the Certificate download link.

  15. En la sección Configurar GitHub Enterprise Server, copie las direcciones URL adecuadas en función de los requisitos.

    Screenshot shows to copy appropriate configuration U R L.

Cree un usuario de prueba de Microsoft Entra

En esta sección, se crea un usuario llamado B.Simon.

  1. Inicie sesión en el Centro de administración de Microsoft Entra al menos como Administrador de usuario.
  2. Vaya aIdentidad>Usuarios>Todos los usuarios.
  3. Seleccione Nuevo usuario>Crear nuevo usuario, en la parte superior de la pantalla.
  4. En las propiedades del usuario, siga estos pasos:
    1. En el campo Nombre para mostrar, escriba B.Simon.
    2. En el campo Nombre principal de usuario, escriba username@companydomain.extension. Por ejemplo, B.Simon@contoso.com.
    3. Active la casilla Show password (Mostrar contraseña) y, después, anote el valor que se muestra en el cuadro Contraseña.
    4. Seleccione Revisar + crear.
  5. Seleccione Crear.

Asignación del usuario de prueba de Microsoft Entra

En esta sección, permitirá que B.Simon utilice el inicio de sesión único otorgándole acceso a GitHub Enterprise Server.

  1. Inicie sesión en el Centro de administración de Microsoft Entra como Administrador de aplicaciones en la nube.
  2. Vaya a Identidad>Aplicaciones>Aplicaciones empresariales>GitHub Enterprise Server.
  3. En la página de información general de la aplicación, seleccione Usuarios y grupos.
  4. Seleccione Agregar usuario o grupo. A continuación, en el cuadro de diálogo Agregar asignación, seleccione Usuarios y grupos.
    1. En el cuadro de diálogo Usuarios y grupos, seleccione B.Simon de la lista de usuarios y haga clic en el botón Seleccionar de la parte inferior de la pantalla.
    2. Si espera que se asigne un rol a los usuarios, puede seleccionarlo en la lista desplegable Seleccionar un rol. Si no se ha configurado ningún rol para esta aplicación, verá seleccionado el rol "Acceso predeterminado".
    3. En el cuadro de diálogo Agregar asignación, haga clic en el botón Asignar.

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 no existe ya 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; aquí puede encontrar más detalles sobre cómo configurarlo.

Prueba de SSO

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

Iniciado por SP:

  • Haga clic en Probar esta aplicación; esto le redirigirá a la dirección URL de inicio de sesión de GitHub Enterprise Server, donde podrá poner en marcha 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í.

Iniciado por IDP:

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

También puede usar Aplicaciones de Microsoft para probar la aplicación en cualquier modo. Al hacer clic en 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, se debería iniciar sesión automáticamente en la instancia de GitHub Enterprise Server para la que ha configurado el inicio de sesión único. Para más información, vea Aplicaciones en Microsoft Entra.

Pasos siguientes