Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

UANATACA TSA API DOCUMENTATION (v1)

Table of Contents
stylenone

What it is

Uanataca qualified timestamp service is the only one that has full legal value, with reversal of the burden of proof, as required by the European Regulation 910/2014 and in many other international regulations.

...

Uanataca time-stamping is an online service that requires an endpoint url with authentication.

Endpoint URL

Uanataca qualified time-stamping service is exposed in:

https://tsa.uanataca.com/tsa/tss03in production environment

https://tsa.sandbox.uanataca.com/tsa/tss03tss03 in sandbox environment

Authentication

The service requires a Uanataca Billing account. Billing credentials are composed by username and password.

...

Hash generation using openssl and a SHA256 hash algorithm:

Code Block
languagehclnone
openssl ts -query -data testfile.pdf -no_nonce -sha256 -out request.tsq

...

An HTTP request to the TSA server sending the calculated hash value .tsq. At this point is required the hash file, the server URL and the client billing credentials to be included in the request.

Example

Code Block
languagenone
// Linux
curl -H 'Content-Type:application/timestamp-query' --data-binary @request.tsq https://tsa.uanataca.com/tsa/tss03 -o response.tsr -u billing_username:billing_password

// Windows
curl -H "Content-Type:application/timestamp-query" --data-binary @request.tsq https://tsa.uanataca.com/tsa/tss03 -o response.tsr -u billing_username:billing_password

...

Example

Code Block
languageoctavenone
openssl ts -reply -in response.tsr -text

Response

Code Block
languageadanone
1 | Status info:
2 | Status: Granted.
3 | Status description: unspecified
4 | Failure info: unspecified
5 | 
6 | TST info:
7 | Version: 1
8 | Policy OID: 0.4.0.2023.1.1
9 | Hash Algorithm: sha256
10| Message data:
11|     0000 - 22 e7 e9 67 5c 6b d7 ea-b6 7f 35 f0 e4 32 c6 9c   "..g\k....5..2..
12|     0010 - 98 e0 b0 f3 9c d7 ae dc-a8 6e 23 78 9f 75 28 6d   .........n#x.u(m
13|     0020 - e3 77 97 5e 43 12 0d 63-a7 fb 38 6b 12 af 1d 33   .w.^C..c..8k...3
14|     0030 - 25 b8 f8 e7 ec e3 8d 74-b8 fe a9 be a9 6f 84 54   %......t.....o.T
15| Serial number: 0x69C8C103117F52
16| Time stamp: Nov 11 17:11:42 2020 GMT
17| Accuracy: 0x01 seconds, unspecified millis, unspecified micros
18| Ordering: no
19| Nonce: unspecified
20| TSA: DirName:/C=ES/L=Barcelona/O=UANATACA S.A./OU=TSP-UANATACA/CN=Sello cualificado de tiempo electr\xC31 | 21| \xB3nico de UANATACA \xE2\x80\x93 TSU01/2.5.4.97=VATES-A66721499
22| Extensions:
23| qcStatements:
24|     0.0.......^..

...