OpenID4VP verstehen: das Protokoll hinter den EU Digital Identity Wallets

Eine technische Tiefenanalyse von OpenID4VP, dem Protokoll, mit dem EUDI-Wallets verifizierte Attribute an Unternehmen übermitteln. Wie es funktioniert, warum es wichtig ist und wie OpenEUDI es implementiert.

eIDAS Pro Team
22. März 2026
12 Min. Lesezeit

Korrigiert am 20. Oktober 2026: In einer früheren Fassung hieß es, eine Anfrage nach age_over_18 offenbare nicht das Geburtsdatum – als enthielte der EUDI-PID dieses Attribut. Das tut er nicht: Aus dem PID erhält der Verifier das Geburtsdatum und leitet das Ja/Nein selbst ab; ein age_over_18 ohne Geburtsdatum gibt es nur im separaten Altersnachweis (Proof-of-Age-Attestation). Die Codebeispiele wurden zudem an die tatsächliche @openeudi-API angepasst. Außerdem haben wir korrigiert, wie eine Anfrage die gewünschten Daten benennt: OpenID4VP 1.0 nutzt DCQL (dcql_query); Presentation Exchange 2.0 gehörte nur zu früheren Entwürfen. Gestrichen haben wir die Aussage, OpenEUDI liefere ein Compliance-Mapping pro Land – das tut es nicht. Außerdem haben wir klargestellt, dass das Wallet – nicht das SDK des Verifiers – das WRPAC prüft.

Was ist OpenID4VP?

OpenID for Verifiable Presentations (OpenID4VP) ist das Protokoll, mit dem EU Digital Identity Wallets verifizierte Identitätsattribute an Unternehmen übermitteln, also an sogenannte Relying Parties. Es bildet das technische Rückgrat des eIDAS-2.0-Verifikationsablaufs.

Wenn ein Nutzer im Checkout einen QR-Code scannt und sein Wallet den signierten Nachweis zurückschickt, mit dem der Shop die Frage "ist diese Person über 18?" beantwortet, dann läuft dieser Austausch über OpenID4VP.

Der Verifikationsablauf

Der OpenID4VP-Ablauf umfasst vier Akteure:

  1. Issuer: die staatliche oder vertrauenswürdige Stelle, die den Nachweis ausgestellt hat (z. B. der österreichische Staat für einen Identitätsnachweis)
  2. Holder: die Bürgerin oder der Bürger mit dem EUDI-Wallet auf dem Smartphone
  3. Verifier (Relying Party): das Unternehmen, das die Verifikation anfordert (Ihr Shop, Ihr KYC-System usw.)
  4. Trust Framework: die EU Trusted Lists, die festlegen, welche Aussteller und Verifier legitim sind

Der Ablauf Schritt für Schritt

1. Der Verifier erstellt eine Authorization Request
   ↓
2. Die Anfrage wird in einen QR-Code (oder Deep Link) kodiert
   ↓
3. Der Holder scannt den QR-Code mit dem EUDI-Wallet
   ↓
4. Das Wallet interpretiert die Anfrage und zeigt an, was angefordert wird
   ↓
5. Der Holder prüft und bestätigt mit Biometrie/PIN
   ↓
6. Das Wallet erzeugt eine Verifiable Presentation (VP)
   ↓
7. Die VP wird an den Response-Endpunkt des Verifiers gesendet
   ↓
8. Der Verifier validiert die VP kryptografisch
   ↓
9. Die verifizierten Attribute werden extrahiert und verwendet

Zwei Nachweisformate

EUDI-Wallets unterstützen zwei Credential-Formate, jeweils mit eigenem kryptografischem Prüfpfad:

SD-JWT VC (Selective Disclosure JWT)

Wird für Remote-Verifikationsabläufe verwendet (online, geräteübergreifend). Das Credential ist ein JSON Web Token mit selektiver Offenlegung.

  • Format: JSON-basiert
  • Selective Disclosure: hashbasiertes Salting; der Aussteller signiert alle Claims, der Holder kann aber nur einzelne offenlegen
  • Signatur: JWS (JSON Web Signature) mit ES256
  • Verifikation: JWT parsen -> Disclosures rekonstruieren -> Hashes prüfen -> Signatur validieren -> Vertrauenskette des Ausstellers prüfen
Header.Payload.Signature~Disclosure1~Disclosure2~KeyBindingJWT

mdoc / mDL (Mobile Document)

Wird für Proximity-Abläufe verwendet (vor Ort, NFC, BLE). Es basiert auf ISO 18013-5.

  • Format: CBOR-basiert (binär)
  • Selective Disclosure: in die Datenstruktur eingebaut, mit Namespaces und Datenelementen
  • Signatur: COSE (CBOR Object Signing and Encryption)
  • Verifikation: CBOR dekodieren -> COSE-Signatur prüfen -> Geräteauthentisierung validieren -> Zertifikatskette des Ausstellers prüfen

Beide Formate erreichen das gleiche Ziel: kryptografisch nachweisen, dass ein vertrauenswürdiger Aussteller bestimmte Aussagen über den Holder attestiert hat, allerdings über grundlegend unterschiedliche technische Wege.

Attribute anfragen: DCQL

Die Authorization Request teilt dem Wallet genau mit, welches Credential und welche Claims der Verifier haben möchte. OpenID4VP 1.0 drückt das mit der Digital Credentials Query Language (DCQL) aus, übermittelt im Parameter dcql_query. (Frühere Entwürfe von OpenID4VP nutzten stattdessen DIF Presentation Exchange 2.0 und ein presentation_definition-Objekt; Version 1.0 hat es durch DCQL ersetzt.)

Eine Altersprüfung gegen den PID im Format SD-JWT VC fragt einen einzigen Claim an – das Geburtsdatum:

{ "credentials": [{ "id": "pid", "format": "dc+sd-jwt",
    "meta": { "vct_values": ["urn:eudi:pid:1"] },
    "claims": [{ "path": ["birthdate"] }] }] }

Dieselbe Anfrage an den mdoc-PID nutzt den Namespace eu.europa.ec.eudi.pid.1 und das Element birth_date. DCQL kann auch Alternativen anbieten: Mit credential_sets fragt ein Verifier nach „Altersnachweis oder PID“, und das Wallet liefert eines von beiden.

WRPAC: das Zertifikat des Verifiers

Um eine Verifikationsanfrage stellen zu können, benötigt die Relying Party ein WRPAC (Wallet Relying Party Access Certificate). Dieses Zertifikat, definiert in ETSI TS 119 475:

  • identifiziert die Relying Party gegenüber dem Wallet
  • legt fest, welche Attribute die RP anfordern darf
  • wird von einem qualifizierten Vertrauensdiensteanbieter ausgestellt
  • muss gegen die EU Trusted Lists validiert werden

Das Wallet prüft das WRPAC, bevor es den Consent-Screen anzeigt. Ist das Zertifikat ungültig, abgelaufen oder nicht in der Trust List enthalten, verweigert das Wallet die Anfrage.

EU Trusted Lists

Die EU betreibt eine hierarchische Vertrauensinfrastruktur:

EU List of Trusted Lists (LOTL)
  └── Country Trusted List (z. B. Luxembourg)
       └── Trust Service Provider (z. B. LuxTrust)
            └── Trust Service (z. B. WRPAC-Ausstellung)
                 └── Certificate (Ihr WRPAC)

Diese Hierarchie durchläuft das Wallet, um zu prüfen, dass ein WRPAC von einem legitimen Anbieter in einem anerkannten Mitgliedstaat ausgestellt wurde. Auf Verifier-Seite erledigt das SDK die spiegelbildliche Aufgabe: Es prüft, dass der empfangene Nachweis von einem Aussteller signiert wurde, dessen Zertifikat zu einem Vertrauensanker aus einer veröffentlichten Liste führt (bei PIDs der Liste der PID-Anbieter). Das ist einer der komplexesten Teile der Implementierung: Das Trust-List-Format (XML/JSON) hat eigene Parsing-Anforderungen, und jede Mitgliedstaatenliste wird unabhängig aktualisiert.

Datenschutz durch Technikgestaltung

OpenID4VP setzt Datenschutz auf Protokollebene durch:

  • Selective Disclosure: Der Holder wählt exakt aus, welche Attribute geteilt werden. Eine Altersprüfung über den PID legt nur das Geburtsdatum offen – nicht Name, Adresse oder Dokumentnummer –, und der Verifier reduziert es auf ein Ja/Nein. Ein age_over_18 ohne Geburtsdatum gibt es nur im separaten Altersnachweis (eu.europa.ec.av.1), nicht im PID.
  • Keine Korrelation: Jede Verifizierungssitzung nutzt frisches kryptografisches Material, sodass Verifier Sitzungen nicht miteinander verknüpfen können.
  • Einwilligung des Holders: Jede Attributanfrage verlangt eine explizite Zustimmung auf dem Gerät.
  • Datenminimierung: Das Protokoll fördert die Beschränkung auf das Notwendige. Das Wallet macht zu weitgehende Anfragen für Nutzer sichtbar.

Das unterscheidet sich grundlegend vom klassischen KYC, bei dem Unternehmen häufig mehr Daten erhalten und speichern, als sie tatsächlich brauchen.

Wie OpenEUDI das umsetzt

Das OpenEUDI SDK ist in Schichten aufgebaut. Das Paket @openeudi/openid4vp implementiert Credential-Parsing über eine einfache API: parsePresentation(vpToken, options) erkennt automatisch das Credential-Format (SD-JWT VC oder mDOC), validiert kryptografische Signaturen und gibt verifizierte Claims zurück.

import { parsePresentation } from '@openeudi/openid4vp';

// Behandelt SD-JWT VC und mDOC automatisch
const result = await parsePresentation(vpToken, {
  nonce,               // die Nonce aus Ihrer Authorization Request
  trustedCertificates, // Vertrauensanker der Aussteller (DER), z. B. aus den EU Trusted Lists
});
// result.valid  — Signatur-, Key-Binding- und Vertrauensprüfung bestanden
// result.format — 'sd-jwt-vc' | 'mdoc'
// result.claims — verifizierte, selektiv offengelegte Attribute (z. B. das Geburtsdatum aus dem PID)

Der höher angesiedelte VerificationService baut darauf auf und verwaltet den vollständigen Sitzungslebenszyklus:

import { VerificationService, VerificationType } from '@openeudi/core';
import type { IVerificationMode } from '@openeudi/core';

// @openeudi/core liefert DemoMode und MockMode. Für echte Wallets brauchen Sie
// einen eigenen IVerificationMode: Er baut die OpenID4VP-Anfrage (signiert mit
// Ihrem WRPAC) und prüft die Antwort mit @openeudi/openid4vp.
declare const productionMode: IVerificationMode;

const service = new VerificationService({ mode: productionMode });

const session = await service.createSession({ type: VerificationType.AGE });
// session.walletUrl — als QR-Code oder Deep Link darstellen

service.on('session:verified', (session, result) => {
  // result.ageVerified — ein abgeleiteter Boolean; das Geburtsdatum ist nicht Teil des Ergebnisses
});

Intern übernehmen der Service und sein Verifikationsmodus:

  1. Aufbau einer spezifikationskonformen Authorization Request
  2. Kodierung in einen QR-Code (generateQRCode aus @openeudi/core/qr)
  3. Entgegennahme der VP des Wallets über service.handleCallback(), aufgerufen aus Ihrem Response-Endpunkt
  4. Validierung der VP über @openeudi/openid4vp (SD-JWT VC oder mdoc)
  5. Prüfung des Ausstellerzertifikats gegen die EU Trusted Lists
  6. Reduktion der offengelegten Claims auf das Prüfergebnis (ageVerified, countryVerified) – ein Geburtsdatum dient nur der Prüfung und wird nicht zurückgegeben
  7. Ablauf von Sitzungen nach ihrer TTL (standardmäßig fünf Minuten)

All das steckt hinter service.createSession(), service.handleCallback() und dem Event session:verified.

Grenzüberschreitende Compliance

Jeder EU-Mitgliedstaat hat einen gewissen Ermessensspielraum, welche Attribute wann und unter welchen Bedingungen angefragt werden dürfen. Zum Beispiel:

  • Altersgrenzen unterscheiden sich nach Produktkategorie und Land
  • einige Länder beschränken bestimmte Attributfreigaben
  • nationale Wallet-Implementierungen nutzen unterschiedliche Credential-Schemata

Prüfen Sie vor einer Anfrage, was das Credential tatsächlich enthält: In jedem PID sind birth_date und nationality Pflicht, resident_country dagegen optional und kann fehlen.

Wie es mit dem Protokoll weitergeht

OpenID4VP 1.0 ist eine finale Spezifikation der OpenID Foundation, und DCQL ist ihre Abfragesprache – Presentation Exchange gehört nicht dazu. Die Arbeit findet jetzt rund um das Kernprotokoll statt:

  • Credential-Status: Prüfung, ob ein Credential widerrufen wurde
  • Verbesserte Cross-Device-Abläufe: bessere UX für die Verifikation zwischen Smartphone und Desktop
  • Alternativen in einer Anfrage: DCQL-credential_sets, etwa „Altersnachweis oder PID“

OpenEUDI liefert Protokolländerungen als neue Versionen seiner npm-Pakete aus.


OpenEUDI implementiert OpenID4VP für das EUDI-Wallet-Ökosystem. Das SDK steht unter der Apache-2.0-Lizenz und kostenlos nutzbar. Für den Produktivbetrieb mit verwalteten WRPAC-Zertifikaten sehen Sie sich die Managed-Pläne von eIDAS Pro an.

Verwandte Artikel

Diesen Artikel teilen

Helfen Sie anderen, mehr über eIDAS-Verifizierung zu erfahren

Verwandte Artikel

Technik

eu.europa.ec.av.1 erklärt: Wie ein Verifier einen EU-Altersnachweis gegen die Trusted List validiert

Die EU-Altersverifikations-App übergibt Ihrem Dienst einen signierten Boolean im Namespace eu.europa.ec.av.1 – doch ein Boolean ist nur so vertrauenswürdig wie die Stelle, die ihn signiert hat. Hier steht, was dieser Namespace enthält und wie ein Verifier mithilfe der Age Verification Trusted List nachweist, dass die Bescheinigung echt ist.

8 Min. Lesezeit
Technik

Altersnachweis gegen die EU Trusted List validieren: Der Schritt, den alle überspringen

Eine Altersnachweis-Bescheinigung zu empfangen ist nicht dasselbe, wie ihr zu vertrauen. Die EU-Verifier-Leitlinie verlangt, dass Sie jeden Altersnachweis vor der Zugriffsgewährung gegen die Age Verification Trusted List validieren. Die Kommission hostet bereits eine Testliste in der ACC-Umgebung des eIDAS Dashboards – und es ist nicht dieselbe Liste wie die WRPAC-Anbieterliste.

9 Min. Lesezeit
Technik

Integration des EU-Altersnachweises: Ein Entwicklerleitfaden zum Namespace eu.europa.ec.av.1

Der EU-Aussteller für Altersverifikation stellt eine „Proof of Age“-Bescheinigung im mso_mdoc-Format unter dem Namespace eu.europa.ec.av.1 über OpenID4VCI aus. Hier erfahren Sie, was dieser Namespace tatsächlich enthält, wie die Ausstellung funktioniert und wie Sie Ihre Integration auf den Live-Referenz-Aussteller richten – mit dem Vorbehalt, dass es sich um eine Referenz handelt, nicht um einen Produktions-Endpunkt.

11 Min. Lesezeit