Muestra las diferencias entre dos versiones de la página.
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]] | ||