Create a verifier root CA certificate

POST/v2/presentations/certificates/ca

Creates a verifier root CA certificate to be used as part of mDocs online verification workflows.

A maximum of three Verifier root CA certificates can be created per tenant.

Analytic events

CREDENTIAL_PRESENTATION_VERIFIER_CA_CERTIFICATE_CREATE_START
CREDENTIAL_PRESENTATION_VERIFIER_CA_CERTIFICATE_CREATE_SUCCESS
CREDENTIAL_PRESENTATION_VERIFIER_CA_CERTIFICATE_CREATE_FAIL

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

Verifier root CA certificate payload

TypeScript Definitions

Use the request body type in TypeScript.

Request payload for managed verifier root CA certificate

commonName?string

Used to define the common name of the created verifier root CA certificate. Used to establish trust with the verifier by wallets that implement certificate-based trust.

When provided, the value must be a valid PrintableString and cannot be an empty string.
If not provided and a custom domain is configured and verified, the custom domain is used followed by the word Verifier.
If no custom domain is configured, the tenant subdomain is used instead.

Default"{tenantDomain} Verifier"

country?string

Indicates the verifier's country. If not provided, a country is selected based on the region of the tenant subdomain cloud host. When specified, the value must be a valid Alpha 2 country code as per ISO 3166-1.

notBefore?string

Used to set the date and time when the Verifier root CA certificate becomes valid and can be used to sign other intermediate certificates.

Must not be in the past.
Must be before notAfter.

Formatdate-time

notAfter?string

Used to set the date and time when the Verifier root CA certificate expires.

If not provided, calculated as notBefore + 20 years.
If not provided and notBefore is not provided, calculated as time of creation + 20 years.
Maximum value is 20 years from creation.
Must be after notBefore, if provided.

Formatdate-time

Response Body

`application/json`

curl -X POST "https://example.com/v2/presentations/certificates/ca" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "string",  "certificatePem": "string",  "certificateFingerprint": "string",  "certificateData": {    "commonName": "string",    "country": "string",    "notAfter": "2019-08-24T14:15:22Z",    "notBefore": "2019-08-24T14:15:22Z"  },  "active": true,  "isManaged": true}

Create a verifier root CA certificate

Roles

Analytics Events

Analytic events

Authorization

Request Body

Response Body

`application/json`

`application/json`

`application/json`

Create a verifier root CA certificate

Roles

Analytics Events

Analytic events

Authorization

Request Body

Response Body

200application/json

400application/json

409application/json

`application/json`

`application/json`

`application/json`