---
id: trust-holder-wallet
title: "Choose Which Issuers and Verifiers Your Organisation Wallet Trusts"
description: How the organisation wallet of the iGrant.io Organisation Wallet Suite checks the issuers it receives credentials from and the relying parties it presents to, against your accepted trust anchors, accepted client IDs and accepted ETSI lists.
hide_title: false
sidebar_label: Trust in Your Wallet
keywords: [organisation wallet, holder, wallet trust, trusted issuer, signed issuer metadata, access certificate, relying party, accepted client IDs, x509_san_dns, x509_hash, accepted ETSI trusted lists, status issuer, Organisation Wallet Suite, NXD Trust List]
slug: /trust-holder-wallet/
---

> **Build this with an AI coding agent.** Install the iGrant.io Agent Skills, then ask your agent to build the integration:
>
> ```bash
> npx skills add L3-iGrant/skills
> ```

<head>
  <title>Choose Which Issuers and Verifiers Your Organisation Wallet Trusts | iGrant.io DevDocs</title>
  <meta name="description" content="How the organisation wallet of the iGrant.io Organisation Wallet Suite checks the issuers it receives credentials from and the relying parties it presents to, against your accepted trust anchors, accepted client IDs and accepted ETSI lists."/>
</head>

import NoteBox from '@site/src/components/NoteBox';

<NoteBox title="Specifications:" variant="info">
<ul>
<li><a href="https://github.com/eu-digital-identity-wallet/eudi-doc-architecture-and-reference-framework/blob/v3.0.0/docs/main/06-trust-model.md" target="_blank" rel="noopener noreferrer">ARF v3.0.0</a> §6.6.2.2 (the wallet unit authenticates the PID or attestation provider) and §6.6.3.2 (the wallet unit authenticates the relying party instance)</li>
<li><a href="https://www.etsi.org/deliver/etsi_ts/119400_119499/11941108/01.01.01_60/ts_11941108v010101p.pdf" target="_blank" rel="noopener noreferrer">ETSI TS 119 411-8 V1.1.1</a> (access certificates) and <a href="https://www.etsi.org/deliver/etsi_ts/119600_119699/119602/01.01.01_60/ts_119602v010101p.pdf" target="_blank" rel="noopener noreferrer">ETSI TS 119 602 V1.1.1</a>, Annex F (the list of access certificate authorities)</li>
<li>OpenID for Verifiable Credential Issuance 1.0 (signed issuer metadata) and OpenID for Verifiable Presentations 1.0 (client ID prefixes <code>x509_san_dns</code> and <code>x509_hash</code>, DCQL <code>etsi_tl</code>)</li>
<li>WE BUILD WP4 use cases <a href="https://github.com/webuild-consortium/wp4-trust-group/blob/main/task1-use-cases/subtask1-2-trust-registry/wallet-unit-evaluates-credential-issuer.md" target="_blank" rel="noopener noreferrer">UC-TE-02</a> (wallet unit evaluates the credential issuer) and <a href="https://github.com/webuild-consortium/wp4-trust-group/blob/main/task1-use-cases/subtask1-2-trust-registry/wallet-unit-evaluates-relying-party.md" target="_blank" rel="noopener noreferrer">UC-TE-04</a> (wallet unit evaluates the relying party)</li>
</ul>
</NoteBox>

## In short

* Your organisation wallet (the holder of the iGrant.io Organisation Wallet Suite) checks both sides of an exchange.
* **Before it keeps a credential,** it can require that it trusts the signer of the credential, the signer of the issuer's metadata, and the signer of the credential's status list.
* **Before it answers a presentation request,** it can require that it trusts the relying party's access certificate, and that the client ID of the request is one you accept.
* Each check has a Require switch and an accepted list of trust anchors in the **holder configuration**. For demos and tests, accept the NXD Trust List; for production, the official lists.

## What the wallet checks

<figure className="ig-figure">

![The checks of the organisation wallet. When it receives a credential, the wallet checks the signer of the credential against the accepted credential signers, the signer of the signed issuer metadata against the accepted issuers as an access certificate provider, and the signer of the status list. When it receives a presentation request, it checks the signer of the request against the accepted relying parties as an access certificate provider, then the client ID against the accepted client IDs, and an etsi_tl item against the accepted ETSI trusted lists.](/img/docs/trust/trust-holder-checks.svg)

<figcaption>What your organisation wallet checks when it receives a credential and when it answers a presentation request (ARF v3.0.0 §6.6.2.2 and §6.6.3.2, WE BUILD UC-TE-02 and UC-TE-04).</figcaption>
</figure>

## Receiving credentials

In the dashboard, go to **Wallet Unit (Holder) > Received Credentials** and open **Wallet to Issuer Configuration**.

**Credential signer and issuer trust**
* **Require a trusted credential signer** and **Accepted credential signers:**
  * The wallet refuses a credential unless an accepted trust anchor trusts its signer.
  * The role follows the credential: PID provider for a PID, mDL issuer for an mDL, otherwise any issuer role.
* **Require a trusted issuer** and **Accepted issuers:**
  * The wallet refuses an issuer unless its credential issuer metadata is signed, and an accepted trust anchor trusts the signer as an access certificate provider.
  * This is how a wallet authenticates a PID provider or an attestation provider (ARF v3.0.0 §6.6.2.2).
  * With the switch off, the wallet does not read the signed metadata.

**Status issuer trust**
* 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**.
* With the switch on, the wallet refuses a credential whose status list signer is not trusted (`held_credential.status_issuer_not_trusted`).
* At a later refresh of the status, a new result is recorded, and the credential stays in the wallet.

## Answering presentation requests

In the dashboard, go to **Wallet Unit (Holder) > Shared Credentials**, open **Wallet to Verifier Configuration** and use the card **Relying party trust**:

* **Require a trusted relying party** and **Accepted relying parties:**
  * The wallet answers only requests whose signer an accepted trust anchor trusts as an access certificate provider.
  * This applies also to the requests that the wallet answers automatically.
* **Accepted client IDs** (with **Require a trusted relying party** on): client IDs with the prefix `x509_san_dns:` or `x509_hash:`, for example `x509_san_dns:verifier.example.com`.
  * When the list is set, the `client_id` of a request must be one of them.
  * An empty list narrows nothing.
  * A client ID alone never makes a signer trusted. A request must pass both lists.
* **Accepted ETSI trusted lists:**
  * These are the trust anchors of kind ETSI TL or ETSI LOTE that an `etsi_tl` item of a request may name. This list has no switch.
  * A request whose `etsi_tl` items name only other lists is refused, and the verifier gets `access_denied` with the reason.

These lists are checks that the wallet makes itself. It never sends them to an issuer or a verifier.

In the API, they are members of the holder configuration ([Update holder configuration](/docs/openid4vc-api/config-update-digital-wallet-open-id-holder-global-configuration/)):

```json
{
  "requiresTrustedCredentialSigner": true,
  "acceptedCredentialSigners": ["0b7c6d1e-2f3a-4b5c-8d9e-0f1a2b3c4d5e"],
  "requiresTrustedIssuer": true,
  "acceptedIssuers": ["8a9b0c1d-2e3f-4a5b-9c6d-7e8f9a0b1c2d"],
  "requiresTrustedRelyingParty": true,
  "acceptedRelyingParties": ["3f1e5a6b-7c8d-4e9f-8a0b-1c2d3e4f5a6b"],
  "acceptedClientIds": ["x509_san_dns:verifier.example.com"],
  "acceptedEtsiTrustedLists": ["5d4c3b2a-1f0e-4d9c-8b7a-6f5e4d3c2b1a"]
}
```

The list that you send replaces the stored list, so include the IDs that are already in it.

## What the wallet records

| Record | Member | Check |
| --- | --- | --- |
| A held credential | `credentialSignerTrustedListCheck` | The signer of the credential |
| | `issuerTrustedListCheck` | The signer of the signed issuer metadata |
| | `statusIssuerTrustedListCheck`, `statusIssuerIsCredentialSigner` | The signer of the status list |
| A holder presentation | `relyingPartyTrustedListCheck` | The signer of the request |

**In the dashboard,** a received credential shows the issuer's **Access certificate** (the signed metadata), the **Issuer key** and the **Status list**, each with its trust chip. A shared credential shows the access certificate of the verifier. The registration certificate of the verifier shows **Not supported**: the wallet does not check registration certificates yet.

## Related pages

* [Manage Your Organisation's Trust Anchors](/docs/trust-anchors/)
* [Read a Trust Check Result](/docs/trust-check-results/)
* [The "Issuer / service provider not verified" notice](/docs/trust-untrusted-service-provider/)
* [Receive and Store a Credential](/docs/openID4vc-receive-and-store-credential/)
* [Receive and Present Credentials](/docs/openID4vp-receive-and-present-credentials/)
