light-mode-image
Learn
MATTR VII PlatformVerifiers

Update an OIDC Verifier

Updates an existing OIDC Verifier by providing its ID.

Analytics Events

OIDC_VERIFIER_UPDATE_STARTOIDC_VERIFIER_UPDATE_SUCCESSOIDC_VERIFIER_UPDATE_FAIL

Roles

adminverifier
PUT/ext/oidc/v1/verifiers/{id}
AuthorizationBearer <token>

In: header

Path Parameters

idstring

Verifier ID

Formatuuid

Update a verifier

verifierDidstring

Specifies the DID where the verifiable presentation will be sent to.

presentationTemplateIdstring

References the unique identifier of a Presentation Request Template that will be used by this verifier to create presentation requests.

Formatuuid
claimMappingsarray<object>

As part of verifying a credential, the OIDC client initiates the request expecting a standard OIDC ID Token. However, as the digital wallet provides the credential in JSON-LD terms, it is required to map JSON-LD claims to OpenID Connect terms.

  • Currently the platform only supports schema.org for data vocabularies.
  • Make sure to use http:// and not https:// when entering jsonLdFqn values for schema.org. Otherwise you may not get the claims returned in your ID Token.
includePresentation?boolean

When set to true, the generated id_token will include the original presentation from the wallet.

Response Body

curl -X PUT "https://example.vii.au01.mattr.global/ext/oidc/v1/verifiers/41458e5a-9092-40b7-9a26-d4eb43c5792f" \  -H "Content-Type: application/json" \  -d '{    "verifierDid": "did:key:z6MkrYVmyqSA93o4B1GwERM8kaQDMAUKAFV2TC3weQKeg9Gq",    "presentationTemplateId": "364b6a1b-3600-4927-a6ac-4d66aa6bbac3",    "claimMappings": [      {        "jsonLdFqn": "http://schema.org/alumniOf",        "oidcClaim": "alumni_of"      }    ],    "includePresentation": true  }'
{
  "id": "41458e5a-9092-40b7-9a26-d4eb43c5792f",
  "verifierDid": "did:key:z6MkrYVmyqSA93o4B1GwERM8kaQDMAUKAFV2TC3weQKeg9Gq",
  "presentationTemplateId": "364b6a1b-3600-4927-a6ac-4d66aa6bbac3",
  "claimMappings": [
    {
      "jsonLdFqn": "http://schema.org/alumniOf",
      "oidcClaim": "alumni_of"
    }
  ],
  "includePresentation": true
}
{
  "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?