Guides
Credential Verification
Presentation verification
Presentation templates
DID Auth

How to create a DID authentication presentation template

You can use MATTR VII to obtain a DID and authenticate its holder by requesting the holder to provide the DID in the form of a verifiable presentation.

Request

Make a request of the following structure to create a presentation request template to authenticate a holder using their DID:

HTTP
POST /v2/credentials/web-semantic/presentations/templates
JSON
{
    "name": "did-presentation",
    "domain": "learn.vii.au01.mattr.global",
    "query": [
        {
            "type": "DIDAuth"
        }
    ]
}
  • name : Insert a meaningful name for this presentation request.
  • domain : This indicates to the holder what domain is asking for information. This will need to be your tenant domain or a custom domain, if configured.
  • type : This should be DIDAuth to indicate to the holder that this is the DID it should return in the response.

Response

JSON
{
    "id": "aee61692-3568-484a-8eda-e150c48ec9e6",
    "name": "did-presentation",
    "domain": "learn.vii.au01.mattr.global",
    "query": [
        {
            "type": "DIDAuth"
        }
    ]
}

Authenticating

Once you've created the template, you can use it to authenticate using a DID via a Callback URL or OIDC Bridge verification workflows.