Introducción

La integración de Microsoft Entra ID, anteriormente conocido como Azure Active Directory o Azure AD, permite habilitar el inicio de sesión con identidades corporativas en las aplicaciones de wolkvox.

Con esta integración, los usuarios de wolkvox Manager y wolkvox Agent pueden autenticarse mediante sus credenciales de Entra ID, facilitando un inicio de sesión centralizado, seguro y alineado con las políticas de identidad de la organización.

Esta configuración ayuda a mejorar la seguridad, simplificar el acceso de los usuarios y aprovechar las capacidades de autenticación y administración de identidades de Microsoft Entra ID.

Configuración

Configuración en portal de Entra ID

1. Ingresa al portal de Microsoft Azure
   • Accede al portal de Microsoft Azure con una cuenta que tenga permisos administrativos sobre el tenant de Microsoft Entra ID.
   • Desde la página de inicio, ingresa a Microsoft Entra ID.

1. Dentro de Microsoft Entra ID, ingresa a la sección “Aplicaciones empresariales”. Luego, en el menú lateral izquierdo, selecciona la opción “Todas las aplicaciones”.
2. Haz clic en “Nueva aplicación”.

1. En la galería de Microsoft Entra, selecciona la opción “Cree su propia aplicación”.
2. Se abrirá un panel lateral para crear la aplicación. Allí debes completar la información inicial.
   • En el campo ¿Cuál es el nombre de la aplicación?, escribe el nombre con el que deseas identificar la integración. Puedes usar un nombre que permita reconocer fácilmente que la aplicación corresponde a la integración entre Microsoft Entra ID y wolkvox. Por ejemplo: ‘Wolkvox SSO’ o un nombre definido por tu organización.
   • En la pregunta ¿Cuál es el objetivo de utilizar la aplicación?, selecciona la opción: Registrar una aplicación para integrarla con el id. de Microsoft Entra (aplicación que está desarrollando). Luego haz clic en “Crear”.

• Después de crear la aplicación, se abrirá la pantalla “Registrar una aplicación”.
• En esta sección debes validar o completar el nombre de la aplicación y configurar los tipos de cuenta compatibles.
• En la sección Tipos de cuenta compatibles, selecciona la opción: “Solo cuentas de este directorio organizativo”
• Esta opción configura la aplicación como inquilino único, lo que significa que solo los usuarios del directorio organizativo de la compañía podrán usar esta aplicación para autenticarse.
• Luego registra la URI de redirección que será usada para devolver la respuesta de autenticación después de que el usuario inicie sesión correctamente. En esta configuración debes asegurarte de contemplar las URI requeridas para la integración, incluyendo las asociadas a MSAL y NativeClient. También debes asegurarte de que el Id. de aplicación quede incluido en las URI de redirección que lo requieran.
• Una vez completada esta información, haz clic en “Registrar”.

Después de registrar la aplicación, vuelve a la sección: Aplicaciones empresariales > Todas las aplicaciones

Usa el campo de búsqueda para encontrar la aplicación que acabas de crear.

Cuando aparezca en los resultados, haz clic sobre el nombre de la aplicación para ingresar a su configuración.

Dentro de la aplicación, ingresa a la sección Información general.

En el bloque de propiedades encontrarás los siguientes datos:

• Id. de aplicación: Identificador único de la aplicación registrada en Microsoft Entra ID.
• Id. de objeto: Identificador único del objeto de la aplicación dentro del directorio.

Debes copiar y conservar estos valores, ya que serán necesarios para completar la configuración de la integración en wolkvox Manager.

En el menú lateral izquierdo de la aplicación, ingresa a la sección “Permisos de API”.

Luego haz clic en “Agregar un permiso”.

Selecciona Microsoft Graph como API a configurar.

1. En la ventana de solicitud de permisos, selecciona la opción “Permisos delegados”. Este tipo de permisos permite que la aplicación acceda a la API como el usuario que inició sesión. En la lista de permisos de Microsoft Graph, busca y selecciona los siguientes permisos:
2. User.Read: Permite iniciar sesión y leer el perfil del usuario.
3. User.ReadBasic.All: Permite leer los perfiles básicos de todos los usuarios.

Después de seleccionar los permisos, agrégalos a la aplicación.

Una vez agregados los permisos, vuelve a la sección Permisos de API.

Si la configuración de tu organización lo requiere, haz clic en “Conceder consentimiento de administrador” para autorizar los permisos configurados.

Al finalizar, los permisos deben quedar concedidos para la organización.

1. En el menú lateral izquierdo, ingresa a la sección “Autenticación”. En esta sección se configuran las plataformas que pueden recibir respuestas de autenticación después de que el usuario inicia sesión correctamente.
2. En Configuraciones de plataforma, agrega o valida la plataforma:
   • Aplicaciones móviles y de escritorio: Dentro de esta plataforma deben quedar configuradas las URI de redirección necesarias para la integración. Debes asegurarte de incluir las URI asociadas a:
     • MSAL.
     • NativeClient.
     • URI que incluyan el Id. de aplicación cuando aplique.
   • Esta configuración permite que el flujo de autenticación se complete correctamente cuando los usuarios inicien sesión mediante Microsoft Entra ID.

Importante: Establecer el tipo de cuenta compatible como inquilino único.

Cómo activar Microsoft Entra ID en wolkvox Manager

Después de configurar la aplicación en Microsoft Entra ID, debes activar la integración desde wolkvox Manager y relacionar cada usuario con su cuenta corporativa de Entra ID.

1. Desde wolkvox Manager, haz clic en el botón Configuración, ubicado en la parte superior derecha de la interfaz.
2. Luego, ingresa a la pestaña Integraciones.
3. Dentro de Integraciones, selecciona la pestaña “Entra ID”. 
4. En esta sección encontrarás los campos necesarios para activar la integración con Microsoft Entra ID.
   • Marca el checkbox “Activar integración Microsoft Entra ID”.
   • Tenant ID: Corresponde al identificador del tenant o directorio organizativo de Microsoft Entra ID.
   • Client ID: Corresponde al identificador de la aplicación registrada en Microsoft Entra ID.
   • En esta misma sección encontrarás el checkbox Activar logueo único. Cuando este checkbox está activo, los usuarios de wolkvox Agent y los usuarios de wolkvox Manager solo podrán acceder a estos aplicativos mediante Microsoft Entra ID. Es decir, Entra ID será el único método de inicio de sesión permitido para esos usuarios. Si este checkbox no está activo, los usuarios podrán continuar usando las credenciales propias de wolkvox, según la configuración y gestión interna de la operación. La administración, entrega y control de las credenciales de wolkvox será responsabilidad de cada operación.
5. Después de completar la información y seleccionar las opciones requeridas, haz clic en “Guardar” para aplicar los cambios.

Cómo vincular usuarios de tipo agente con Microsoft Entra ID

Para que un agente pueda iniciar sesión en wolkvox Agent mediante Microsoft Entra ID, es necesario asociar su usuario de wolkvox con el UserPrincipalName correspondiente en Entra ID. 

1. Desde el menú lateral izquierdo de wolkvox Manager, ingresa a la sección “Agentes & Skills”.
2. Luego, selecciona la pestaña “Agentes”.
3. Ubica el agente que deseas vincular con Microsoft Entra ID.
4. Haz clic derecho sobre el agente y selecciona la opción “Editar información del agente”.
5. En la ventana modal de edición, ingresa a la pestaña “Información básica”.
6. En el campo SSO (single sign user), escribe el “UserPrincipalName” del usuario en Microsoft Entra ID. Este valor debe corresponder al usuario corporativo con el que el agente iniciará sesión mediante Entra ID.
7. Haz clic en “Guardar” para aplicar la vinculación del agente.

Cómo vincular usuarios de wolkvox Manager con Microsoft Entra ID

Los usuarios administrativos de wolkvox Manager también deben relacionarse con su cuenta correspondiente en Microsoft Entra ID.

1. Desde wolkvox Manager, haz clic en el botón “Configuración”, ubicado en la parte superior derecha.
2. Dentro de la ventana de configuración, selecciona la pestaña “Usuarios y perfiles”.
3. Luego, ingresa a la pestaña “Usuarios”.
4. Ubica el usuario de wolkvox Manager que deseas vincular con Microsoft Entra ID.
5. Haz clic derecho sobre el usuario y selecciona la opción “Edit user”.
6. En la ventana de edición, ubica el campo “SSO”. En este campo debes escribir el UserPrincipalName del usuario en Microsoft Entra ID. Este valor debe corresponder al usuario corporativo con el que la persona iniciará sesión en wolkvox Manager.
7. Haz clic en “Edit User” para aplicar la configuración.

Cómo funciona el inicio de sesión con Microsoft Entra ID

Después de activar la integración, los aplicativos de wolkvox mostrarán la opción de iniciar sesión con Microsoft Entra ID.

Inicio de sesión en wolkvox Agent

Al abrir wolkvox Agent, el usuario podrá seleccionar la opción “Iniciar sesión Azure AD”.

Al hacer clic en esta opción, se abrirá una ventana de Microsoft para seleccionar una cuenta existente o ingresar una cuenta diferente.

El usuario debe autenticarse con la cuenta corporativa autorizada en Microsoft Entra ID.

Inicio de sesión en wolkvox Manager

En wolkvox Manager, el flujo de inicio de sesión funciona de forma equivalente. El usuario selecciona la opción de inicio de sesión con Azure AD o Microsoft Entra ID y completa la autenticación desde la ventana de Microsoft.

Si el inicio de sesión es exitoso, wolkvox valida que el UserPrincipalName autenticado esté relacionado con un usuario existente en wolkvox Manager o wolkvox Agent, según corresponda.

Cuando la validación es correcta, el sistema permite el acceso al aplicativo.

Validaciones y posibles errores de inicio de sesión

Durante el proceso de autenticación pueden presentarse errores asociados a credenciales, usuario, autorización o configuración.

Por ejemplo, Microsoft puede mostrar un mensaje indicando que el nombre de usuario puede ser incorrecto. En ese caso, se debe validar que el usuario haya sido escrito correctamente y que exista dentro del directorio de Microsoft Entra ID.

También puede ocurrir que el inicio de sesión en Microsoft sea correcto, pero el usuario no tenga relacionado su UserPrincipalName en wolkvox. En ese caso, wolkvox no podrá completar la validación del usuario y se debe revisar la configuración del campo SSO en el usuario correspondiente.

Si se presenta un error durante el proceso de autenticación, se mostrará la excepción correspondiente y se habilitará nuevamente el inicio de sesión con las credenciales de wolkvox, siempre que la configuración de logueo único de la operación lo permita.

Seguridad de la autenticación

La integración utiliza el método de autenticación OAuth 2.0, lo que permite implementar un flujo de inicio de sesión seguro, estandarizado y basado en identidades corporativas administradas desde Microsoft Entra ID.

Con esta configuración, wolkvox puede validar el acceso de los usuarios a partir de las credenciales corporativas autorizadas, manteniendo una experiencia de inicio de sesión centralizada y alineada con las políticas de seguridad de la organización.