light-mode-image
Learn
MATTR VII PlatformVerification request signers

Create a Verification request signer

Creates a Verification request signer.

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

Analytics Events

CREDENTIAL_PRESENTATION_VERIFIER_SIGNER_CERTIFICATE_CREATE_STARTCREDENTIAL_PRESENTATION_VERIFIER_SIGNER_CERTIFICATE_CREATE_SUCCESSCREDENTIAL_PRESENTATION_VERIFIER_SIGNER_CERTIFICATE_CREATE_FAIL

Roles

adminverifier
POST/v2/presentations/certificates/verifier-signers

Authorization

AuthorizationBearer <token>

In: header

Request Body

Request payload for creating a Verification request signer using an unmanaged (external) Verifier root CA certificate.

caIdstring

Internal identifier of the Verifier root CA certificate that will be used for signing the Verification request signer.

  • Must be an unmanaged (external) Verifier root CA certificate.
Formatuuid
caType?string

Indicates the source of the verifier root CA certificate. Set to external if the verifier root CA certificate is managed outside of MATTR (e.g., using your own PKI).

Value in"external"

Request payload for creating a Verification request signer that uses an Apple Business Connect root CA. The CSR produced from this request must be uploaded to Apple Business Connect. Apple then issues a certificate that you upload to MATTR VII to associate with the signer.

caTypestring

Source of the verifier root CA certificate. Set to apple when the root CA is issued and managed by Apple Business Connect.

Apple Business Connect support is a tech preview; functionality may be limited and subject to change.

Value in"apple"
emailAddressstring

Email address for the domain or IT administrator.

Formatemail
countrystring

Two-letter country code (ISO 3166-1 alpha-2).

stateOrProvinceNamestring

State, province, or region where the company is registered.

organizationNamestring

Legal name of the company.

commonNamestring

Fully qualified domain name (FQDN) hosting the verifier application.

Response Body

curl -X POST "https://example.vii.au01.mattr.global/v2/presentations/certificates/verifier-signers" \  -H "Content-Type: application/json" \  -d '{    "caId": "b0aae560-10e7-4247-8e96-7cdd3578a1e2"  }'
{
  "id": "782f1885-c7c2-4459-8426-b6d7c111b0b1",
  "csrPem": "-----BEGIN CERTIFICATE REQUEST-----\nMIIDXTCCAkWgAwIBAgIJAL5...\n-----END CERTIFICATE REQUEST-----",
  "caId": "b0aae560-10e7-4247-8e96-7cdd3578a1e2",
  "active": false,
  "caType": "mattr"
}
{
  "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 verifier root CA certificate DELETE

Previous Page

Retrieve all Verification request signers GET

Next Page