Proceso de Firma Digital: FirmAR

FirmAR es una plataforma de Firma Digital Remota. Para mas info https://firmar.gob.ar/

Proceso de Firma Digital: FirmAR

Resumen

Desde el punto de vista de Arai-Documentos, FirmAR funciona como una aplicación que permite firmar digitalmente un documento. Desde un frontend se generará un Proceso de Firma que devolverá una URL desde la cual se redirije al frontend de firmar.gob.ar con el objetivo de firmar el Documento que corresponde a la Solicitudes de Autorización que posee un Usuario entre sus pendientes.

El Proceso de Firma finaliza cuando se firma un Documento en la plataforma FirmAR y luego se redirije a la bandeja de solicitudes (comunmente SIUDocumentos Bundle en Huarpe) desde la cual se disparo el Proceso de Firma Digital (Ver implementación)

Requisitos

Los requisitos son los mismos que en el Proceso de Autorización desde Aplicaciones. Adicionalmente se deben considerar las configuraciones necesarias para comunicar Arai-Documentos con la plataforma https://firmar.gob.ar/

Otro requisito importante es que los usuarios de FirmAR deben contener un CUIL con ssu correspondiente en Arai-Usuarios, ya que es el campo que se utiliza para identificar a un usuario en FirmAR

//TODO: Detalles de implentacion técnica

Limitaciones

Para disparar un proceso de firma se requiere implementar una bandeja donde el usuario pueda visualizar sus Solicitudes de Autorización pendientes, y mediante estas generar un Proceso de Firma.

La gestion de usuarios, certificados y accesos para https://firmar.gob.ar/ quedan incluidos en esta plataforma.

Se debe gestionar contra https://firmar.gob.ar/ los métodos y endpoints de autenticacion necesarios para que Arai-Documentos se comunique con la plataforma.

Implementación

A continuación veremos el caso de uso basico que aborda un Proceso de Firma mediante la plataforma FirmAR. Para detalles de configuraciones necesarias, ver documentacion de implementacion técnica

Caso
Se continúa el caso desde Implementación de Firma Digital, donde al crear el proceso firma, Arai-Documentos envía el Documento a firmar a la plataforma FirmAR, obteniendo una url_firmador donde se redijira el Usuario para realizar la firma del documento. Se redirije al Usuario, este se autentica e ingresa al firmar.gob.ar, y utiliza el firmador web de FirmAR para firmar digitalmente el documento. Una vez realizada la firma, la plataforma FirmAR realiza un POST del documento firmado a Arai-Documentos (endpoint previamente configurado) y redirecciona finalmente al usuario a la bandeja donde inicio el Proceso de Firma. En la configuración técnica, se veran mas en detalle las configuraciones necesarias para implementar FirmAR. //TODO: Agregar documentación técnica de configuracion de firmAR

GET /backend/autorizacion/solicitudes

Ver en Implementación de Firma Digital

POST /backend/autorizacion/proceso-firma

REQUEST

Campos obligatorios (Body Json)

Nombre	Tipo	DescripciÓn
tipo	string	'firmar'
solicitudes	array	Seguirá siendo un array pero solo admite una solicitud
url_retorno_de_firmar	string	Url a la que se debe redirigir la plataforma firmar luego de finalizar la firma de un documento.

{
  "tipo": "siu|firmar",
  "solicitudes": [
    "string"
  ],
  "url_retorno_de_firmar": "string"
}

RESPONSE

Recibe la siguiente respuesta en formato json

{
  "tipo": "firmar",
  "url_firmador": "string"
}

Nombre	Tipo	Descripcion
tipo	string	Devolvera unicamente el valor "firmar"
url_firmador	string	Url a la cual el frontend debe hacer un redirect o proveer un link al Usuario para que ingrese a firmar el documento

POST /frontend/autorizacion/firma

Como se puede ver este endpoint a diferencia del resto lo precede la palabra 'frontend'. En frontend estan todos los servicios que se utilizan sin autenticación.

Este endpoint en particular debe ser consumido por la plataforma FirmAR, donde la misma va a enviar los documentos que los usuarios firmen digitalmente.

Esta URL esta configurada cuando se dan de alta las credenciales para comunicarse a traves de la API (Ver Implementación de FirmAR)

REQUEST

Campos obligatorios (Body Json)

Nombre	Tipo	Descripcion
documento	string	Documento en base 64
metadata	array	Array con datos para identificar el documento que se envió a firmar dentro de Araí-Documentos
tipo	string	'firmar'
token	string	Es el identificador del documento. El mismo se envía cuando Araí-Documentos realiza un POST de un Documento en la plataforma FirmAR
status	Json	Información adicional

{
  "documento": "string",
  "metadata": [
    {
      "tipo": "firmar",
      "token": "string"
    }
  ],
  "status": {}
}

RESPONSE

Respuesta HTTP del servidor

HTTP 201 "Documento Creado"