SSO de Azure
Azure Active Directory SSO
Configura Single Sign-On (SSO) con Microsoft Azure Active Directory para que los usuarios de tu organización inicien sesión en AsisteClick utilizando sus credenciales corporativas de Microsoft.
Última actualización: Diciembre 2025
Resumen
Aspecto | Detalle |
|---|---|
Tiempo estimado | 15-20 minutos |
Plan requerido | Company (chatbots) |
Permisos necesarios | Administrador de AsisteClick + Administrador de Azure AD |
Requisitos previos | Cuenta de Azure con permisos para registrar aplicaciones |
Qué es Azure AD SSO
Azure Active Directory Single Sign-On permite a los usuarios de tu organización acceder a AsisteClick utilizando las mismas credenciales que usan para Microsoft 365, Teams y otras aplicaciones corporativas.
Beneficios:
- Los usuarios no necesitan recordar contraseñas adicionales
- Control centralizado de accesos desde Azure AD
- Cumplimiento con políticas de seguridad corporativas
- Desactivación automática al dar de baja usuarios en Azure AD
Arquitectura del flujo SSO
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ Usuario │ │ Azure AD │ │ AsisteClick │
│ │ │ │ │ │
│ 1. Ingresa org │────>│ 2. Autentica │────>│ 3. Valida UPN │
│ en tenant │ │ con MS │ │ y crea │
│ │<────│ credentials │<────│ sesión │
└─────────────────┘ └──────────────────┘ └─────────────────┘Parte 1: Configuración en Azure Portal
Paso 1.1: Crear registro de aplicación
- Accede a Azure Portal
- Navega a Azure Active Directory > App registrations
- Click en New registration
- Completa el formulario:
Campo | Valor |
|---|---|
Name | AsisteClick SSO |
Supported account types | Accounts in this organizational directory only |
Redirect URI | Web: https://[tu-dominio]/ms-oauth2.php |
- Click en Register
Paso 1.2: Obtener credenciales
Una vez creada la aplicación, necesitas obtener tres valores:
Application (client) ID
En la página Overview de tu aplicación registrada, copia el valor de Application (client) ID.
Directory (tenant) ID
En la misma página Overview, copia el valor de Directory (tenant) ID.
Client Secret
- En el menú lateral, ve a Certificates & secrets
- Click en New client secret
- Ingresa una descripción (ej: "AsisteClick SSO")
- Selecciona un período de expiración
- Click en Add
- IMPORTANTE: Copia inmediatamente el Value del secreto. No podrás verlo nuevamente.
Paso 1.3: Configurar permisos de API
- En el menú lateral, ve a API permissions
- Click en Add a permission
- Selecciona Microsoft Graph
- Selecciona Delegated permissions
- Busca y selecciona:
- User.Read (ya debería estar agregado por defecto)
- Click en Add permissions
- Click en Grant admin consent for [tu organización]
Paso 1.4: Configurar token
- En el menú lateral, ve a Authentication
- En la sección Implicit grant and hybrid flows, marca:
- Access tokens (used for implicit flows)
- Click en Save
Parte 2: Configuración en AsisteClick
Paso 2.1: Configurar credenciales de Azure
Navegación: Avatar (esquina superior derecha) > Empresa
O alternativamente: Menú Configuración (ícono engranaje) > Empresa
- En la página de configuración de empresa, busca la sección Azure Active Directory
- Completa los campos con los valores obtenidos de Azure Portal:
Campo en AsisteClick | Valor de Azure |
|---|---|
Nombre de la organización | El nombre que usarán los usuarios para identificar tu organización (ej: "miempresa") |
ID de la organización (tenant id) | Directory (tenant) ID de Azure |
ID de la aplicación | Application (client) ID de Azure |
ID de secreto | Client Secret Value de Azure |
- Click en Grabar
Paso 2.2: Vincular usuarios con Azure AD
Para que un usuario pueda iniciar sesión con SSO, debes vincular su cuenta de AsisteClick con su identidad de Azure AD.
Navegación: Menú Configuración (ícono engranaje) > Usuarios > Click en el usuario a editar
- Busca la sección Azure Active Directory SSO
- En el campo Nombre principal del usuario, ingresa el User Principal Name (UPN) del usuario tal como aparece en Azure AD. El UPN generalmente tiene el formato: [email protected]
- Click en Grabar
Parte 3: Uso del SSO
Inicio de sesión con SSO
- El usuario accede a la página de login de AsisteClick
- Click en Ingresar con Azure SSO
- Ingresa el nombre de la organización configurado en el Paso 2.1
- Click en Confirmar
- Se redirige a Microsoft para autenticación
- Ingresa credenciales de Microsoft (si no hay sesión activa)
- Al autenticar exitosamente, se redirige al dashboard de AsisteClick
URL directa de SSO
Los usuarios pueden acceder directamente ingresando:
https://[tu-dominio]/tenant.phpSi ya tienen una cookie de organización guardada, el login será automático después de autenticar en Microsoft.
Restricciones por Plan
Funcionalidad | Plan Business | Plan Company | Plan IA Plus |
|---|---|---|---|
Configurar Azure AD en cuenta | No | Sí | Sí |
Vincular usuarios con SSO | No | Sí | Sí |
Login con Azure SSO | No | Sí | Sí |
Si tu plan no es Company, verás un mensaje indicando que debes actualizar tu plan para usar esta funcionalidad.
Comportamiento de usuarios SSO
Login forzado por SSO
Cuando un usuario tiene configurado el campo ms_sso_userprincipalname:
- No puede iniciar sesión con usuario/contraseña tradicional
- Debe usar exclusivamente el flujo de Azure SSO
- Al intentar login normal, verá el mensaje: "Este usuario debe conectarse mediante Azure SSO a través de su organización."
Sincronización de sesión
Al cerrar sesión en AsisteClick:
- Se cierra la sesión local
- Se redirige a Microsoft para cerrar sesión de Azure AD
- Esto previene que la sesión de Azure AD permanezca activa
Problemas comunes
"La organización ingresada no existe o no está configurada"
Causa | Solución |
|---|---|
Nombre de organización incorrecto | Verifica que el usuario escriba exactamente el nombre configurado en "Nombre de la organización" |
Azure AD no configurado | Verifica que los 4 campos de Azure estén completos en Configuración > Empresa |
Campos en blanco | Si los campos tienen espacios en blanco, elimínalos y guarda nuevamente |
"El usuario no tiene cuenta en AsisteClick o su cuenta no está vinculada con MS OAuth"
Causa | Solución |
|---|---|
Usuario no existe | Crea el usuario en AsisteClick primero |
UPN no coincide | Verifica que el UPN en AsisteClick coincida exactamente con el de Azure AD |
UPN con mayúsculas/minúsculas | El UPN es case-insensitive, pero verifica que no haya espacios adicionales |
"Este usuario debe conectarse mediante Azure SSO a través de su organización"
Este mensaje aparece cuando un usuario con SSO configurado intenta usar login tradicional.
Solución: El usuario debe usar el botón "Ingresar con Azure SSO" e ingresar el nombre de su organización.
El secreto expiró
Azure permite configurar expiración de secretos. Si el SSO deja de funcionar:
- Ve a Azure Portal > App registrations > tu app > Certificates & secrets
- Crea un nuevo Client secret
- Actualiza el valor en AsisteClick > Empresa > ID de secreto
- Guarda los cambios
Desactivar SSO
Para toda la organización
Navegación: Avatar > Empresa
- Borra los 4 campos de Azure Active Directory:
- Nombre de la organización
- ID de la organización
- ID de la aplicación
- ID de secreto
- Click en Grabar
Para un usuario específico
Navegación: Configuración > Usuarios > Editar usuario
- Borra el campo Nombre principal del usuario en la sección Azure Active Directory SSO
- Click en Grabar
- El usuario podrá usar login tradicional con su contraseña
Seguridad
Mejores prácticas
- Rotación de secretos: Configura recordatorios para renovar el Client Secret antes de que expire
- Auditoría: Revisa periódicamente los usuarios vinculados con SSO
- Offboarding: Al dar de baja un usuario en Azure AD, también elimina su acceso en AsisteClick
- Grupos de Azure: Considera usar grupos de seguridad en Azure AD para gestionar accesos
Datos almacenados
AsisteClick almacena:
- UPN del usuario (para identificación)
- ID de Azure AD del usuario (tras primer login)
- Token de acceso temporal (solo durante la sesión)
No se almacenan contraseñas de Microsoft.