Management
In order for a T1C-API to be downloadable from and be able to register with the Distribution Service, a few steps must be executed.
Management User Interface
Will be added later
REST API
We offer a Postman collection of the DS REST API which you can use. Below we will provide more information on the endpoints and their parameters.
Obtain IDP Token
For the management endpoints a user JSON web token is necessary. it can be obtained from the IDP and must be included in all management requests to the DS REST API as a bearer token
Example
Request
Note that the request is x-www-form-urlencoded
The response will contain an access_token
property value which can be used in management requests made to the DS REST API.
Sample response
Create Or Update Version
It is necessary to create a version in order to have a valid registration API key for the installer packages
Example
Request
Create Or Update Context Config
The context config contains variable configuration for the installed T1C-API packages
Example
Wildcards in the CORS allowlist are only supported from the T1C API/Proxy v3.2.6 onwards.
Request
Create Or Update File Digests Config
The file digests config contains a list of files and their MD5 digests. At startup, the T1C-API will verify that these files are unaltered and shut down if that is not the case. We recommend leaving it empty during testing.
Example
Request
Create or Update SSL Keystore Config
The SSL keystore config contains the URI for the latest SSL keystore used by the T1C-API for it's local server. The T1C-API will check if it has the latest and unaltered SSL keystore at startup and replace it if necessary.
Example
Request
Create Or Update Organization
An organization is an entity that groups labels together. It is required in order to create a label
Example
Request
Create Or Update Label
A label is analogous to an application in the DS API v2. In v3 a label is associated with an API key which applications can exchange for a temporary JSON web token that can be passed to the client. A label can be used by multiple applications, or a label can be created for each application.
Example
Request
Label IDs must be unique across all organizations as the T1C-API is not aware of any organizational context, only labels.
Last updated