Signers

Create a RICAL signer

POST/v1/ecosystems/certificates/rical-signers

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X POST "https://example.com/v1/ecosystems/certificates/rical-signers" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "csrPem": "string",  "caId": "24c00dcc-a2d5-4635-ba3f-14dcbc0a8ea3",  "intermediateCaId": "c04f6eaa-7183-4dfc-a249-59f9e8b2ddde",  "active": false}

Retrieve all RICAL signers

GET/v1/ecosystems/certificates/rical-signers

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

limit?number

Range size of returned list.

Range1 <= value <= 1000

Default100

cursor?string

Starting point for the list of entries.

Response Body

`application/json`

curl -X GET "https://example.com/v1/ecosystems/certificates/rical-signers"

{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "active": true,      "certificatePem": "string",      "certificateFingerprint": "string",      "certificateData": {        "commonName": "string",        "country": "string",        "notAfter": "2019-08-24T14:15:22Z",        "notBefore": "2019-08-24T14:15:22Z"      }    }  ],  "nextCursor": "string"}

Retrieve a RICAL signer

GET/v1/ecosystems/certificates/rical-signers/{ricalSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

ricalSignerId*string

Unique identifier of the RICAL signer.

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/v1/ecosystems/certificates/rical-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "active": true,  "certificatePem": "string",  "certificateFingerprint": "string",  "certificateData": {    "commonName": "string",    "country": "string",    "notAfter": "2019-08-24T14:15:22Z",    "notBefore": "2019-08-24T14:15:22Z"  }}

Update a RICAL signer

PUT/v1/ecosystems/certificates/rical-signers/{ricalSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

ricalSignerId*string

Unique identifier of the RICAL signer.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

`application/json`

curl -X PUT "https://example.com/v1/ecosystems/certificates/rical-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "active": true  }'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "active": true,  "certificatePem": "string",  "certificateFingerprint": "string",  "certificateData": {    "commonName": "string",    "country": "string",    "notAfter": "2019-08-24T14:15:22Z",    "notBefore": "2019-08-24T14:15:22Z"  }}

Delete a RICAL signer

DELETE/v1/ecosystems/certificates/rical-signers/{ricalSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

ricalSignerId*string

Unique identifier of the RICAL signer.

Formatuuid

Response Body

`application/json`

curl -X DELETE "https://example.com/v1/ecosystems/certificates/rical-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08"

Empty

Create a RICAL signer

POST/v1/ecosystems/certificates/rical-signers

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

caId*string

Internal identifier of the DTS root CA certificate that will be used for signing the RICAL signer.

Must be an unmanaged (external) DTS root CA certificate.

Formatuuid

intermediateCaId?string

Internal identifier of the DTS intermediate CA certificate that will be used for signing the RICAL signer.

Formatuuid

Response Body

`application/json`

curl -X POST "https://example.com/v1/ecosystems/certificates/rical-signers" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "csrPem": "string",  "caId": "24c00dcc-a2d5-4635-ba3f-14dcbc0a8ea3",  "intermediateCaId": "c04f6eaa-7183-4dfc-a249-59f9e8b2ddde",  "active": false}

Retrieve all RICAL signers

GET/v1/ecosystems/certificates/rical-signers

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

limit?number

Range size of returned list.

Range1 <= value <= 1000

Default100

cursor?string

Starting point for the list of entries.

Response Body

`application/json`

curl -X GET "https://example.com/v1/ecosystems/certificates/rical-signers"

{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "active": true,      "certificatePem": "string",      "certificateFingerprint": "string",      "certificateData": {        "commonName": "string",        "country": "string",        "notAfter": "2019-08-24T14:15:22Z",        "notBefore": "2019-08-24T14:15:22Z"      }    }  ],  "nextCursor": "string"}

Retrieve a RICAL signer

GET/v1/ecosystems/certificates/rical-signers/{ricalSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

ricalSignerId*string

Unique identifier of the RICAL signer.

Formatuuid

Response Body

`application/json`

curl -X GET "https://example.com/v1/ecosystems/certificates/rical-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "active": true,  "certificatePem": "string",  "certificateFingerprint": "string",  "certificateData": {    "commonName": "string",    "country": "string",    "notAfter": "2019-08-24T14:15:22Z",    "notBefore": "2019-08-24T14:15:22Z"  }}

Update a RICAL signer

PUT/v1/ecosystems/certificates/rical-signers/{ricalSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

ricalSignerId*string

Unique identifier of the RICAL signer.

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

active*boolean

Indicates if the RICAL signer is active. Only active RICAL signers can be used to sign RICALs.

certificatePem?string

RICAL Signer Certificate in PEM format.

Must match the Certificate Signing Request (CSR) issued for this RICAL signer.
Must be signed by the same DTS root CA (or DTS intermediate CA) specified when the RICAL signer was created.

Response Body

`application/json`

curl -X PUT "https://example.com/v1/ecosystems/certificates/rical-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "active": true  }'

{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "active": true,  "certificatePem": "string",  "certificateFingerprint": "string",  "certificateData": {    "commonName": "string",    "country": "string",    "notAfter": "2019-08-24T14:15:22Z",    "notBefore": "2019-08-24T14:15:22Z"  }}

Delete a RICAL signer

DELETE/v1/ecosystems/certificates/rical-signers/{ricalSignerId}

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

ricalSignerId*string

Unique identifier of the RICAL signer.

Formatuuid

Response Body

`application/json`

curl -X DELETE "https://example.com/v1/ecosystems/certificates/rical-signers/497f6eca-6276-4993-bfeb-53cbbbba6f08"

Empty

201application/json

400application/json

404application/json

409application/json

200application/json

400application/json

404application/json

200application/json

404application/json

200application/json

400application/json

404application/json

204

400application/json

404application/json

On this page

Signers

201application/json

400application/json

404application/json

409application/json

200application/json

400application/json

404application/json

200application/json

404application/json

200application/json

400application/json

404application/json

204

400application/json

404application/json

On this page

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`