Skip to main content

Read a Trust Check Result

Specifications:

In short​

  • Every trust check of the iGrant.io Organisation Wallet Suite records its result in the same shape, a trusted list check, wherever it runs: issuance, verification or the organisation wallet.
  • It says whether the signer is trusted, for which role, which entry of which trust anchor matched, and why not when it is not.
  • It also keeps the certificates that the signer presented and the result of each check on the path, so that you can see exactly what was checked.

The shape of a check​

What a trust check records. The signer presents its certificate chain. The check runs the path checks, finds the matching entries in your accepted trust anchors, decides which entry to use when more than one matches, and gives a result with a reason or a warning.

What a trust check records. It has the same shape at issuance, at verification and in the organisation wallet (IETF RFC 5280 §6, ETSI TS 119 612 and TS 119 602).
{
"verified": true,
"result": "trusted",
"role": "pid_provider",
"entry": {
"entryId": "fYzBWmw8vWBPbY_y5R-Ilg",
"status": "granted",
"roles": ["pid_provider"],
"provider": { "tSPName": "Example PID Provider" },
"service": { "serviceTypeIdentifier": "http://uri.etsi.org/19602/SvcType/PID/Issuance" },
"source": {
"id": "71c85eab-312e-461c-82f9-dbcd61b0bece",
"name": "NXD Trust List: PID providers",
"kind": "etsi_lote"
}
},
"reason": null,
"warning": null,
"presentedCertificates": [
{ "subject": "CN=Example PID Signer", "issuer": "CN=Example PID CA", "certificate": "MIIC..." }
],
"pathChecks": [
{ "code": "signature", "result": "passed" },
{ "code": "validity", "result": "passed" },
{ "code": "caRules", "result": "passed" },
{ "code": "keyUsage", "result": "passed" },
{ "code": "revocation", "result": "not_checked" },
{ "code": "entryStatus", "result": "passed" },
{ "code": "role", "result": "passed" },
{ "code": "objectSignature", "result": "passed" }
]
}
MemberContent
verifiedtrue only when result is trusted
resulttrusted, not_trusted, not_found (in no accepted trust anchor), not_applicable (the Require switch is off) or error (the check could not decide)
roleThe role that the check asks for
entryThe matched entry: its entryId, status, roles, provider, service and trust anchor (source)
reasonWhy the result is not_trusted, not_applicable or error
warningWhy a trusted result has a warning
presentedCertificatesThe certificates that the signer presented, the signer certificate first (base64 DER)
pathChecksThe result of each check on the path: passed, failed or not_checked. See Certificates and Chains.
matchesEvery entry that matched the chain, with its result and its trust anchor. The check uses one of them.
decisionWhy the check used that entry, when more than one matched
acceptedSourcesThe trust anchors of the accepted list of the setting

Older records may have only some of these members.

Why a signer is not trusted​

reason.codeMeaning
not_requiredThe Require switch of the check is off, so no check ran
same_as_credential_signerThe credential signer signed the status list, and the setting accepts it (a trusted result with no list lookup)
not_acceptedThe client ID of the request is not one of the accepted client IDs
wrong_roleThe entry is listed for another role
not_grantedThe status of the entry is not granted, for example withdrawn
certificate_not_validThe certificate of the entry is not valid now
path_not_validA signature of the certificate path does not verify
ca_rules_not_metA CA of the path may not issue certificates
key_usage_not_allowedThe signer certificate may not make signatures
revokedThe signer certificate is revoked
object_signatureThe object is not signed with the key of the signer certificate
ski_onlyThe entry gives only a key identifier, which cannot verify a signature
list_not_downloadedAn accepted list is not downloaded, and nothing else matched (error)
check_failedThe check could not run, with a message (error)

Warnings​

A trusted result can carry a warning. The signer passes, but you should look:

warning.codeMeaning
entry_statusThe entry has an unusual status, or a TS 119 612 entry has no status
list_expiredThe match is in an expired list, from its last stored copy
entity_ambiguousEntries of more than one organisation list the signer, and its certificate names none of them
status_conflictThe entries that list the signer do not agree on its status. The check used the valid entry.

Where checks are recorded​

WhereMember
Issuance history: the wallet instance attestationauthorisation.walletUnitAttestation.walletProviderTrustedListCheck
Issuance history: a key attestationauthorisation.keyAttestation.walletProviderTrustedListCheck, or platformRootCheck for an Android hardware Keystore key
Verification record: each presented credentialpresentationValidity[].<credential query id>.credentialSignerTrustedListCheck and .statusIssuerTrustedListCheck (for a query with multiple, under credentials[])
Organisation wallet: a held credentialcredentialSignerTrustedListCheck, issuerTrustedListCheck and statusIssuerTrustedListCheck
Organisation wallet: a presentationrelyingPartyTrustedListCheck

In the dashboard​

Each check shows as a trust chip:

ChipWhen
Trusted (green)The result is trusted
Trusted, with a warning (amber)The result is trusted and has a warning
Not trusted (red)The result is not_trusted or not_found
The check failed (orange)The result is error
Not checked (grey)No check ran, for example because the Require switch is off. The hover text names the switch.

The chip of a party, at the top of a record, shows its worst row. Select a chip to open its trust panel. The title of the panel is Trust: with the name of the row, for example Trust: Wallet provider, or Trust in the signer. The panel has these cards:

  • Result: the result and why, the role that the check asked for (Checked for the role) and the Accepted trust anchors.
  • Certificate chain: the certificates that the signer sent, signer first. When your trust anchor lists the CA above them, that CA comes last, under From your trust anchor and its name. Show technical details has the copy and the download of each certificate.
  • Checks: the result of each check on the path.
  • Entries that match: the entry that the check used (Used), and the other entries with Valid, Valid, with a warning or Not valid.

Select an entry to open it in its trust anchor.