Herramientas de usuario

Herramientas del sitio


ada:howto:sicoferp:factory:new-migracion-sicoferp:apilegacy:microfrontend

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

Ambos lados, revisión anterior Revisión previa
Próxima revisión
Revisión previa
ada:howto:sicoferp:factory:new-migracion-sicoferp:apilegacy:microfrontend [2024/06/13 15:10]
192.168.177.2
ada:howto:sicoferp:factory:new-migracion-sicoferp:apilegacy:microfrontend [2024/06/13 15:39] (actual)
192.168.177.2
Línea 13: Línea 13:
  
 ===== Paso 2 ===== ===== Paso 2 =====
-El parámetro ​legacyToken es un string con el siguiente formato **contextClient@uuid** el cual al ser separados ​por el simbolo @ se obtendran 2 fragmentos.+El front recibe el parámetro ​tipo string ​**legacyToken** ​con el siguiente formato **contextClient@uuid** el cual al ser separado ​por el simbolo @ se obtendran 2 fragmentos.
  
    * **contextClient**:​ Código del cliente.    * **contextClient**:​ Código del cliente.
Línea 26: Línea 26:
  
 ===== Paso 3 ===== ===== Paso 3 =====
-Se debe tomar el **contextClient** y desencriptarlo para identificar el cliente. ​+Se debe tomar el **contextClient** y desencriptarlo para identificar el cliente ​por medio del método **decrypt-legacy-secure-token** del api-legacy enviando en el parametro **secureToken** el contextClient recibido en el request de consumo de la aplicación legacy que hace la petición.
 Ejemplo: Ejemplo:
  
 {{ :​ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy:​apilegacy-decrypt.png?​600 |}} {{ :​ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy:​apilegacy-decrypt.png?​600 |}}
 +
 +Como se puede observar en la imagen de ejemplo el contextClient devuelve viva-dev.
  
 ===== Paso 4 ===== ===== Paso 4 =====
-Se debe consumir el método del api **autenticate-microfrontend-launcher** el cual puede ser consultado en la documentación de la [[ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy#​Capa de lógica de negocio|Capa de lógica de negocio]] y pasar el contextClient como token en el header y el uuid como parametro.+Al desencriptar el conteextclient se debe consumir el método del api **autenticate-microfrontend-launcher** el cual puede ser consultado en la documentación de la [[ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy#​Capa de lógica de negocio|Capa de lógica de negocio]] y pasar el contextClient como token en el header y el uuid como parametro.
  
 Si el uuid está vigente se devolverán los parametros de sesión encriptados con el código 200. Lo que permitirá el acceso a la funcionalidad. Si el uuid está vigente se devolverán los parametros de sesión encriptados con el código 200. Lo que permitirá el acceso a la funcionalidad.
Línea 43: Línea 45:
  
 ===== Paso 5 ===== ===== Paso 5 =====
-Al realizar la autenticación de forma correcta se obtendra un hash que contendrá los parametros de sesión pero estarán encriptados por lo tanto se debe consumir el servicio **decrypt-legacy-secure-token** el cual recibirá ​2 argumentos uno en el header llamado token el cual recibirá el contextClient y un parámetro secureToken ​donde se le enviará ​el hash obtenido del proceso de autenticación como se ve en la imagen.+Al realizar la autenticación de forma correcta se obtendra un hash que contendrá los parametros de sesión pero estarán encriptados por lo tanto se debe consumir el servicio **decrypt-legacy-secure-token** el cual recibirá ​ en el parámetro secureToken el hash obtenido del proceso de autenticación como se ve en la imagen.
  
-{{ :​ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​api-legacy3.png?600 |}}+{{ :​ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy:​apilegacy-decrypt02.png?600 |}}
  
 El servicio devuelve un objeto json con la siguiente estructura. El servicio devuelve un objeto json con la siguiente estructura.
Línea 51: Línea 53:
 <code yaml> <code yaml>
 { {
-  ​"​idOption":​ "1", +    ​"​idOption":​ "00-00", 
-  "​tituloVentana":​ "​Maestro Terceros",​ +    "​tituloVentana":​ "​Maestro Terceros",​ 
-  "​nitEmpresa":​ "800167494", +    "​nitEmpresa":​ "811032187.8", 
-  "​nombreEmpresa":​ "Uniempresa de prueba", +    "​nombreEmpresa":​ "CAPACITACION", 
-  "​codigoMempresa":​ "​9999999999",​ +    "​codigoMempresa":​ "​9999999999",​ 
-  "​codigoUsuario":​ "1", +    "​codigoUsuario":​ "3", 
-  "​nombreUsuario":​ "Pepito Perez", ​  +    "​nombreUsuario":​ "ADMIN", 
-  "​codigoDependencia":​ "66", +    "​codigoDependencia":​ "9", 
-  "​nombreDependencia":​ "Presupuesto", ​  +    "​nombreDependencia":​ "AVIMA", 
-  "​fechaSistemaModulo":​ "06/06/24", +    "​fechaSistemaModulo":​ "1/12/2022", 
-  "​login":​ "123456789"+    "​login":​ "SICOF"
 } }
 </​code>​ </​code>​
 +
 +===== Paso 6 =====
 +Se debe tomar de los parámetros desencriptado el idOption y consumir el servicio **ecosystem-config-ws/​frontend-route/​api/​v1/​get** para obtener el path del microfrontend como se ve a continuación;​
 +
 +{{ :​ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy:​frontendroute.png?​600 |}}
 +
 +De esta manera se asegura la inicialización dinámica de las rutas del frontend.
  
 ===== Consideraciones ===== ===== Consideraciones =====
  
-  * El uuid es de un solo uso, de esta manera aseguramos la integridad ​de las integraciones y consumos de los nuevos componentes. +  * El uuid es de un solo uso, de esta manera aseguramos la integridad ​en los consumos de los nuevos componentes. 
-  * Los parámetros ​desencriptado ​son la base para la inicialización del microfrontend.+  * Los parámetros ​desencriptados ​son la base para la inicialización del microfrontend.
   * Salvo los parámetros opcionales los demás son requeridos por lo tanto se aconseja aplicar validaciones de esas propiedades al desencriptarlas.   * Salvo los parámetros opcionales los demás son requeridos por lo tanto se aconseja aplicar validaciones de esas propiedades al desencriptarlas.
   * Todo consumo microfrontend es almacenado para efectos de auditoria.   * Todo consumo microfrontend es almacenado para efectos de auditoria.
 +  * Se debe parametrizar el idOption por opción o grupo en cada cliente.
  
  
 [[ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy|←Regresar]] [[ada:​howto:​sicoferp:​factory:​new-migracion-sicoferp:​apilegacy|←Regresar]]
  
ada/howto/sicoferp/factory/new-migracion-sicoferp/apilegacy/microfrontend.1718291415.txt.gz · Última modificación: 2024/06/13 15:10 por 192.168.177.2