Skip to main content

Check the Issuer When You Verify a Credential

Specifications:

In short​

  • A valid signature proves that a credential was not changed. It does not prove that the signer is a PID provider or a recognised attestation provider. A trust check proves that.
  • For each credential query of a presentation definition, you can require that a trust anchor in Accepted credential signers trusts the signer of the credential, and that one in Accepted status issuers trusts the signer of its status list.
  • These options stay with the verifier: the wallet never sees them. The DCQL trusted_authorities of a query are a separate thing that the wallet does see, so that it offers only matching credentials.
  • For demos and tests, accept the PID, PuB-EAA, QEAA and EAA lists of the NXD Trust List. For production, accept the official lists.

What the verifier checks​

The checks of the verifier at presentation. Before the request, the DCQL trusted authorities tell the wallet which credentials to offer. When the presentation arrives, for each credential query the verifier checks the signer of the credential against the accepted credential signers, for the role of the credential, and the signer of its status list against the accepted status issuers, or accepts the credential signer as status issuer. The results go to the verification record.

What the verifier checks for each credential query of a presentation, with the iGrant.io Organisation Wallet Suite as the verifier (ARF v3.0.0 §6.6.3, WE BUILD UC-TE-05).

For each presented credential, the verifier:

  1. Validates the signer certificate chain of the credential against the trust anchors in Accepted credential signers, for the role of the credential:
    • PID provider for a PID.
    • mDL issuer for an mDL.
    • Any issuer role otherwise: PID provider, QEAA provider, PuB-EAA provider, EAA provider or mDL issuer.
  2. Checks the signer of the status list of the credential against Accepted status issuers. By default, the credential signer may also sign the status list. The check then passes without a list lookup, with the reason same_as_credential_signer.

See Certificates and Chains for the eight checks on the path, and Trust Roles for the roles.

Turn on the checks​

In the dashboard, open a presentation definition and the settings of a credential query:

  • Credential signer trust:
    • Turn on Require a trusted credential signer.
    • Select the trust anchors in Accepted credential signers. The list offers only the trust anchors of the role of the credential.
  • Status issuer trust: this has its own switch, which does not follow the credential signer.
    • Turn on Require a trusted status issuer.
    • Keep The credential signer may sign the status list on, or select the trust anchors in Accepted status issuers. The list offers only trust anchors with Used As set to Status issuer.

In the API, they are options of each credential query of the presentation definition, credentialQueryOptions.<credential query id> (Update presentation definition):

{
"credentialQueryOptions": {
"pid": {
"requiresTrustedCredentialSigner": true,
"acceptedCredentialSigners": ["3f1e5a6b-7c8d-4e9f-8a0b-1c2d3e4f5a6b"],
"requiresTrustedStatusIssuer": true,
"acceptCredentialSignerAsStatusIssuer": true,
"acceptedStatusIssuers": []
}
}
}

The rules of an accepted list:

  • A list is required while its switch is on (trust.accepted_list_required).
  • Each value must be the ID of one of your trust anchors (trust.accepted_list_not_a_trust_source).
  • The trust anchor must be on (trust.accepted_list_source_disabled), and its role must fit (trust.accepted_list_wrong_role).

Trusted authorities are a filter​

The DCQL trusted_authorities of a credential query go to the wallet in the request, so that it offers only credentials from these authorities. They have no Require switch and no role:

  • etsi_tl: the URL of one of your trust anchors of kind ETSI TL or ETSI LOTE. The verifier uses its stored copy and downloads nothing at the time of the request.
  • aki: an authority key identifier. It helps the wallet find matching credentials, but it is not a proof of trust.

The verifier also checks that each presented credential matches them, without a role: a credential that does not match fails with PRES_TRUSTED_AUTHORITY_MISMATCH.

When a query has both trusted authorities and Require a trusted credential signer, the verifier applies Accepted credential signers after the DCQL query. See DCQL: Trusted Authorities.

What the verification record shows​

Each entry of presentationValidity of the verification record has validatedAt and, under the id of the credential query, these members (for a query with multiple, each credential is an item of credentials[] under the id):

MemberContent
credentialSignerTrustedListCheckThe check of the signer of the credential
statusIssuerTrustedListCheckThe check of the signer of its status list
statusIssuerIsCredentialSignertrue when the credential signer signed the status list

The codes of the trust findings:

CodeMeaningEffect
PRES_CREDENTIAL_SIGNER_NOT_TRUSTEDThe signer of the credential is not trusted, and the query requires a trusted credential signerThe credential fails
PRES_STATUS_ISSUER_NOT_TRUSTEDThe signer of the status list is not trusted, and the query requires a trusted status issuerThe credential fails
PRES_CREDENTIAL_SIGNER_X5C_MISSINGThe credential carries no certificate chain of its signerAdvisory
PRES_CREDENTIAL_SELF_SIGNEDThe credential is signed with a key that it names itself, so no issuer vouches for itAdvisory
TRUST_ENTRY_STATUSA match passed with an unusual status of the list entryWarning
TRUST_LIST_EXPIREDA match passed against an expired listWarning
TRUST_STATUS_CONFLICTThe entries of the signer do not agree on its status. The check used the valid entryWarning
TRUST_ENTITY_AMBIGUOUSEntries of more than one organisation list the signer, and its certificate names none of themWarning

In the dashboard, the verification details show the row Issuer Trusted in the checks of each credential. It is advisory, unless the query requires a trusted credential signer: then a signer that is not trusted fails the credential (PRES_CREDENTIAL_SIGNER_NOT_TRUSTED). The trust chip of the issuer opens its trust panel. See Read a Trust Check Result.

Sign your requests​

A wallet checks your verifier too, before it presents anything:

  • It validates the access certificate of your signed request against its trust anchors.
  • It can also check your registration certificate.

Sign your requests with an access certificate key, and get your access certificate listed. See Your Certificates.