Operaciones de extensión de firma

El proceso de operaciones de extensión de firma para un usuario, requiere la realización de los siguientes pasos:

  • Autenticación del sistema Cliente.
  • Realizar la solicitud de extensión de 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:

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
Parámetro Valor Descripción
scope client Para servicios asociado a firma de documentos.
redirect_uri URL Debe coincidir con una de las URL de retorno definidas en Viafirma Fortress
client_id Identificador del cliente Se define en Viafirma Fortress e identifica a la aplicación cliente que está realizado la petición
client_secret Clave del cliente Permite validar a la aplicación cliente que está realizado la petición
grant_type client_credentials Indica que el cliente solicita acceso a recursos protegidos bajo su control

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
}

Solicitud de extensión firma

Con el token de sistema cliente obtenido de la anterior llamada, el cliente llamará al método /extend de Viafirma Fortress, proporcionándole la información necesaria para extender la firma de un documento previamente firmado digitalmente por parte del usuario.

En la siguiente sección encontrará la descripción en detalle del método extend, 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 una referencia y los bytes en base 64, del documento firmado

{
    "ref": "d8e3d98dc20e46188fd067df28048934",
    "bytesB64": "MIMBKM8GCSqGSIb3DQEHAqCDASi/MIMBKLoCAQUxDzANBglghkgBZQMEAgEFADCC1QsGCSqGSIb3DQEHAaCC1PwEgtT4JVBERi0xLjMKJcTl8uXrp..."
}

results matching ""

    No results matching ""