# EUDIPLO > Middleware for the European Digital Identity Wallet ecosystem This file contains links to documentation sections following the llmstxt.org standard. ## Table of Contents - [What is EUDIPLO?](https://docs.eudiplo.dev/): EUDIPLO is open-source middleware that connects your backend to EUDI Wallets. Your application calls a JSON management API to issue a credential or... - [Cookbook: Certificates from the EUDI Hub](https://docs.eudiplo.dev/cookbooks/eudi-hub-certificates): Wallets of the German ecosystem accept a verifier only with an access certificate from the German registrar, the EUDI Hub, and show what it may req... - [Cookbook: Issue a Membership Credential](https://docs.eudiplo.dev/cookbooks/first-credential): This is chapter 2 of the **Issue and verify** cookbook. You create a tenant with its own keys and issuer identity, define a membership credential, ... - [Cookbook: Verify the Membership Credential](https://docs.eudiplo.dev/cookbooks/first-presentation): This is chapter 3 of the **Issue and verify** cookbook. You publish a trust list with your issuer, request the `name` and `member_id` claims of the... - [Cookbook: Install and Connect](https://docs.eudiplo.dev/cookbooks/foundation): This is chapter 1 of the **Issue and verify** cookbook. You start EUDIPLO and the Web Client on your computer, make the backend reachable from your... - [Cookbooks](https://docs.eudiplo.dev/cookbooks): Each cookbook ends in a working result and has a checkpoint after every step. Start with **Issue and verify**: the other recipes build on the insta... - [Cookbook: Integrate EUDIPLO into Your Backend](https://docs.eudiplo.dev/cookbooks/integrate-backend): Your backend takes over from the Web Client: it gets a token, creates presentation requests and credential offers, and receives the results by webh... - [Cookbook: Issue a Credential after Login](https://docs.eudiplo.dev/cookbooks/issue-after-login): The person receiving the credential signs in at Keycloak first. EUDIPLO then asks your attribute provider for the claims of exactly that person. Us... - [Cookbook: Manage an Instance with the CLI](https://docs.eudiplo.dev/cookbooks/manage-with-cli): You manage a running EUDIPLO instance from the command line: you keep a tenant's configuration as files next to the deployment, check them before e... - [Cookbook: Production on One VM](https://docs.eudiplo.dev/cookbooks/production-vm): You run EUDIPLO on a single Linux server with the CLI, behind a TLS reverse proxy, with restricted ports, backups and a strict health check. The re... - [Cookbook: Revocable Credentials](https://docs.eudiplo.dev/cookbooks/revocable-credentials): You turn on status management for the membership credential, issue a new one, revoke it, and watch the next presentation fail. A variant at the end... - [Cookbook: Sign in to Keycloak with a Wallet](https://docs.eudiplo.dev/cookbooks/sign-in-with-wallet): Keycloak can use EUDIPLO as an external identity provider: the user chooses **Membership wallet** on the Keycloak login page, presents the membersh... - [Cookbook: Accept Only Trusted Issuers](https://docs.eudiplo.dev/cookbooks/trusted-issuers): In chapter 3, `membership-check` accepts the membership credential only from issuers on the trust list `membership-issuers`. You now test it with a... - [Attribute providers](https://docs.eudiplo.dev/issuance/attribute-provider): Fetch claim values from your backend at the moment the wallet requests a credential. An attribute provider is a tenant resource with your endpoint'... - [Authorization servers](https://docs.eudiplo.dev/issuance/authorization-servers): Configure how wallets obtain the access token they present at the credential endpoint. Authorization servers are entries of `authorizationServers` ... - [Claim sources](https://docs.eudiplo.dev/issuance/claims): Decide where the claim values of a credential come from. EUDIPLO picks exactly one source per credential, validates the result against the credenti... - [Configure a credential](https://docs.eudiplo.dev/issuance/credential-configuration): A credential configuration defines one credential type your tenant issues: its format, type identifier, claims, wallet display and signing behavior... - [Create credential offers](https://docs.eudiplo.dev/issuance/credential-offers): Start an issuance: your backend creates an offer, EUDIPLO returns an offer URI, and you show it to the wallet as a QR code or link. Which flow to o... - [Deferred issuance](https://docs.eudiplo.dev/issuance/deferred-issuance): Issue a credential later, for example after a manual review or a background check. Your attribute provider tells EUDIPLO to defer, the wallet polls... - [Issuance](https://docs.eudiplo.dev/issuance): EUDIPLO issues SD-JWT VC (`dc+sd-jwt`) and mDOC (`mso_mdoc`) credentials over OpenID for Verifiable Credential Issuance (OID4VCI). You configure th... - [Interactive authorization (experimental)](https://docs.eudiplo.dev/issuance/interactive-authorization): Require the user to complete steps in the wallet, such as presenting a PID or finishing a web form, before EUDIPLO issues the authorization code. T... - [Configure the issuer](https://docs.eudiplo.dev/issuance/issuance-configuration): Set the issuer-wide settings of a tenant: how the issuer is shown in wallets, which authorization servers it offers, and how its token and credenti... - [Receive wallet notifications](https://docs.eudiplo.dev/issuance/notifications): Find out whether the wallet stored, rejected or deleted a credential. Wallets report this to the OID4VCI notification endpoint; EUDIPLO records the... - [Revoke and suspend credentials](https://docs.eudiplo.dev/issuance/revocation): Revoke or suspend credentials you issued, using Token Status Lists (draft-ietf-oauth-status-list). EUDIPLO assigns every credential an entry in a s... - [Configure Verification](https://docs.eudiplo.dev/presentation/configure-verification): A presentation configuration is the reusable definition of a verification: which credentials and claims to request, how long a request is valid, an... - [DCQL (Digital Credentials Query Language)](https://docs.eudiplo.dev/presentation/dcql): The `dcql_query` of a presentation configuration tells the wallet which credentials and claims to present. EUDIPLO uses the DCQL of OpenID4VP 1.0 a... - [Credential Presentation](https://docs.eudiplo.dev/presentation): EUDIPLO verifies credentials from EUDI wallets with OpenID4VP and, for mDOCs in the browser, ISO/IEC 18013-7 Annex C. You define what to request on... - [Sign-in with OpenID Connect](https://docs.eudiplo.dev/presentation/openid-connect): EUDIPLO can act as an OpenID Provider, so an application that already speaks OpenID Connect can verify a credential from the user's wallet. The app... - [Receive Results](https://docs.eudiplo.dev/presentation/receive-results): After you create a presentation request, the result arrives in the session whose ID the request returned. Your backend can be called by a webhook, ... - [Create Presentation Requests](https://docs.eudiplo.dev/presentation/requests): Every verification starts with `POST /api/verifier/offer`. It creates a session from a presentation configuration and returns what you hand to the ... - [Transaction Data](https://docs.eudiplo.dev/presentation/transaction-data): Transaction data binds a presentation to a concrete transaction, such as a payment. The wallet shows it to the user, and the holder's signature ove... - [Wallet and Key Attestation](https://docs.eudiplo.dev/trust/attestation): During issuance, EUDIPLO can check two statements signed by the wallet provider: a wallet attestation, which proves that the wallet app is a genuin... - [EUDI Hub](https://docs.eudiplo.dev/trust/eudi-hub): The German EUDI Hub (portal.eudi-hub.gov.de) is the registrar of the German wallet ecosystem and the registrar EUDIPLO integrates with: organizatio... - [OpenID Federation](https://docs.eudiplo.dev/trust/federation): EUDIPLO can use OpenID Federation trust anchors to decide whether to trust external authorization servers, the upstream provider of a chained autho... - [Trust](https://docs.eudiplo.dev/trust): Wallets and verifiers only accept EUDIPLO if they trust its certificates, and EUDIPLO only accepts credentials and wallets it can trust. This secti... - [Keys and Certificates](https://docs.eudiplo.dev/trust/keys-and-certificates): A key chain is a signing key together with its certificate chain. Each tenant needs one per purpose: an access key chain to sign presentation reque... - [Registration Certificates](https://docs.eudiplo.dev/trust/registration-certificates): A registration certificate is a JWT, issued by a registrar, that states what a relying party is registered for: a verifier the data it may request ... - [Trust Lists](https://docs.eudiplo.dev/trust/trust-lists): A trust list names the issuers you accept. EUDIPLO uses Lists of Trusted Entities (LoTE, ETSI TS 119 602) as signed JWTs: it publishes lists you ma... - [Wallet and Registrar Requirements](https://docs.eudiplo.dev/trust/wallet-registrars): Which certificates a wallet accepts depends on the wallet and its environment: a development wallet may accept self-signed certificates, while a re... - [CLI](https://docs.eudiplo.dev/operate/cli): The `eudiplo` command creates and runs Compose deployments, registers existing deployments, and checks any of them with `doctor`. This page shows h... - [Configuration as Code](https://docs.eudiplo.dev/operate/configuration-as-code): Keep tenant configuration in files, validate it in CI, and move it between instances with reviewed plans. The file layout, envelope, versions and p... - [Database](https://docs.eudiplo.dev/operate/database): Connect EUDIPLO to SQLite or PostgreSQL, understand how schema migrations run, and set how long session data is kept. Sensitive columns are encrypt... - [Compose without the CLI](https://docs.eudiplo.dev/operate/docker-compose): Run EUDIPLO with the Compose file in `deployment/docker-compose` and manage it with `docker compose` yourself. If you prefer generated files and... - [Encryption Keys](https://docs.eudiplo.dev/operate/encryption-keys): Choose where the key for data at rest comes from and keep it stable. EUDIPLO encrypts private keys, secrets in the configuration and personal sessi... - [Operate EUDIPLO](https://docs.eudiplo.dev/operate): These guides cover running EUDIPLO yourself: choosing a deployment, configuring storage, keys and access, and keeping the instance observable. Befo... - [Keycloak SSO](https://docs.eudiplo.dev/operate/keycloak): Use Keycloak as the identity provider of the management API: people sign in to the web client with their Keycloak account, and EUDIPLO creates tena... - [Key Management (KMS)](https://docs.eudiplo.dev/operate/kms): Choose where the private keys of signing key chains live and configure the provider in `kms.json`. By default every key is created by the `db` prov... - [Kubernetes](https://docs.eudiplo.dev/operate/kubernetes): Deploy EUDIPLO to a cluster with the Kustomize overlays in `deployment/k8s`. The overlays are a starting point: each workload runs one replica, and... - [Load Testing](https://docs.eudiplo.dev/operate/load-testing): Measure how a deployment handles token requests, pre-authorized issuance, complete OID4VP presentations and status-list reads, alone or as a mixed ... - [Logging](https://docs.eudiplo.dev/operate/logging): Set the log level and destinations, keep per-session protocol logs for troubleshooting, and bound the audit log. Metrics and traces are covered in ... - [Monitoring](https://docs.eudiplo.dev/operate/monitoring): Collect EUDIPLO's metrics, traces and logs with OpenTelemetry and view them in Grafana. The backend pushes all three signals over OTLP/HTTP to a co... - [Object Storage](https://docs.eudiplo.dev/operate/object-storage): Configure where EUDIPLO stores uploaded files: credential images, logos and the `images/` of imported tenant configurations. Use the local filesyst... - [Other OIDC providers](https://docs.eudiplo.dev/operate/oidc-provider): Use an OpenID Connect provider other than Keycloak, such as Authentik, Zitadel, Auth0 or Entra ID, to sign in to the management API and the web cli... - [Production Checklist](https://docs.eudiplo.dev/operate/production-checklist): Work through this list before an instance serves real wallets and users, and again after major upgrades. Each item links to the guide that explains... - [Keep a Tenant in Git](https://docs.eudiplo.dev/operate/tenant-folders-in-git): Export a tenant from a running instance as a tenant folder, commit it, and plan and import changes to it from the folder. Bundles, plans and owners... - [Tenants and Access](https://docs.eudiplo.dev/operate/tenants-and-access): Create tenants, give applications least-privilege API clients, and let people sign in. Every management endpoint (`/api/...`) needs an OAuth 2.0 be... - [TLS and Reverse Proxy](https://docs.eudiplo.dev/operate/tls): Serve EUDIPLO over HTTPS, either behind a TLS-terminating reverse proxy or with the backend's built-in TLS. Wallets require HTTPS for every issuer ... - [Web Application Firewall](https://docs.eudiplo.dev/operate/waf): Which routes wallets, browsers and your backends call, and how to configure a WAF so that issuance and presentation keep working while the manageme... - [API Reference](https://docs.eudiplo.dev/reference/api): Where the OpenAPI specification lives, how to authenticate, and how to call the API with @eudiplo/sdk-core. - [Attribute provider API](https://docs.eudiplo.dev/reference/attribute-provider-api): Contract between EUDIPLO and attribute providers or offer webhooks that supply credential claims. - [CLI Reference](https://docs.eudiplo.dev/reference/cli): Every command and option of the `eudiplo` CLI, generated from the CLI's own command definitions. Installation, instances, drivers, environment vari... - [Config Bundle Format](https://docs.eudiplo.dev/reference/config-bundle-format): The format of configuration documents, tenant config folders and export bundles, as read by the startup import, the bundle API and the CLI. For the... - [Credential configuration reference](https://docs.eudiplo.dev/reference/credential-configuration): Every field of a credential configuration, generated from the schema the backend validates with. - [Environment Variables](https://docs.eudiplo.dev/reference/environment-variables): All environment variables of the EUDIPLO backend, generated from its validation schema. The backend refuses to start when a value is invalid or a r... - [KMS Config (kms.json)](https://docs.eudiplo.dev/reference/kms-config): Fields of the global `/kms.json`, of a tenant's `//kms.json` and of the body of... - [Presentation Configuration](https://docs.eudiplo.dev/reference/presentation-configuration): Fields of a presentation configuration, as accepted by `POST /api/verifier/config` and in `config//presentation/.json`.... - [Supported Protocols](https://docs.eudiplo.dev/reference/protocols): Standards support matrix for issuance, presentation, credential formats, status and trust. - [Roles](https://docs.eudiplo.dev/reference/roles): The roles of the management API and the endpoints that accept them, generated from the backend's role enum and the `@Secured` decorators of its con... - [Session Outcome](https://docs.eudiplo.dev/reference/session-outcome): Statuses, result fields and failure codes of EUDIPLO sessions, as returned by `GET /api/session/{id}`, sent in SSE events and in webhooks. How to r... - [Wallet Compatibility](https://docs.eudiplo.dev/reference/wallet-compatibility): Wallets tested with EUDIPLO, their supported features and how to test a new wallet. - [Webhooks](https://docs.eudiplo.dev/reference/webhooks): Webhook payloads, configuration, authentication and delivery semantics. - [Concepts](https://docs.eudiplo.dev/concepts): How EUDIPLO is built, which entities it manages and how they relate. - [Issuance Under the Hood](https://docs.eudiplo.dev/concepts/issuance): How EUDIPLO runs an OID4VCI issuance, from the offer to the wallet notification. - [Presentation Under the Hood](https://docs.eudiplo.dev/concepts/presentation): How EUDIPLO creates an OID4VP request, receives the wallet response and verifies it. - [Security Model](https://docs.eudiplo.dev/concepts/security-model): Trust boundaries, tokens, proof of possession, attestation, keys and encryption in EUDIPLO. - [Sessions](https://docs.eudiplo.dev/concepts/sessions): Session states, single-use rules, OID4VP session binding and retention. - [Backend Architecture](https://docs.eudiplo.dev/contributing/backend-architecture): This page says where backend code goes, which boundaries the tests enforce, and how to add an endpoint, a migration, an environment variable or an ... - [CLI Development](https://docs.eudiplo.dev/contributing/cli): The CLI (`apps/cli`, package `@eudiplo/cli`) is built with Commander. Each command is a module directory whose `index.ts` declares the grammar and ... - [Client Development](https://docs.eudiplo.dev/contributing/client): The web client (`apps/client`, package `@eudiplo/client`) is an Angular application with standalone components and Angular Material. It talks to th... - [Code Quality](https://docs.eudiplo.dev/contributing/code-quality): Each package brings its own formatter and linter. The root scripts run them for every package: `pnpm format` writes, `pnpm format:check` only check... - [Configuration Schemas](https://docs.eudiplo.dev/contributing/configuration-schemas): Configuration files name their format in `$schema`, for example `https://eudiplo.dev/schemas/v4/PresentationConfigFile.schema.json`. This page expl... - [Development Setup](https://docs.eudiplo.dev/contributing/development-setup): This page gets the repository running from source: backend, web client and documentation. To run a released version instead, follow the Foundation ... - [Documentation](https://docs.eudiplo.dev/contributing/documentation): The documentation is a Docusaurus site in `apps/docs`; pages live in `apps/docs/docs/`. This page covers where content goes, which parts are genera... - [Contributing](https://docs.eudiplo.dev/contributing): This section is for people who change EUDIPLO itself. Pick the task below; the process rules (issues, pull requests, DCO sign-off, commit messages)... - [Releases & Versioning](https://docs.eudiplo.dev/contributing/releases): This page is for maintainers. Releases are created by semantic-release from the commit history of `main`; operators find the compatibility policy a... - [Testing](https://docs.eudiplo.dev/contributing/testing): All TypeScript packages test with Vitest. Run the unit tests of the package you change while you work, then the E2E suites when a change affects mo... - [Migrating from 6.x to 7.0](https://docs.eudiplo.dev/upgrade/6.x-to-7.0): This guide covers breaking changes introduced in EUDIPLO v7.0 and the required migration steps from any 6.x version. - [Migrating from 7.x to 8.0](https://docs.eudiplo.dev/upgrade/7.x-to-8.0): This guide covers the portable configuration format change introduced in EUDIPLO v8.0. Existing database records are not changed by this format mig... - [Upgrading from 8.x to 9.0](https://docs.eudiplo.dev/upgrade/8.x-to-9.0): EUDIPLO 9.0 tightens the OAuth, OID4VCI and OID4VP flows, enforces session expiry, limits sessions, credential status changes, key export and KMS c... - [Upgrading from 9.x to 10.0](https://docs.eudiplo.dev/upgrade/9.x-to-10.0): Each section below says what changed in EUDIPLO 10.0 and what to do; skip the sections that do not apply to you. - [Upgrade](https://docs.eudiplo.dev/upgrade): Minor and patch releases are drop-in: change the image tag and restart. A new major version can need changes to your configuration, integration or ... - [Logo and colors](https://docs.eudiplo.dev/brand): The EUDIPLO logo files and colors, for slides, articles and project listings that mention EUDIPLO. - [Who uses EUDIPLO](https://docs.eudiplo.dev/showcase): Projects and platforms that run EUDIPLO. - [Troubleshooting](https://docs.eudiplo.dev/troubleshooting): Find the symptom, then apply the fix. Each cookbook lists only the problems that are specific to its steps; everything else is collected here.