Saltar al contenido principal

Configurando FirmAR

Configurando Firmar en Araí-Documentos​

Contexto​

Para implementar un mecanismo de firma digital, Arai-Documentos provee integración con la plataforma de firma digital remota FirmAR

Mediante esta implementación los usuarios, registrados en el módulo de usuarios, podrán firmar documentos digitalmente mediante la plataforma de firma remota

Configuración en FirmAR​

En este punto se detallan configuraciones que deben realizarse sobre la plataforma FirmAR. Ver Documento de Integración Firmar

Provee un API User y Secret para autenticarse​

En FirmAR se configura un API User y Secret para cada instancia que se conecta mediante API al mismo. En el SIU se consideró que cada instancia de Araí-Documentos esta relacionado a un API User y Secret en FirmAR.

Ver Utilización de Api User y Secret en servicio que obtiene Access Token

Configuración para enviar Documentos a Endpoint de Araí-Documentos​

Debe pasarse en la configuración una url pública de callback, asociada al API User y Secret sobre la cual se posteará el documento firmado

La url será algo como: url-host-arai-documentos/frontend/autorizacion/firma

Ver Servicio Araí-Documentos para recibir documentos firmados

La URL pasada corresponde a un servicio que debe quedar público en Arai-Documentos donde se reciben los documentos firmados

Campo CUIL en Arai-Usuarios​

Se requiere que se implemente un módulo de usuarios

El mismo debe proveer el campo CUIL de usuario, que es campo mediante el cual se integrará con la plataforma FirmAR.

Configuración en Araí-Documentos​

Para configurar esta implementación se debe especificar la clase y atributos necesarios para la conexión antes de la instalación. En variables de entorno corresponde a las variables SERVICIO_FIRMADOR_CLASS y SERVICIO_FIRMADOR_PARAMS.

Los valores quedarán reflejados en servicio_firmador en el archivo de configuración parameters.yml luego de instalar.

Ejemplo:

Con variables configuradas

SERVICIO_FIRMADOR_CLASS=\SIU\DocsApi\Firmador\FirmARService
SERVICIO_FIRMADOR_PARAMS={base_uri:'https://tst.firmar.gob.ar/', method:'basic', user:'api-user', password:'api-secret'}

Esto genera la entrada en el archivo parameters.yml

servicio_firmador:
        class: \SIU\DocsApi\Firmador\FirmARService
        params:
        base_uri: 'https://tst.firmar.gob.ar/'
        method: basic
        user: <api-user>
        password: <api-password>

Nota: Se recomienda utilizar la configuración por variables en lugar de modificar directamente el archivo dentro del contenedor.