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 podrán usar sus credenciales de Google Workspace para acceder a una app con el SSO.
Usa SAML para configurar el SSO para Jenkins
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 Enter app name, ingresa Jenkins.
- En los resultados de la búsqueda, apunta a Jenkins Web (SAML) 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 entidad, haz clic en Copiar
y guarda el ID de la entidad.
- Junto a Certificado, haz clic en Copiar
y guarda el certificado.
Necesitas estos detalles para completar la configuración en Jenkins.
- Junto a URL de SSO, haz clic en Copiar
- Haz clic en Continuar.
En la página Detalles del proveedor de servicios, los detalles de la app se configuran de forma predeterminada. - Ingresa la URL de ACS y el ID de la entidad. Para obtener más información, consulta SAML Single Sign On (SSO) into Jenkins using Google Apps as IDP.
- Haz clic en Continuar.
-
(Opcional) Para asignar atributos del directorio de Google a los atributos correspondientes de la app, en la ventana Attribute Mapping, haz lo siguiente:
- Haz clic en Agregar asignación.
- Haz clic en Seleccionar campo
selecciona un atributo del directorio de Google.
- En Atributos de la app, ingresa el atributo de la app correspondiente.
-
(Opcional) Para ingresar nombres de grupos 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 Jenkins como proveedor de servicios de SAML 2.0
- Abre una nueva ventana del navegador en modo incógnito, ve a la página de acceso de Jenkins y accede con tu cuenta de administrador de Jenkins.
- Haz clic en el nombre de tu cuenta.
- Haz clic en Manage Jenkins
Configure Global Security.
- Marca la casilla Habilitar seguridad.
- En Security Realm, selecciona miniOrange SAML 2.0.
- Haz clic en Configurar.
- En IdP configuration, pega el contenido de los metadatos que descargaste en el paso 1.
- Haz clic en Test Configuration.
Se te redireccionará a la página de acceso de Google.
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 Jenkins.
- Haz clic en Acceso de usuario.
-
Para activar o desactivar un servicio para todas las personas de tu organización, haz clic en Activado para todos o Desactivado para todos y, luego, en Guardar.
-
(Opcional) Si quieres 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 Activado o Desactivado.
- 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 de nivel 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 Jenkins coincidan con el dominio principal de la Cuenta de Google administrada de tu organización.
Paso 4: Verifica que el SSO funcione
Jenkins 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 Jenkins.
- En la sección Jenkins, haz clic en Test SAML Login.
La app debería abrirse en una pestaña separada. Si no es así, 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 SAML.
Verifica el SSO iniciado por el proveedor de servicios
- Cierra todas las ventanas del navegador.
- Ve a la página de acceso de Jenkins y accede con tu cuenta de administrador de Jenkins.
Se te redireccionará a la página de acceso de Google. - Selecciona tu cuenta y luego ingresa tu contraseña.
Una vez que se autentiquen tus credenciales, se abrirá la app.
Google, Google Workspace y las marcas y los logotipos relacionados son marcas de Google LLC. Todos los demás nombres de productos y empresas son marcas de las empresas con las que están asociados.