Skip to content

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

Acceso

Ruta: ¡Hola! Store → Microsoft → Instalar

Visión general ​

La app Microsoft permite que los usuarios inicien sesión en ¡Hola! Suite con la cuenta de Microsoft, sin escribir la contraseña de ¡Hola! Suite. Este tipo de acceso se llama inicio de sesión único, o SSO (Single Sign-On). Funciona con Microsoft Entra ID (antes Azure AD) y, si quieres, con cuentas personales de Microsoft.

¡Hola! Suite identifica al usuario por la dirección de correo electrónico de la cuenta de Microsoft: 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 al Centro de administración de Microsoft Entra con permiso para registrar aplicaciones.
  • Usuarios registrados y activos en ¡Hola! Suite, con el mismo correo electrónico de las cuentas de Microsoft. El inicio de sesión con Microsoft no crea usuarios.
  • Ninguna otra app de SSO instalada. ¡Hola! Suite acepta una app de SSO a la vez.

Paso a paso ​

1. Registrar la aplicación en Microsoft Entra ​

  1. En el Centro de administración de Microsoft Entra, accede a Entra ID → App registrations y haz clic en New registration.
  2. Dale un Name a la aplicación (ej.: "Opa! Suite").
  3. En Supported account types, elige quién podrá usar la aplicación. La elección debe ser compatible con la Preferencia de acceso que vas a definir en ¡Hola! Suite (consulta la tabla en el paso 2).
  4. Haz clic en Register. En la página Overview, copia el Application (client) ID. Si vas a usar la opción Personalizado en ¡Hola! Suite, copia también el Directory (tenant) ID.
  5. En Authentication, haz clic en Add Redirect URI, elige la plataforma Web e informa la dirección de abajo, reemplazando por la dirección de tu ¡Hola! Suite: https://endereco-do-seu-opa-suite/auth/login/sso/callback/microsoft
  6. En Certificates & secrets → Client secrets, haz clic en New client secret, elige la validez y haz clic en Add.
  7. Copia el Value del secreto. Microsoft no vuelve a mostrar ese valor después de que sales de la página.

Las instrucciones completas están en Registrar una aplicación en Microsoft Entra ID y Agregar credenciales a la aplicación.

El secreto del cliente vence

Microsoft limita la validez del secreto a un máximo de 24 meses. Cuando vence, el inicio de sesión con Microsoft deja de funcionar. Anota la fecha y registra un nuevo secreto en ¡Hola! Suite antes del vencimiento.

2. Instalar la app en ¡Hola! Suite ​

  1. Accede a ¡Hola! Store y abre la app Microsoft, en la categoría SSO.
  2. Haz clic en Instalar. Se abre la ventana de instalación.
  3. Completa los campos:
    • ID del cliente: el Application (client) ID.
    • Clave privada del cliente: el Value del secreto.
    • Preferencia de acceso: qué cuentas de Microsoft pueden iniciar sesión, según la tabla de abajo.
    • Dominio o Tenant ID: aparece solo en la opción Personalizado. Informa el dominio de la empresa en Microsoft Entra o el Directory (tenant) ID.
  4. Haz clic en Instalar.
Preferencia de accesoQuién puede iniciar sesión
Todos los correos de MicrosoftCuentas corporativas (Microsoft Entra ID) y cuentas personales de Microsoft.
Solo correos corporativosSolo cuentas corporativas de Microsoft Entra ID.
Solo correos personalesSolo cuentas personales de Microsoft.
PersonalizadoSolo cuentas del directorio (tenant) informado en Dominio o Tenant ID.

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 Microsoft. Al hacer clic, el usuario es llevado al inicio de sesión de Microsoft y, después de autenticado, vuelve a ¡Hola! Suite ya conectado.

El inicio de sesión con Microsoft 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 Microsoft.
  • 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 Microsoft.

Configuraciones disponibles ​

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

CampoQué hace
Client IDIdentificador de la aplicación registrada en Microsoft Entra.
Client SecretSecreto de la aplicación. Aparece enmascarado.
Preferencia de accesoQué cuentas de Microsoft pueden iniciar sesión.
Dominio o Tenant IDDirectorio permitido, en la opción Personalizado.

Para eliminar el inicio de sesión con Microsoft, 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 Microsoft. Verifica el correo en Usuarios y el correo de la cuenta en Microsoft Entra.
"Hubo un error al recopilar los datos de tu usuario. Inténtalo de nuevo más tarde."Microsoft rechazó el intercambio de datos. Verifica el ID del cliente y si el secreto sigue vigente.
Microsoft muestra un error de URI de redireccionamientoLa URI registrada en Microsoft Entra debe ser exactamente igual a la de ¡Hola! Suite.
Microsoft no acepta la cuentaLa cuenta no encaja en la Preferencia de acceso ni en el Supported account types de la aplicación.
"¡La cantidad de usuarios superó el límite contratado!"Se alcanzó el límite de usuarios conectados al mismo tiempo.
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 Microsoft.

Buenas prácticas ​

  • Prefiere Solo correos corporativos o Personalizado cuando la empresa usa Microsoft Entra ID, para evitar el acceso con cuentas personales.
  • Antes de divulgar el inicio de sesión con Microsoft, verifica que el correo electrónico de cada usuario en ¡Hola! Suite sea el mismo de la cuenta de Microsoft.
  • Programa el cambio del secreto del cliente antes de la fecha de vencimiento.

Contenidos relacionados ​