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"
        }
    ]
}

id : Unique identifier for this presentation template on your MATTR VII tenant. You will need it to create a presentation request based on this template. You can also use it to retrieve, update or delete this presentation template.

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.