Manual de integración para consumo de APIs de Firma.gub.uy

Integración

La plataforma firma.gub.uy permite firmar documentos PDF usando dispositivos locales (cédula de identidad electrónica o e-tokens) y servicios en la nube (actualmente TuID de Antel e Identidad Mobile de Abitab). La integración es independiente del medio de firma elegido por el usuario.A efectos de ilustrar el procedimiento de integración de un sistema externo con la plataforma se mostrará las interacciones utilizando el aplicativo de firma y la firma en la nube.Por sistema externo se enƟende cualquier aplicación web, funcionando bajo cualquier plataforma, sistema operativo y arquitectura, y desarrollada en cualquier lenguaje de programación, que sea capaz de consumir servicios web de tipo rest y que pueda exponer un recurso web (una página, servlet u otro mecanismo) al cual la plataforma de firma electrónica pueda hacerle un GET a los efectos de notificarle(retornar) cuando el proceso de firma esté finalizado.

Estrictamente hablando, también pueden ser sistemas externos que se integren con “firma.gub.uy” cualquier otra aplicación, aunque no sea web, siempre que pueda consumir servicios web(rest). En este caso, como la aplicación no podrá exponer un recurso web donde la plataforma de firma electrónica pueda notificarle, será responsabilidad de la aplicación hacer un polling constan-te preguntando por el estado del proceso de firma, hasta obtener como respuesta el documento firmado. Esto no es aconsejable por la sobrecarga que produce sobre la red y sobre el servidor dela firma.gub.uy.

Descripción general

En la siguiente imagen se muestra la iteración completa entre los sistemas externos, plataforma firma.gub.uy, APIs para los sistemas externos, y aplicativo de firma o firma en la nube, estos 2 últimos según corresponda. describiendo de forma visual el flujo a seguir en cada etapa del proceso de firma, desde su inicio hasta su fin.

Figura 1. Flujo de firma.gub.uy con sistemas externos

Figura 1. Flujo de firma.gub.uy con sistemas externos

 

 

Etiquetas