Unattended signature operations

The process to perform unattended signature operations, requires the following steps:

• Client system authentication.
• In the Viafirma Fortress backend, it is necessary to upload the certificate that will be used in the unattended signature, associated with the client system or the group.
• Signature request
• Execution of the signature.

The following sections of the process are described below.

Client system authentication

To perform signature operations provided by Viafirma Fortress it is necessary to obtain a token associated with the client.

To do this, Viafirma Fortress offers the following Rest method, available at:

{viafirma_fortress_url}/oauth2/v1/token

Where:

• viafirma_fortress_url: Base URL of the Viafirma Fortress implementation, for example https://sandbox.viafirma.com/fortress or https://fortress.viafirma.com/fortress

This URL receives a series of parameters, which configure and prepare the signature request made by a client:

{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

As a certificateRequestEntity, Viafirma Fortress will return an object in application / json format with the information of the access token associated with the client.

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

Host the certificate that will be used in the process, in Viafirma Fortress

Viafirma Fortress, you must manage the certificates that will be used in the unattended signature process at the Client System level or at the Group level. To manage the certificates at the client or group level, it will be necessary:

• Access the backend with a global or group administrator user
• Access the administration of your client systems or groups
• Access the detail of the client system or the group that will host the certificate used in the unattended signing process
• In the configuration section, clic on the Certificates tab to check the available certificates
• Press import to upload a certificate in .p12 format.
• If the platform is configured to request certificates from an embedded registration entity, you can request a new certificate.

Note:
The value indicated in the "Code" column is important, this value will be used in the request for an unattended signature.

Signature Request

With the client system token obtained from the previous call, the client will call the Viafirma Fortress method / signature, providing the information to be digitally signed unattended.

In the next section you will find the detailed description of the signature method, as well as the parameters it receives.

Once the information is processed Viafirma Fortress will return to the client system an object in application / json format, composed of an authorization code and an execution code:

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

Execution of the signature

Finally, when the user selects a certificate, Viafirma Fortress returns the following information to the client system, to execute the signature:

• the selected certificate
• execution status
• and the date of execution