Evolution Wave Analítica Versión 1.0.2

Recomendaciones generales

• Realizar un respaldo completo de la aplicación actual antes de aplicar cualquier actualización.
• Validar la actualización en un ambiente de pruebas antes de aplicarla en producción.
• Durante la instalación:
  • Ejecutar los scripts de base de datos en el orden indicado en la documentación.
  • No modificar manualmente los archivos de configuración generados, a menos que se indique explícitamente.
• Consultar la documentación técnica en https://docs.aseinfo.net para instrucciones detalladas de configuración y resolución de problemas.

Para más información sobre el uso de esta versión de Wave Analítica se puede revisar el Manual de Usuario.

Nuevos requisitos de software

• Evolution 1.24.2.0 o superior.
• Evolution Connect 2.8.0 o superior.
• Identity Server 2.5.1.0 o superior.

Advertencias y cambios que rompen compatibilidad

Advertencia
Esta versión cambia el flujo de autenticación de implicit a authorization_code con PKCE y requiere actualizar el cliente EvoAnalitica en Identity Server. Identity Server no permite ambos flujos en el mismo cliente, por lo que la actualización del cliente y el despliegue de Evolution Wave Analítica 1.0.2 deben realizarse en la misma ventana de mantenimiento; entre ambos pasos no estará disponible el inicio de sesión. Las versiones anteriores de la aplicación dejan de funcionar contra el cliente actualizado.

• Las sesiones activas se cerrarán al aplicar el cambio y los usuarios deberán iniciar sesión nuevamente.
• Fuera de localhost, la aplicación debe publicarse por HTTPS: PKCE requiere funciones criptográficas del navegador que solo están disponibles en contextos seguros.

Nuevas funcionalidades

Ninguna.

Mejoras en funcionalidades existentes

Autenticación con authorization_code y PKCE

Se reemplazó el flujo implícito (implicit) por authorization_code con PKCE mediante la librería oidc-client-ts. Los tokens ya no viajan en la URL, no se requiere client secret en el navegador y el token se renueva con refresh token (scope offline_access), sin la página silent-refresh.html.

Recuperación de sesión

Se corrigió la expiración de la sesión a mitad de uso: la aplicación adopta el token renovado y, si el token vence (por ejemplo, con la pestaña en segundo plano), intenta renovarlo al volver a la pestaña. Si no es posible, lleva al usuario al inicio de sesión de forma ordenada.

Instrucciones de Instalación

Base de datos

Todos los archivos necesarios para la instalación o actualización de la base de datos se encuentran disponibles en la carpeta Evolution Connect/Databases ubicada en su propio paquete.

Para conocer el procedimiento específico a seguir según el caso (instalación nueva o actualización), consulte el archivo README incluido en la carpeta Evolution Connect ubicada en su propio paquete.

Identity Server

Ejecutar en la base de datos de Identity Server el script Databases\SQL Server\DataUpdate - 1_0_2 - Cliente EvolutionAnalitica - REINSTALAR PKCE.sql, incluido en el paquete de esta versión y revisado por el equipo de Identity Server. El script elimina el cliente EvoAnalitica y lo vuelve a crear con authorization_code + PKCE.

Antes de ejecutarlo, revisar el script y ajustar las variables:

• @origin: esquema, host y puerto, sin ruta ni slash final. Fuera de localhost debe usar HTTPS.
• @appPath: ruta donde está publicada la aplicación (por ejemplo /WaveAnalitica).

Ambas deben coincidir con la URL configurada en urls.app del archivo config.json.

La ejecución del script debe coordinarse con el despliegue de la aplicación (ver Advertencias y cambios que rompen compatibilidad). El script no incluye versión para Oracle: aplica a la base de datos de Identity Server (SQL Server).

Evolution Wave Analítica

0. Se recomienda hacer una copia de seguridad del sitio que por lo general suele estar en C:\inetpub\wwwroot\EvolutionComponentes\wwwWaveAnalitica\.
1. Dirigirse a la carpeta EvolutionComponentes\wwwWaveAnalitica, y en ella encontrará dos carpetas:
   • Browser
   • Server
2. Dentro de la carpeta Browser, dirigirse a la carpeta assets y dentro se encuentra el archivo config.json.
3. Dentro del archivo, configurar las URLs de las distintas aplicaciones correspondientes.
   • En caso de querer hacer uso de logs, dirigirse al nodo logger y poner el parámetro isActiveLogs con valor true.
4. Regresar a la carpeta Browser, y abrir el archivo web.config. Revisar que las configuraciones vayan acorde a las características del servidor.
5. Para más información respecto a la instalación de EvoWave se puede revisar el Proceso de Instalación.

Pasos finales

1. Ingresar al URL de Evolution Wave Analítica, iniciar sesión y validar que funcione adecuadamente.
2. Validar que, al iniciar sesión, el navegador regrese a la aplicación con el parámetro code en la URL (flujo authorization_code) y se acceda sin errores.
3. Validar que la sesión se mantenga activa mientras se usa la aplicación: el token se renueva automáticamente y no se solicita iniciar sesión de nuevo.