1. Introducción
Google Workspace SSO permite a tu organización usar los detalles de tu cuenta de Google para iniciar sesión en otras aplicaciones empresariales. Esto significa que tus usuarios inician sesión una vez usando sus credenciales de Google Workspace y se conectan automáticamente a las aplicaciones aprobadas. En esta guía, explicamos cómo configurar Google Workspace como un Proveedor de Identidad (IdP) para acceder a la plataforma Cyber Guru.
2. Qué Necesitas Antes de Comenzar
- Una cuenta de administrador para Google Workspace (la cuenta con el rol de “Admin”)
- Acceso a tu Consola de Administración de Google (normalmente en https://admin.google.com)
- Disponibilidad de los valores para las siguientes afirmaciones:
- nombre de usuario
- nombre
- apellido
- correo electrónico
- Obtener los metadatos del proveedor IdP como una URL accesible por internet
- Identificar a los usuarios que serán autorizados para acceder a la aplicación (sería mejor grupos adecuados)
- Si es posible, crear un usuario para Cyber Guru con fines de prueba
3. Instrucciones Paso a Paso
3.1. Iniciar Sesión en la Consola de Administración de Google
- Abre tu navegador web y ve a https://admin.google.com.
- Inicia sesión usando tu dirección de correo electrónico de administrador y contraseña.
3.2. Localizar la Configuración de SAML SSO y enviar Metadatos de IdP
- Dependiendo del diseño de tu Consola de Administración de Google, encontrarás la configuración de SSO en uno de dos lugares principales. Intenta lo siguiente:
- Opción A: Desde la Página de Inicio
- En la página de inicio de la Consola de Administración
- Busca “Apps” (puede estar representado como un ícono o listado en el menú) y haz clic en él.
- A continuación, haz clic en “Aplicaciones web y móviles.” Aquí es donde gestionas las aplicaciones SAML.
- Opción B: Usando el Menú de Seguridad
- Si ves “Seguridad” en la página de inicio, haz clic en eso.
- En “Seguridad,” busca “Configurar inicio de sesión único (SSO) para aplicaciones SAML.” (Si no ves “Seguridad,” haz clic en “Mostrar más” o usa la barra de búsqueda en la parte superior de la Consola de Administración para buscar “SSO”).
La opción utilizada en este documento es la n.1
En el menú de la izquierda selecciona “Apps” y luego “Aplicaciones web y móviles”
Selecciona “Configuración” -> “Certificados SAML”
Obtendrás una página con los detalles del Proveedor de Identidad de Google.
Ve al final de la página
Haz clic en “DESCARGAR METADATOS”
Envía el archivo GoogleIDPMetadata.xml a Cyber Guru. Tan pronto como Cyber Guru complete la configuración de su lado, el archivo xml de Metadatos SP será enviado al cliente.
3.3. Añadir una Nueva Aplicación SAML
Regresa al menú principal
Selecciona “Aplicaciones” -> “aplicaciones web y móviles”
Luego, en el panel derecho selecciona “Añadir aplicación” -> “Añadir aplicación SAML personalizada”
Rellena el “nombre de la aplicación” y la “Descripción” y haz clic en “Continuar”.
Estos son los metadatos del IdP. Ya enviaste estos datos en los pasos anteriores.
Haz clic en “Continuar”.
El valor para los campos en rojo (ACS URL y Entity ID) se encuentra en el archivo de metadatos SP enviado por Cyber Guru. A continuación, los extractos del archivo xml donde se ubican los datos:
ACS URL
<md:AssertionConsumerService Binding="urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST" Location="https://login.stage.cyberguru.dev/realms/techcorpgoo/broker/saml/endpoint" isDefault="true" index="1"/>ID de la entidad
<md:EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" xmlns:md="urn:oasis:names:tc:SAML:2.0:metadata" xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" entityID="https://login.stage.cyberguru.dev/realms/techcorpgoo" ID="ID_dcdf9592-8351-4344-936c-5fc195636230">Rellena el formulario con la URL de ACS y el ID de entidad y cambia el “Formato de ID de nombre” a “TRANSIENTE”
Haz clic en "Continuar"
Haz clic en “AÑADIR MAPEADO”
Aquí configuramos las reclamaciones solicitadas por Cyber Guru después de la autenticación.
Nombre de usuario
NOTA: Para este campo, Cyber Guru sugiere encarecidamente usar un valor que no cambie en el futuro. Por lo tanto, si existe la posibilidad de que el “Correo electrónico principal” cambie en el futuro, utiliza un campo diferente como “ID de empleado” o similar
Haz clic en "AÑADIR MAPEADO"
Haz clic en "AÑADIR MAPEADO"
Haz clic en "AÑADIR MAPEADO"
Haz clic en “Finalizar” al final de la página. La aplicación se ha creado y esto es lo que deberías ver:
3.4. Habilitar la Aplicación para tus Usuarios
En la vista general de la aplicación recién creada, localiza el panel de Acceso de Usuario
Haz clic en "DESACTIVADO para todos"
Haz clic en "Grupos" y selecciona el grupo que contiene a los usuarios autorizados para usar la aplicación.
En este ejemplo de configuración seleccionamos TechCorporation. Por favor, selecciona el grupo de tu organización, habilita el Estado del Servicio y haz clic en "Guardar".
3.5. Prueba el inicio de sesión SSO
Antes de implementarlo en toda tu organización, probemos la configuración:
Abre una ventana de navegador en modo incógnito o privado.
-
Navega a la página de inicio de sesión: https://<subdomain>.platform.cyberguru.eu
Haz clic en el botón “LogInWith (Techcorpgoo IdP)”
NOTA: Techcorpgoo es la empresa utilizada para probar la presente guía.
La página de inicio de sesión de tu espacio de trabajo de Google aparecerá:
Inicia sesión usando tus credenciales de Google Workspace y luego serás redirigido de vuelta al servicio. Si todo funciona correctamente, deberías recibir la página de bienvenida de Cyber Guru.
4. Solución de problemas y consejos
Si recibes una página de error al iniciar sesión, verifica que la URL de SSO y otros detalles ingresados en la configuración del proveedor de servicios coincidan con lo que descargaste de Google.
Recuerda que la propagación de DNS o certificados puede tardar unos minutos. Si los cambios no aparecen de inmediato, espera un poco y vuelve a intentarlo.
Mantén el certificado o archivo de metadatos descargado en un lugar seguro. Podrías necesitar actualizarlo si ocurren cambios en la configuración de tu Google Workspace.
Usando un rastreador SAML, verifica los valores de las declaraciones en la respuesta SAML. Por ejemplo:
.
<saml2:AttributeStatement>
<saml2:Attribute Name="username">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
gianmarco.cagnotto@testcyberguru.org
</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="firstName"><saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
Gianmarco
</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="lastName">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
Cagnotto</saml2:AttributeValue>
</saml2:Attribute>
<saml2:Attribute Name="email">
<saml2:AttributeValue xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="xsd:anyType" >
gianmarco.cagnotto@testcyberguru.org
</saml2:AttributeValue>
</saml2:Attribute>
</saml2:AttributeStatement>5. Obtener más ayuda
-
Google tiene un Centro de Ayuda dedicado en https://support.google.com/ para artículos adicionales y consejos de solución de problemas.
-
Si alguna vez tienes dudas, consulta al soporte técnico de tu organización o al socio de Google Workspace para obtener ayuda.