--- title: SSO de Azure slug: sso-de-azure description: In order to provide an SEO description, I would need to have some information about the document to summarize. Without any document or details, it is not possible to create an accurate SEO description. docTags: createdAt: 2023-08-23T03:02:38.796Z --- # 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 ```text ┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐ │ 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 1. Accede a [Azure Portal](https://portal.azure.com) 2. Navega a **Azure Active Directory** > **App registrations** 3. Click en **New registration** 4. 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` | :::BlockQuote **Nota:** El dominio debe coincidir exactamente con la URL de tu instalación de AsisteClick. Por ejemplo: `https://app.asisteclick.com/ms-oauth2.php` ::: 5. 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 1. En el menú lateral, ve a **Certificates & secrets** 2. Click en **New client secret** 3. Ingresa una descripción (ej: "AsisteClick SSO") 4. Selecciona un período de expiración 5. Click en **Add** 6. **IMPORTANTE:** Copia inmediatamente el **Value** del secreto. No podrás verlo nuevamente. ### Paso 1.3: Configurar permisos de API 1. En el menú lateral, ve a **API permissions** 2. Click en **Add a permission** 3. Selecciona **Microsoft Graph** 4. Selecciona **Delegated permissions** 5. Busca y selecciona: - `User.Read` (ya debería estar agregado por defecto) 6. Click en **Add permissions** 7. Click en **Grant admin consent for \[tu organización]** ### Paso 1.4: Configurar token 1. En el menú lateral, ve a **Authentication** 2. En la sección **Implicit grant and hybrid flows**, marca: - **Access tokens** (used for implicit flows) 3. 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** 1. En la página de configuración de empresa, busca la sección **Azure Active Directory** 2. 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 | 3. Click en **Grabar** :::BlockQuote **Importante:** El "Nombre de la organización" es el identificador que los usuarios ingresarán al acceder. Usa un nombre corto y fácil de recordar. ::: ### 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 1. Busca la sección **Azure Active Directory SSO** 2. 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: `usuario@tudominio.com` 3. Click en **Grabar** :::BlockQuote **Nota:** El campo **ID de usuario en Active Directory** se completará automáticamente después del primer inicio de sesión exitoso del usuario. ::: *** ## Parte 3: Uso del SSO ### Inicio de sesión con SSO 1. El usuario accede a la página de login de AsisteClick 2. Click en **Ingresar con Azure SSO** 3. Ingresa el nombre de la organización configurado en el Paso 2.1 4. Click en **Confirmar** 5. Se redirige a Microsoft para autenticación 6. Ingresa credenciales de Microsoft (si no hay sesión activa) 7. Al autenticar exitosamente, se redirige al dashboard de AsisteClick ### URL directa de SSO Los usuarios pueden acceder directamente ingresando: ```text https://[tu-dominio]/tenant.php ``` Si 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: 1. Ve a Azure Portal > App registrations > tu app > Certificates & secrets 2. Crea un nuevo Client secret 3. Actualiza el valor en AsisteClick > Empresa > ID de secreto 4. Guarda los cambios *** ## Desactivar SSO ### Para toda la organización **Navegación:** Avatar > **Empresa** 1. 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 2. Click en **Grabar** ### Para un usuario específico **Navegación:** Configuración > **Usuarios** > Editar usuario 1. Borra el campo **Nombre principal del usuario** en la sección Azure Active Directory SSO 2. Click en **Grabar** 3. El usuario podrá usar login tradicional con su contraseña *** ## Seguridad ### Mejores prácticas 1. **Rotación de secretos:** Configura recordatorios para renovar el Client Secret antes de que expire 2. **Auditoría:** Revisa periódicamente los usuarios vinculados con SSO 3. **Offboarding:** Al dar de baja un usuario en Azure AD, también elimina su acceso en AsisteClick 4. **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.