Operaciones de firma desatendida

El proceso a realizar para realizar operaciones de firma desatendida, requiere la realización de los siguientes pasos:

• Autenticación del sistema Cliente.
• En el backend de Viafirma Fortress, es necesario subir el certificado que se empleará en la firma desatendida, asociado al sistema cliente o al grupo.
• Solicitud de firma.
• Ejecución de la firma.

A continuación se describen los siguientes apartados del proceso.

Autenticación del sistema Cliente

Para realizar operaciones de firma proporcionadas por Viafirma Fortress es necesario obtener un token asociado al cliente.

Para ello, Viafirma Fortress ofrece el siguiente método Rest, disponible en:

{viafirma_fortress_url}/oauth2/v1/token

Donde:

• viafirma_fortress_url: URL base de la implementación de Viafirma Fortress, por ejemplo https://sandbox.viafirma.com/fortress o https://fortress.viafirma.com/fortress

Esta URL recibe una serie de parámetros, que configuran y preparan la petición de Firma realizada por un cliente:

{viafirma_fortress_url}/oauth2/v1/token?
scope=client&
redirect_uri={url_de retorno_definido_en_viafirma_fortress}&
client_id={codigo_del_cliente_definido_en_viafirma_fortress}&
client_secret={clave_del_cliente_definido_en_viafirma_fortress}&
grant_type=client_credentials

Como resultado Viafirma Fortress, devolverá un objeto en formato application/json con la información del token de acceso asociado al cliente.

{
  "access_token": "1479cc2592a84cfb83c01402df613d01",
  "token_type": "Bearer",
  "expires_in": 3599
}

Alojar el certificado que se empleará en el proceso, en Viafirma Fortress

Viafirma Fortress, debe gestionar los certificados que se emplearán en el proceso de firma desatendida al nivel de Sistema cliente o al nivel de Grupo. Para gestionar los certificados al nivel de cliente o grupo, será necesario:

• Acceder al backend con un usuario administrador global o de grupo
• Acceder a la administración de sus sistemas clientes o grupos
• Acceder al detalle del sistema cliente o del grupo que alojará el certificado empleado en el proceso de firma desatendida
• En la sección configuración, pulsaremos sobre la pestaña Certificados para consultar los certificados disponibles
• Pulsaremos importar para subir un certificado en formato .P12.
• Si la plataforma está configurado para solicitar certificados a una entidad de registro embebida, podrá solicitar un nuevo certificado.

Nota:
Es importante el valor indicado en la columna "Código", dicho valor se empleará en la solicitud de firma desatentida.

Solicitud de firma

Con el token de sistema cliente obtenido de la anterior llamada, el cliente llamará al método /signature de Viafirma Fortress, proporcionándole la información a firmar digitalmente de forma desatendida.

En la siguiente sección encontrará la descripción en detalle del método signature, así como de los parámetros que recibe.

Una vez procesada la información Viafirma Fortress devolverá al sistema cliente un objeto en formato application/json, compuesto por un código de autorización y un código de ejecución

{
  "authCode": "124d6a9b5eaa470396a4db454780f6da",
  "exeCode": "96f1e73e5718438c8683846a2479d198"
}

Ejecución de la firma

Finalmente cuando el usuario seleccione un certificado, Viafirma Fortress devuelve al sistema cliente la siguiente información, para que ejecute la firma:

• el certificado seleccionado
• el estado de la ejecución
• y la fecha de ejecución