MDLP credential management APIs

An IT professional uses the following message to finish configuring domestic credentials for MDLP by uploading a digital certificate to a secure TraceLink server in Russia, which MDLP 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 ruconnectorToken (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/credentials
  • prod – https://upload.ru1.tracelink.com/api/credentials

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

Guidelines

Data Element Occurs
Length		 Type Description
ruconnectorToken

[1...1]

[1/36]

 String Required. The TraceLink provided value when saving credentials for a domestic account. This token is valid for 30 minutes.
password

[1...1]

[-]

 String Required. The password for the digital signature.
file

[1...1]

[-]

 String Required. The location on the local computer where the digital signature is located. Include @ before the file name.

Example

curl -i -X POST -H "Content-Type: multipart/form-data" -F "ruconnectorToken=0c382d0e-bcd7-4ed7-b502-a1210bb529f9" -F "password=pfx_password" -F "file=@credentials.pfx" https://itest-upload.ru1.tracelink.com/api/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

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

Example - Failure

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