Introducción

La autenticación mediante SSO (Single Sign-On) con tecnología SAML permite que los usuarios de tu organización ingresen una sola vez con sus credenciales corporativas y accedan a múltiples aplicaciones, entre ellas wolkvox Manager y wolkvox Agent, sin volver a ingresar usuario/contraseña.

Esta integración mejora la seguridad, la usabilidad y centraliza el control de accesos (por ejemplo: políticas de expiración, MFA, bloqueo de cuenta), aprovechando proveedores de identidad como Microsoft Azure Active Directory / Microsoft Entra ID (Anteriormente conocido como Azure) .

Configuración

Crear la aplicación SAML en Microsoft Entra ID (Azure)

1. Entra al portal de Microsoft Azure. Abre el menú principal (hamburguesa).
2. Selecciona “Microsoft Entra ID” (Antes llamado Azure AD).

1. Dentro de Microsoft Entra ID, en el menú izquierdo expande “Administrar”.
2. Haz clic en “Aplicaciones empresariales”.

1. Haz clic en “+ Nueva aplicación”.
   • Recomendación: Dale un nombre representativo (por ejemplo: wolkvox-SSO).
   • Elige la opción SAML como método de autenticación.

Configura inicialmente la aplicación.

Entra en la aplicación.

Vinculación de URLs (IdP y SP)

Ahora necesitamos los datos de destino para decirle a “Entra ID” (Azure) hacia dónde enviar la información de logueo.

1. Ingresa a la configuración de wolkvox Manager.
2. Dirígete a la pestaña Integraciones.
3. Ve a la pestaña SSO.
4. Activa el checkbox "Activar SSO (SAML)".
5. Identifica el campo "id. de entidad".
6. Identifica el campo "Dirección URL de respuesta". 
   • Estos campos son de solo lectura y contienen la información que pegarás en “Entra ID” (Azure) en el siguiente paso.

De wolkvox hacia Azure: 

1. Vuelve a tu aplicación en “Entra ID” (Azure).
2. Ve a “Administrar”.
3. Inicio de sesión único.
4. Sección “Configuración básica de SAML”.
5. Copia el "id. de entidad" de wolkvox y pégalo en el campo "Identificador (Id. de entidad)" de “Entra ID” (Azure).
6. Copia la "Dirección URL de respuesta" de wolkvox y pégala en el campo "Dirección URL de respuesta (URL del Servicio de consumidor de aserciones)" de Entra ID (Azure).

De “Entra ID” (Azure) hacia wolkvox: 

1. Vuelve a tu aplicación en “Entra ID” (Azure).
2. Ve a “Administrar”.
3. Inicio de sesión único.
4. En Azure, ve a la sección inferior “Configurar {nombre de tu aplicación}”. Usa el ícono de "copiar" para llevar los datos exactos a wolkvox:
   • Copia la "Dirección URL de inicio de sesión" de “Entra ID” (Azure) y pégala en el campo "URL de Inicio de sesión" en wolkvox Manager.
   • Copia la "URL de cierre de sesión" de “Entra ID” (Azure) y pégala en el campo "URL de cierre de sesión" en wolkvox Manager.

1. Ingresa a la configuración de wolkvox Manager.
2. Dirígete a la pestaña Integraciones.
3. Ve a la pestaña SSO.
4. Copia la "Dirección URL de inicio de sesión" de “Entra ID” (Azure) y pégala en el campo "URL de Inicio de sesión" en wolkvox Manager.
5. Copia la "URL de cierre de sesión" de “Entra ID” (Azure) y pégala en el campo "URL de cierre de sesión" en wolkvox Manager.

Instalación del Certificado de Seguridad

1. Vuelve a tu aplicación en “Entra ID” (Azure).
2. Ve a “Administrar”.
3. Inicio de sesión único.
4. Para validar la autenticidad de las peticiones, se requiere un certificado digital.
   • En Azure, ve a la sección "Certificados SAML".
   • Ubica el "Certificado (Base64)" y haz clic en "Descargar".

1. Ingresa a la configuración de wolkvox Manager.
2. Dirígete a la pestaña Integraciones.
3. Ve a la pestaña SSO.
4. Abre el archivo descargado con un editor de texto (como el Bloc de notas).
   1. Copia todo el código que aparece dentro del archivo.
   2. En wolkvox Manager, ubica el campo “Certificado - x509” y pega el contenido del certificado.
   3. Si deseas ver el contenido del certificado después de agregarlo y guardar la configuración, haz clic en el botón "Mostrar" (ya que es un campo protegido).

Personalización y activación final

Para finalizar, ajusta cómo verán y usarán los usuarios esta funcionalidad en wolkvox:

1. Ingresa a la configuración de wolkvox Manager.
2. Dirígete a la pestaña Integraciones.
3. Ve a la pestaña SSO.
4. Configura los campos: 
   • Texto botón de logueo: Escribe el mensaje que verán los usuarios en el botón (ej: "Iniciar sesión SSO").
   • Inicio de sesión Integrado:
     • Activado: wolkvox usará su propio navegador interno para el proceso de logueo.
     • Desactivado: Se abrirá el navegador predeterminado del sistema operativo del usuario.
   • Activar logueo único SAML: Si activas esta casilla, los usuarios solo podrán ingresar mediante el botón de SSO. Los campos tradicionales de usuario y contraseña desaparecerán, forzando el uso de la cuenta corporativa.

No olvides guardar los cambios realizados en esta ventana de configuración.

Una vez guardados los cambios, tus usuarios de wolkvox Manager y wolkvox Agent verán el nuevo botón de inicio de sesión habilitado al abrir wolkvox Agent y/o wolkvox Manager.