Tutorial: Integración del inicio de sesión único de Microsoft Entra con una organización de GitHub Enterprise Cloud

En este tutorial, aprenderá a integrar una organización de GitHub Enterprise Cloud con Microsoft Entra ID. Al integrar una organización de GitHub Enterprise Cloud con Microsoft Entra ID, puede:

• Controlar en Microsoft Entra ID quién tiene acceso a la organización de GitHub Enterprise Cloud.
• Administre el acceso a la organización en la nube de GitHub Enterprise 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.
• Una organización GitHub creada en GitHub Enterprise Cloud, que requiere el plan de facturación de GitHub Enterprise.

Descripción del escenario

En este tutorial se configura y prueba el inicio de sesión único de Microsoft Entra en un entorno de prueba.

• GitHub admite el inicio de sesión único iniciado por SP

• GitHub admite el aprovisionamiento de usuarios (invitaciones de la organización) automatizado.

Adición de GitHub desde la galería

Para configurar la integración de GitHub en Microsoft Entra ID, deberá agregar GitHub desde la galería a la 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 en el cuadro de búsqueda.
4. Seleccione GitHub Enterprise Cloud - Organization en el panel de resultados y, a continuación, 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.

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

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

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

1. Configure el inicio de sesión único de Microsoft Entra para que los usuarios puedan usar 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 en GitHub , para configurar los valores de Inicio de sesión único en la aplicación.
   1. Creación de un usuario de prueba de GitHub, para tener un homólogo de B.Simon en GitHub que esté vinculado a la representación de ella 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>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.

   

5. En la sección Configuración básica de SAML, especifique los valores de los siguientes campos:

   a. En el cuadro de texto Identificador (id. de entidad) , escriba una dirección URL con el siguiente patrón: https://github.com/orgs/<Organization ID>

   b. En el cuadro de texto URL de respuesta, escriba una dirección URL con el siguiente patrón: https://github.com/orgs/<Organization ID>/saml/consume

   c. En el cuadro de texto URL de inicio de sesión, escriba una dirección URL con el siguiente patrón: https://github.com/orgs/<Organization ID>/sso

   Nota:

   Tenga en cuenta que estos no son valores reales. Tiene que actualizarlos con el identificador, la dirección URL de respuesta y la URL de inicio de sesión reales. Aquí le recomendamos que utilice el valor de cadena único en el identificador. Vaya a la sección de administración de GitHub para recuperar estos valores.

6. La aplicación GitHub espera las aserciones de SAML en un formato específico, que requiere que se agreguen asignaciones de atributos personalizados a la configuración de los atributos del token de SAML. La siguiente captura de pantalla muestra la lista de atributos predeterminados, donde a Unique User Identifier (Name ID) (Identificador de usuario único [Identificador de nombre]) se le ha asignado user.userprincipalname. La aplicación GitHub espera que al identificador de usuario único (Identificador de nombre) se le haya asignado user.mail, por lo que se debe editar la asignación de atributos. Para ello, haga clic en el icono Editar y cambie la asignación de atributos.

   

7. En la página Configurar el inicio de sesión único con SAML, en la sección Certificado de firma de SAML, haga clic en Descargar para descargar el certificado (Base64) de las opciones proporcionadas según sus requisitos y guárdelo en el equipo.

   

8. En la sección Set up GitHub (Configurar GitHub), copie las direcciones URL que necesite.

   

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 use el inicio de sesión único para conceder acceso a GitHub.

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.

3. En la página de información general de la aplicación, busque la sección Administrar y seleccione Usuarios y grupos.

4. Seleccione Agregar usuario. A continuación, en el cuadro de diálogo Agregar asignación, seleccione Usuarios y grupos.

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

6. 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".

   

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

1. En otra ventana del explorador web, inicie sesión en el sitio de la organización de GitHub como administrador.

2. Vaya a Configuración y haga clic en Seguridad.

   

3. Active la casilla Habilitar autenticación SAML para ver los campos de configuración del inicio de sesión único y siga estos pasos:

   

   a. Copie el valor de Dirección URL de inicio de sesión único y péguelo en el cuadro de texto URL de inicio de sesión de la Configuración básica de SAML.

   b. Copie el valor de Dirección URL del Servicio de consumidor de aserciones y péguelo en el cuadro de texto Dirección URL de respuesta de Configuración básica de SAML.

4. Configure los campos siguientes:

   

   a. En el cuadro de texto URL de inicio de sesión, pegue el valor de la URL de inicio de sesión que copió anteriormente.

   b. En el cuadro de texto Emisor, pegue el valor de Identificador de Microsoft Entra que ha copiado antes.

   c. Abra el certificado descargado de Azure Portal en el Bloc de notas y pegue el contenido en el cuadro de texto Certificado público.

   d. Haga clic en el icono Editar para editar el Método de firma y el Método de resumen desde RSA-SHA1 y SHA1 hasta RSA-SHA256 y SHA256 tal como se muestra a continuación.

   e. Actualice la dirección URL del servicio de consumidor de aserciones (URL de respuesta) con respecto a la dirección URL predeterminada, con el fin de que la dirección URL de GitHub coincida con la del registro de aplicaciones de Azure.

   

5. Haga clic en Test SAML configuration (Probar configuración de SAML) para configura que no hay errores de validación durante el SSO.

   

6. Haga clic en Guardar

Nota:

El inicio de sesión único en GitHub realiza la autenticación en una organización específica de GitHub, pero no reemplaza la autenticación propia de GitHub. Por tanto, si la sesión del usuario en github.com ha expirado, puede que se le pida que se autentique con la contraseña o el identificador de GitHub durante el proceso de inicio de sesión único.

Creación de un usuario de prueba en GitHub

El objetivo de esta sección es crear un usuario de prueba llamado Britta Simon en GitHub. GitHub admite el aprovisionamiento automático de usuarios, que está habilitado de forma predeterminada. Aquí puede encontrar más información sobre cómo configurar el aprovisionamiento automático de usuarios.

Para crear un usuario manualmente, siga los pasos siguientes:

1. Inicie sesión en el sitio de la empresa de GitHub como administrador.

2. Haga clic en Contactos.

   

3. Haga clic en Invitar a miembros.

   

4. En la página de diálogo Invitar a miembros, realice los siguientes pasos:

   a. En el cuadro de texto Correo electrónico, escriba la dirección de correo electrónico de la cuenta de Britta Simon.

   

   b. Haga clic en Enviar invitación.

   

   Nota:

   El titular de la cuenta de Microsoft Entra recibirá un mensaje de correo y seguirá un vínculo para confirmar su cuenta antes de que se active.

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.

• Haga clic en Probar esta aplicación, lo que le redirigirá a la dirección URL de inicio de sesión de GitHub, donde se puede poner en marcha el flujo de inicio de sesión.

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

• Puede usar Mis aplicaciones de Microsoft. Al hacer clic en el icono de GitHub en Mis aplicaciones, se le redirigirá a la URL de inicio de sesión de la aplicación. Para más información acerca de Aplicaciones, consulte Inicio de sesión e inicio de aplicaciones desde el portal Aplicaciones.

Pasos siguientes

Una vez que haya configurado GitHub, puede aplicar el control de sesión, que protege su organización, en tiempo real, frente a la filtración e infiltración de información confidencial. El control de sesión procede del acceso condicional. Aprenda a aplicar el control de sesión con Microsoft Defender para aplicaciones en la nube.