Con el estándar SAML 2.0, puedes configurar el inicio de sesión único (SSO) para varias apps en la nube. Después de configurar el SSO, los usuarios pueden usar sus credenciales de Google Workspace para acceder a una app con SSO.
Usa SAML para configurar el SSO para GitHub Enterprise
Debes acceder como administrador avanzado para realizar esta tarea.Paso 1: Configura Google como proveedor de identidad de SAML
-
En la Consola del administrador de Google, ve a Menú
Apps
Apps web y para dispositivos móviles.
Debes acceder como administrador avanzado para realizar esta tarea.
-
Haz clic en Agregar app
Buscar apps.
- En Ingresa el nombre de la app, ingresa GitHub Business.
- En los resultados de la búsqueda, coloca el cursor sobre GitHub Business y haz clic en Seleccionar.
- En la ventana Detalles del proveedor de identidad de Google, en Opción 2: Copia la URL de SSO, el ID de la entidad y el certificado, haz lo siguiente:
- Junto a URL de SSO, haz clic en Copiar
y guarda la URL.
- Junto a ID de la entidad, haz clic en Copiar
y guarda la URL.
- Junto a Certificado, haz clic en Descargar
para descargar el certificado.
Necesitas estos detalles para completar la configuración en GitHub Enterprise.
- Junto a URL de SSO, haz clic en Copiar
- Haz clic en Continuar.
- En la página Detalles del proveedor de servicios, en URL de ACS y ID de la entidad, reemplaza {your-organization} por el nombre de tu organización de GitHub Enterprise.
- Haz clic en Continuar.
- En la ventana Asignación de atributos, haz clic en Seleccionar campo y asigna los siguientes atributos del directorio de Google a sus atributos correspondientes de GitHub Enterprise. Los atributos firstName y lastName son obligatorios.
Atributos del directorio de Google Atributos de la app Información básica > Nombre firstName* Información básica > Apellido lastName* - (Opcional) Para agregar asignaciones adicionales, haz clic en Agregar asignación y selecciona los campos que necesitas asignar.
-
(Opcional) Para ingresar nombres de grupos que sean relevantes para esta app, haz lo siguiente:
- En Pertenencia a un grupo (opcional), haz clic en Buscar un grupo, ingresa una o más letras del nombre del grupo y selecciona el nombre del grupo.
- Agrega grupos adicionales según sea necesario (máximo de 75 grupos).
- En Atributo de la app, ingresa el nombre del atributo de grupos correspondiente del proveedor de servicios.
Independientemente de la cantidad de nombres de grupos que ingreses, la respuesta de SAML solo incluye los grupos de los que un usuario es miembro (directa o indirectamente). Para obtener más información, consulta Acerca de la asignación de pertenencia a un grupo.
- Haz clic en Finalizar.
Paso 2: Configura GitHub Enterprise como proveedor de servicios de SAML 2.0
- Abre una ventana del navegador en modo Incógnito, ve a la página de acceso de GitHub Enterprise y accede con tu cuenta de administrador de GitHub Enterprise.
- Haz clic en tu nombre de usuario
Configuración.
- Haz clic en el nombre de tu organización
Seguridad.
- En Inicio de sesión único basado en SAML , haz lo siguiente:
- En el campo URL de acceso, pega la URL de SSO que copiaste anteriormente.
- En el campo Emisor, pega el ID de la entidad que copiaste anteriormente.
- En el campo Certificado público, copia el certificado que descargaste anteriormente.
- Haz clic en Probar la configuración de SAML para verificar tu configuración.
- Marca la casilla Habilitar la autenticación de SAML.
- Haz clic en Guardar.
Paso 3: Activa la app para los usuarios
-
En la Consola del administrador de Google, ve a Menú
Apps
Apps web y para dispositivos móviles.
Debes acceder como administrador avanzado para realizar esta tarea.
- Haz clic en GitHub Business.
- Haz clic en Acceso de usuarios.
-
Si quieres activar o desactivar un servicio para todos en tu organización, haz clic en Activado para todos o Desactivado para todos y, luego, selecciona Guardar.
-
(Opcional) Si deseas activar o desactivar un servicio para una unidad organizativa, sigue estos pasos:
- Sobre la izquierda, selecciona la unidad organizativa.
- Para cambiar el estado del servicio, selecciona Activar o Desactivar.
- Elige una opción:
- Si el estado del servicio se establece como Heredado y quieres mantener el parámetro de configuración actualizado, incluso si cambia el parámetro superior, haz clic en Anular.
- Si el estado del servicio se estableció como Anulado, haz clic en Heredar para revertir al mismo parámetro de configuración que el del elemento superior o en Guardar para mantener el parámetro nuevo incluso si cambia el de nivel superior.
Obtén más información sobre la estructura organizativa.
- (Opcional) Si quieres activar un servicio para un conjunto de usuarios de una misma unidad organizativa o de varias, selecciona un grupo de acceso. Para obtener más detalles, consulta Personaliza el acceso a los servicios con grupos de acceso.
- Asegúrate de que los dominios de correo electrónico de tu cuenta de usuario de GitHub Enterprise coincidan con el dominio principal de la Cuenta de Google administrada de tu organización.
Paso 4: Verifica que el SSO funcione
GitHub Enterprise admite el SSO iniciado por el proveedor de identidad y el SSO iniciado por el proveedor de servicios.
Verifica el SSO iniciado por el proveedor de identidad
-
En la Consola del administrador de Google, ve a Menú
Apps
Apps web y para dispositivos móviles.
Debes acceder como administrador avanzado para realizar esta tarea.
- Haz clic en GitHub Business.
- En la sección GitHub Business, haz clic en Probar acceso con SAML.
La app debería abrirse en una pestaña aparte. Si no lo hace, soluciona el mensaje de error y vuelve a intentarlo. Para obtener detalles sobre la solución de problemas, consulta Mensajes de error de la app de SAML.
Verifica el SSO iniciado por el proveedor de servicios
- Cierra todas las ventanas del navegador.
- Abre https://github.com/orgs/{your-organization}/sso y trata de acceder. El sistema te debería redireccionar automáticamente a la página de acceso de Google.
- Ingresa tus credenciales de acceso.
Una vez que se autentiquen tus credenciales de acceso, se te redireccionará automáticamente a GitHub Enterprise.
- Accede con las credenciales de tu cuenta personal de GitHub.
Google, Google Workspace y las marcas y los logotipos relacionados son marcas comerciales de Google LLC. Todos los demás nombres de productos y empresas son marcas comerciales de las empresas con las que se encuentran asociados.