light-mode-image
Learn
API ReferenceRICAL Signers

Create a RICAL signer

Roles

admindts-provider

Analytics Events

ECOSYSTEM_RICAL_SIGNER_CERTIFICATE_CREATE_STARTECOSYSTEM_RICAL_SIGNER_CERTIFICATE_CREATE_SUCCESSECOSYSTEM_RICAL_SIGNER_CERTIFICATE_CREATE_FAIL
POST/v1/ecosystems/certificates/rical-signers

Creates a RICAL signer.

  • Only available in implementations using unmanaged (external) DTS root CA certificates.
  • A maximum of five RICAL signers can be created per tenant.

Provide either caId or intermediateCaId.

Analytic events

  • ECOSYSTEM_RICAL_SIGNER_CERTIFICATE_CREATE_START
  • ECOSYSTEM_RICAL_SIGNER_CERTIFICATE_CREATE_SUCCESS
  • ECOSYSTEM_RICAL_SIGNER_CERTIFICATE_CREATE_FAIL

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.vii.au01.mattr.global/v1/ecosystems/certificates/rical-signers" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "782f1885-c7c2-4459-8426-b6d7c111b0b1",
  "csrPem": "-----BEGIN CERTIFICATE REQUEST-----\nMIIDXTCCAkWgAwIBAgIJAL5...\n-----END CERTIFICATE REQUEST-----",
  "caId": "b0aae560-10e7-4247-8e96-7cdd3578a1e2",
  "intermediateCaId": "c1bbe671-21f8-5358-9537-eed4669b43f3",
  "active": false
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

How would you rate this page?

Delete a VICAL signer DELETE

Deletes a VICAL signer. <Callout> Only available in implementations using unmanaged (external) DTS root CA certificates. </Callout> ### **Analytic events** * ECOSYSTEM_VICAL_SIGNER_CERTIFICATE_DELETE_START * ECOSYSTEM_VICAL_SIGNER_CERTIFICATE_DELETE_SUCCESS * ECOSYSTEM_VICAL_SIGNER_CERTIFICATE_DELETE_FAIL

Retrieve all RICAL signers GET

Retrieves all RICAL signers. ### **Analytic events** * ECOSYSTEM_RICAL_SIGNER_CERTIFICATE_RETRIEVE_LIST_START * ECOSYSTEM_RICAL_SIGNER_CERTIFICATE_RETRIEVE_LIST_SUCCESS * ECOSYSTEM_RICAL_SIGNER_CERTIFICATE_RETRIEVE_LIST_FAIL