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:
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
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 ""