T1C-API
Search…
Bulk Signing Capability
Digital signatures applied on one or more transactions/documents

Introduction

The Trust1Connector provides different ways of applying a digital signature on a hash. The hash can come from a dematerialised document, a transaction or any other content hash. Upon applying the signature, a PIN is requested from the user (something the user 'knows', besides something the user 'has/owns'). Applying the PIN can be done in several ways:
    using a pin-pad reader (user interaction in the context of the reader)
    entering the pin in an OS owned pin dialog (user interaction in the context of the operating system)
    entering the pin in the web application (user interaction in the context of the web application)
The above mentioned use cases, have a different level of security implication, ordered from ‘most’ secure to 'less’ secure. In order to avoid PIN visibility in the browser, additional functionalities (not in this scope) provide a mean for PIN encryption (which only make sense entering the PIN in the web application).
Bulk signing comes in the picture, when a user is acting in a use case with multiple hashes (documents, transactions, …). This requires the user to enter his pin ('the user interaction for applying a digital signature') multiple times.
This can annoy users, therefor the T1C provides a mean to persist temporary the PIN in a stateful way on the stateless API interface. This is done by sharing the PIN, in a safe way, between one or more use cases. As the use case is defined by the consuming application, the consuming application is responsible to SET or RESET the pin throughout the different use cases.
Bulk signing applies only on the digital signature request. The verify-pin or authenticate does not support bulk application of a user PIN.

How-To

Start a Bulk Signature Request

To trigger a bulk-sign operation, add the query-parameter 'bulk' with a value of 'true' to the request:
1
curl --location --request POST 'https://t1c.t1t.io:51883/v3/modules/beid/apps/token/readers/9b28267029efca80/sign?bulk=true' \
2
--header 'X-CSRF-Token: t1c-js' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"algorithm": "sha256",
6
"data": "Vc1GgP6EWiZ4BszrolrVvN+YfQCKWhbNFhcTyWxjL3A="
7
}'
Copied!
In the example above, no PIN is provided, this means that the fallback procedure will be triggered. The fallback in this scenario is the operating system PIN dialog which will be triggered.
os Dialog when no PIN is provided in request
After entering the PIN in the os Dialog, the PIN will be persisted in the volatile part of the device's memory.
More information on PIN handling can be found on the following link: PIN Handling
For each subsequent request, with the availability of the 'bulk' query-parameter with value 'true', the user will not need to enter its PIN code over and over again.

Clear the Cache

The cache (or volatile memory) is cleared when the following occurs:

Bulk is explicitly set to false

When the query-parameter 'bulk' is set to 'false', the pin will be ignored from the cache. The cache will be additionally cleared, and the memory freed.
1
curl --location --request POST 'https://t1c.t1t.io:51883/v3/modules/beid/apps/token/readers/9b28267029efca80/sign?bulk=false' \
2
--header 'X-CSRF-Token: t1c-js' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"algorithm": "sha256",
6
"data": "Vc1GgP6EWiZ4BszrolrVvN+YfQCKWhbNFhcTyWxjL3A="
7
}'
Copied!

Sign Request contains a new PIN value

When the upcoming signature request contains a 'pin' property, the cache will be implicitly cleared, and the cached PIN will become unavailable. The new provided PIN (encrypted off course), will be decrypted and used upon applying the signature.
1
curl --location --request POST 'https://t1c.t1t.io:51883/v3/modules/beid/apps/token/readers/9b28267029efca80/sign' \
2
--header 'X-CSRF-Token: t1c-js' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
"algorithm": "sha256",
6
"data": "Vc1GgP6EWiZ4BszrolrVvN+YfQCKWhbNFhcTyWxjL3A="
7
"pin": "some_encrypted_pin_value"
8
}'
Copied!

Explicit Reset Cache

A web/native application can explicitly clear the cache. The cache will free up the allocated volatile memory, and will clear the cache state.
1
curl --location --request GET 'https://t1c.t1t.io:51883/v3/modules/beid/apps/token/reset-bulk-pin' \
2
--header 'X-CSRF-Token: t1c-js' \
3
--data-raw ''
Copied!
Last modified 4mo ago