Migración de SAML a OIDC

Si usas SAML para autenticar miembros en tu empresa con usuarios administrados, puedes migrar a OpenID Connect (OIDC) y beneficiarte de la compatibilidad con la Directiva de acceso condicional de tu proveedor de identidades.

¿Quién puede utilizar esta característica?

Enterprise Managed Users está disponible para las cuentas empresariales nuevas que usan GitHub Enterprise Cloud. Consulte "Acerca de Enterprise Managed Users".

En este artículo

Note

La compatibilidad de OpenID Connect (OIDC) y la directiva de acceso condicional (CAP) con Enterprise Managed Users solo está disponible para Microsoft Entra ID (anteriormente Azure AD).

Acerca de la migración de empresa con usuarios administrados de SAML a OIDC

Si en empresa con usuarios administrados se usa el SSO de SAML para autenticarse con Entra ID, puedes migrar a OIDC. Cuando la empresa usa el inicio de sesión único de OIDC, GitHub usará automáticamente las condiciones IP de la directiva de acceso condicional (CAP) de IdP para validar las interacciones con GitHub, cuando los miembros usan las interfaz de usuario web o cambian las direcciones IP y para cada autenticación con personal access token o una clave SSH asociada a una cuenta de usuario.

Note

La protección CAP para sesiones web se encuentra actualmente en versión preliminar pública y está sujeta a cambios.

Las nuevas empresas que habilitan la compatibilidad con IdP CAP después del 5 de noviembre de 2024 tendrán protección para las sesiones web habilitadas de forma predeterminada.

Las empresas existentes que ya han habilitado la compatibilidad con IdP CAP pueden optar por la protección ampliada para las sesiones web desde la configuración de "Authentication security" de su empresa.

Al migrar de SAML a OIDC, cuentas de usuario administradas y los grupos que estaban aprovisionados para SAML, pero que no están aprovisionados por la aplicación GitHub Enterprise Managed User (OIDC), tendrán el sufijo "(SAML)" adjunto al nombre para mostrar.

Si no estás familiarizado con Enterprise Managed Users y todavía no configuraste la autenticación para tu empresa, no es necesario que migres y puedes configurar el inicio de sesión único de OIDC de inmediato. Para obtener más información, vea «Configuración de OIDC para usuarios administrados de Enterprise».

Warning

Al migrar a un nuevo IdP o inquilino, se eliminan las conexiones entre GitHub equipos y grupos de IdP, y no se restablecen después de la migración. Esto eliminará todos los miembros del equipo y dejará el equipo sin conectar con el IdP, lo que puede provocar interrupciones si utilizas la sincronización del equipo para administrar el acceso a organizaciones o licencias de tu IdP. Se recomienda usar los puntos de conexión de "Grupos externos" de la API de REST para recopilar información sobre la configuración de los equipos antes de migrar y restablecer las conexiones después. Para obtener más información, vea «Puntos de conexión de la API de REST para grupos externos».

Requisitos previos

  • La empresa en GitHub debe estar configurada actualmente a fin de utilizar SAML para la autenticación, con Entra ID como proveedor de identidades (IdP). Para obtener más información, vea «Configurar el inicio de sesión único de SAML para los usuarios administrados de Enterprise».

  • Tendrá que acceder a su empresa en GitHub y al inquilino en Entra ID.

  • Programa una hora para migrar en la que los usuarios no estén usando activamente los recursos de la empresa. Durante la migración, los usuarios no pueden acceder a la empresa hasta que hayas configurado la nueva aplicación y se hayan reaprovisionado los usuarios.

Migración de tu empresa

Para migrar la empresa de SAML a OIDC, deshabilite la aplicación GitHub Enterprise Managed User existente en Entra ID, prepare e inicie la migración como usuario de configuración de la empresa en GitHub y, luego, instale y configure la nueva aplicación para OIDC en Entra ID. Una vez que se haya completado la migración y Entra ID haya aprovisionado a los usuarios, estos pueden autenticarse para acceder a los recursos de la empresa en GitHub mediante OIDC.

Warning

La migración de tu empresa de SAML a OIDC puede tardar hasta una hora. Durante la migración, los usuarios no pueden acceder a la empresa en GitHub.

  1. Antes de empezar la migración, inicia sesión en Azure y deshabilita el aprovisionamiento en la aplicación GitHub Enterprise Managed User existente.

  2. Si usa directivas de ubicación de red de acceso condicional (CA) en Entra ID y actualmente utiliza una lista de direcciones IP permitidas con su cuenta empresarial o con cualquiera de las organizaciones que pertenecen a la cuenta empresarial, deshabilite las listas de direcciones IP permitidas. Para obtener más información, vea «Requerir las políticas para los ajustes de seguridad en tu empresa» y «Administrar las direcciones IP permitidas en tu organización».

  3. Inicia sesión como el usuario de configuración de la empresa con el nombre de usuario SHORT-CODE_admin, reemplazando SHORT-CODE por el código corto de tu empresa.

  4. En la esquina superior derecha de GitHub, haz clic en la fotografía del perfil.

  5. En función de tu entorno, haz clic en Your enterpriseo en Your enterprises y, a continuación, haz clic en la empresa que deseas ver. 1. En el lado izquierdo de la página, en la barra lateral de la cuenta de empresa, haz clic en Configuración. 1. Cuando se te pida continuar a tu proveedor de identidades, haz clic en Usar un código de recuperación e inicia sesión con uno de los códigos de recuperación de la empresa.

    Nota: Debes usar un código de recuperación para la empresa, no para la cuenta de usuario. Para obtener más información, vea «Descarga de los códigos de recuperación de inicio de sesión único de la cuenta de la empresa».

  6. En Configuración, haz clic en Seguridad de autenticación.

  7. En la parte inferior de la página, junto a "Migrar al inicio de sesión único de OpenID Connect", haz clic en Configurar con Azure.

  8. Lee la advertencia y, a continuación, haz clic en Entiendo, comenzar la migración a OpenID Connect.

  9. Cuando GitHub Enterprise Cloud te redirija a tu proveedor de identidades, inicia sesión en el proveedor de identidades y sigue las instrucciones para dar tu consentimiento e instalar la aplicación GitHub Enterprise Managed User (OIDC). Después de que Entra ID solicite permisos para GitHub Enterprise Managed Users con OIDC, habilita Consentimiento en nombre de la organización y, después, haz clic en Aceptar.

    Advertencia: Debes iniciar sesión en Entra ID como usuario con derechos de administrador global para dar el consentimiento a la instalación de la aplicación GitHub Enterprise Managed User (OIDC).

  10. Después de conceder consentimiento, se abrirá una nueva ventana del explorador en GitHub y mostrará un nuevo conjunto de códigos de recuperación para empresa con usuarios administrados. Descarga los códigos y haz clic en Habilitar autenticación OIDC.

  11. Espera a que se complete la migración, que puede tardar hasta una hora. Para comprobar el estado de la migración, ve a la página de configuración de seguridad de autenticación de la empresa. Si se selecciona "Requerir autenticación SAML", la migración sigue en curso.

    Warning

    No aprovisiones nuevos usuarios de la aplicación en Entra ID durante la migración.

  12. En una pestaña o ventana nueva, mientras sigues en la sesión que iniciaste como usuario de configuración, crea un personal access token (classic) con el ámbito scim:enterprise y sin expiración y cópialo en el Portapapeles. Para más información sobre cómo crear un token, consulta "Configuración del aprovisionamiento de SCIM para usuarios administrados empresariales".

  13. En la configuración de aprovisionamiento de la aplicación GitHub Enterprise Managed User (OIDC) del Centro de administración Microsoft Entra, en "Tenant URL", escribe la dirección URL de inquilino de tu empresa:

    • Para GitHub.com: https://api.github.com/scim/v2/enterprises/YOUR_ENTERPRISE, reemplazando YOUR_ENTERPRISE por el nombre de tu cuenta de empresa. Por ejemplo, si la dirección URL de tu cuenta empresarial es https://github.com/enterprises/octo-corp, el nombre de la cuenta empresarial es octo-corp.
    • Para GHE.com: https://api.SUBDOMAIN.ghe.com/scim/v2/enterprises/SUBDOMAIN, donde SUBDOMAIN es el subdominio de la empresa en GHE.com.

  14. En "Secret token", pega personal access token (classic) con el ámbito scim:enterprise que creaste anteriormente.

  15. Para probar la configuración, haz clic en Probar conexión.

  16. Para guardar los cambios, haz clic en Guardar en la parte superior del formulario.

  17. En el centro de administración de Microsoft Entra, copia los usuarios y los grupos de la aplicación GitHub Enterprise Managed User anterior a la aplicación GitHub Enterprise Managed User (OIDC) nueva.

  18. Para probar la configuración, aprovisiona un usuario nuevo único.

  19. Si la prueba se completa correctamente, empieza a aprovisionar para todos los usuarios con un clic en Iniciar aprovisionamiento.