Korrigiert am 20. Oktober 2026: In einer früheren Fassung hieß es, eine Anfrage nach
age_over_18offenbare 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; einage_over_18ohne 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:
- Issuer: die staatliche oder vertrauenswürdige Stelle, die den Nachweis ausgestellt hat (z. B. der österreichische Staat für einen Identitätsnachweis)
- Holder: die Bürgerin oder der Bürger mit dem EUDI-Wallet auf dem Smartphone
- Verifier (Relying Party): das Unternehmen, das die Verifikation anfordert (Ihr Shop, Ihr KYC-System usw.)
- 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_18ohne 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:
- Aufbau einer spezifikationskonformen Authorization Request
- Kodierung in einen QR-Code (
generateQRCodeaus@openeudi/core/qr) - Entgegennahme der VP des Wallets über
service.handleCallback(), aufgerufen aus Ihrem Response-Endpunkt - Validierung der VP über
@openeudi/openid4vp(SD-JWT VC oder mdoc) - Prüfung des Ausstellerzertifikats gegen die EU Trusted Lists
- Reduktion der offengelegten Claims auf das Prüfergebnis (
ageVerified,countryVerified) – ein Geburtsdatum dient nur der Prüfung und wird nicht zurückgegeben - 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
OpenEUDI-SDK-Schnellstart: Ihre erste Verifizierung in 5 Minuten
Eine Schritt-für-Schritt-Anleitung, um das OpenEUDI SDK zu installieren, eine Verifizierungssitzung zu erstellen und das Ergebnis zu verarbeiten - alles in weniger als 5 Minuten im DEMO-Modus.
6 Min. Lesezeit
Wie die eIDAS-Verifizierung funktioniert: eine technische Tiefenanalyse
Eine umfassende technische Aufschlüsselung des eIDAS-Verifizierungsablaufs – von der QR-Code-Erzeugung bis zur Attributvalidierung, inklusive Protokollen, Sicherheitsmaßnahmen und Integrationsmustern.
12 Min. Lesezeit
Diesen Artikel teilen
Helfen Sie anderen, mehr über eIDAS-Verifizierung zu erfahren