Skip to content

Configurar el inicio de sesión con Google (SSO) ​

Acceso

Ruta: ¡Hola! Store → Google → Instalar

Visión general ​

La app Google permite que los usuarios inicien sesión en ¡Hola! Suite con la cuenta de Google de la empresa, sin escribir la contraseña de ¡Hola! Suite. Este tipo de acceso se llama inicio de sesión único, o SSO (Single Sign-On). Así, el acceso queda centralizado en las cuentas de Google que la empresa ya administra.

¡Hola! Suite identifica al usuario por el correo electrónico: el correo de la cuenta de Google debe ser el mismo correo registrado para el usuario en ¡Hola! Suite.

Requisitos previos ​

  • Permiso para visualizar ¡Hola! Store en tu grupo de permisos.
  • Acceso a la consola de Google Cloud para crear un cliente OAuth.
  • Usuarios registrados y activos en ¡Hola! Suite, con el mismo correo electrónico de las cuentas de Google. El inicio de sesión con Google no crea usuarios.
  • Ninguna otra app de SSO instalada. ¡Hola! Suite acepta una app de SSO a la vez.

Paso a paso ​

1. Crear el cliente OAuth en Google Cloud ​

  1. En la consola de Google Cloud, abre la página Clients de Google Auth Platform. Si el proyecto aún no está registrado en Google Auth Platform, Google pide ese registro antes de crear el cliente.
  2. Haz clic en Create client y elige el tipo Web application.
  3. En Authorized redirect URIs, agrega la dirección de abajo, reemplazando por la dirección de tu ¡Hola! Suite: https://endereco-do-seu-opa-suite/auth/login/sso/callback/google
  4. Haz clic en Create.
  5. Copia el Client ID y el Client secret. Google solo muestra el secreto completo en el momento de la creación.

Las instrucciones completas están en la ayuda de Google Cloud sobre clientes OAuth.

2. Instalar la app en ¡Hola! Suite ​

  1. Accede a ¡Hola! Store y abre la app Google, en la categoría SSO.
  2. Haz clic en Instalar. Se abre la ventana Instalar Google.
  3. Completa los campos:
    • ID del cliente: el Client ID copiado de Google Cloud.
    • Clave privada del cliente: el Client secret.
  4. Haz clic en Instalar.

Resultado esperado ​

La app aparece como instalada y ¡Hola! Suite abre la pantalla de configuraciones, con la sección Datos de integración.

En la pantalla de inicio de sesión de ¡Hola! Suite pasa a aparecer, debajo de Iniciar sesión, el texto o inicie sesión con y el botón Google. Al hacer clic, el usuario es llevado al inicio de sesión de Google y, después de autenticado, vuelve a ¡Hola! Suite ya conectado.

El inicio de sesión con Google sigue las mismas reglas de seguridad del inicio de sesión común:

  • Si el usuario tiene configurada la autenticación de dos factores, el código se pide después del inicio de sesión en Google.
  • El límite de usuarios conectados al mismo tiempo sigue valiendo.
  • Si hay restricción de acceso por IP, también vale para el inicio de sesión con Google.

Configuraciones disponibles ​

Para modificar, accede a ¡Hola! Store → Google → Acceder y edita Datos de integración.

CampoQué hace
Client IDIdentificador del cliente OAuth creado en Google Cloud.
Client SecretClave secreta del cliente. Aparece enmascarada.

Para eliminar el inicio de sesión con Google, haz clic en Desinstalar App y confirma en Desinstalar.

Problemas comunes ​

Síntoma o mensajeQué verificar
"Tu usuario no fue encontrado. Ponte en contacto con un administrador del sistema."No existe un usuario activo en ¡Hola! Suite con el mismo correo electrónico de la cuenta de Google. Verifica el correo en Usuarios.
"Hubo un error al recopilar los datos de tu usuario. Inténtalo de nuevo más tarde."Google rechazó el intercambio de datos. Verifica el ID del cliente y la Clave privada del cliente.
Google muestra un error de URI de redireccionamientoLa URI registrada en Google Cloud debe ser exactamente igual a la de ¡Hola! Suite, incluido https y sin barra al final (documentación de Google).
"¡La cantidad de usuarios superó el límite contratado!"Se alcanzó el límite de usuarios conectados al mismo tiempo.
"Tu IP no está habilitada para iniciar sesión en la plataforma. Por favor, verifica e inténtalo de nuevo."La IP de acceso no está habilitada en las restricciones de acceso de ¡Hola! Suite.
La página de la app muestra "Ya hay una app de esta categoría instalada"Ya hay otra app de SSO instalada. Desinstálala antes de instalar Google.

Buenas prácticas ​

  • Antes de divulgar el inicio de sesión con Google, verifica que el correo electrónico de cada usuario en ¡Hola! Suite sea el mismo de la cuenta de Google.
  • Guarda el Client secret en un lugar seguro, porque Google no vuelve a mostrar el valor completo.
  • Mantén la autenticación de dos factores activa para los usuarios con acceso administrativo.

Contenidos relacionados ​