TT GIS credential management APIs

An IT professional uses the following message to finish configuring domestic credentials for TT GIS by uploading a digital certificate to a secure TraceLink server in Russia, which TT GIS requires for domestic credentials. The upload can be completed using a curl command on a computer with a UNIX or Windows 10 operating system.

A TraceLink Administrator must generate the ruBafsConnectorToken (i.e. security token) for the message in the Company Administration Web UI when they enter the domestic credentials.

The security token is valid for 30 minutes after generation.

Digital Certificate Upload (REST)

Authentication

Use a Post curl command to the following URL:

  • itest – https://itest-upload.ru1.tracelink.com/api/bafs/credentials
  • prod – https://upload.ru1.tracelink.com/api/bafs/credentials

Include a Content-Type header key-value pair with a value of multipart/form-data in the curl command.

Guidelines

Data Element Type Description
ruBafsConnectorToken String Required. The TraceLink provided value when saving credentials for a domestic account. This token is valid for 30 minutes.
password String Required. The password for the digital signature.
file String Required. The location on the local computer where the digital signature is located. Include @ before the file name.

Example

Copy 
curl -i -X POST -H "Content-Type: multipart/form-data" -F "ruBafsConnectorToken=0c382d0e-bcd7-4ed7-b502-a1210bb529f9" -F "password=pfx_password" -F "file=@credentials.pfx" https://itest-upload.ru1.tracelink.com/api/bafs/credentials

Errors

There are no errors for in this request. See the Digital Certificate Upload response for examples of a successful and failed response.

Guidelines

There are no elements in this response.

Example - Success

Copy 
HTTP/1.1 100 Continue
HTTP/1.1 201 Created
Date: Wed, 26 Jan 2023 19:44:33 GMT
Content-Length: 0

Example - Failure

Copy 
HTTP/1.1 100 Continue
HTTP/1.1 400 Bad Request
Date: Fri, 28 Jan 2023 14:49:20 GMT
Content-Type: text/plain
Content-Length: 30
RuNutra Connector Token has expired