Korrigiert am 20. Oktober 2026: Eine frühere Fassung dieses Beitrags listete Attribute wie
age_over_18auf und behauptete, das Wallet beweise den Bool-Wert, ohne das Geburtsdatum preiszugeben. Die EUDI-PID enthält kein Altersattribut: Der Verifier fordert das Geburtsdatum an und leitet das Ja/Nein selbst ab. Außerdem entsprechen die Codebeispiele jetzt der veröffentlichten API von@openeudi/core.
Voraussetzungen
- Node.js 20+ installiert
- TypeScript-Projekt (oder JavaScript mit ESM)
- Ein Terminal und Ihr bevorzugter Editor
Das ist alles. Keine API-Schlüssel, keine Registrierung, kein WRPAC-Zertifikat. Der DEMO-Modus funktioniert sofort.
Schritt 1: installieren
npm install @openeudi/core
Oder mit Ihrem bevorzugten Paketmanager:
pnpm add @openeudi/core
yarn add @openeudi/core
Schritt 2: einen Verifier erstellen
import { VerificationService, DemoMode, InMemorySessionStore } from '@openeudi/core';
// Im DEMO-Modus initialisieren — keine Zugangsdaten nötig
const service = new VerificationService({
mode: new DemoMode(),
store: new InMemorySessionStore(), // optional: das ist der Standard-Store
});
Der mode-Parameter steuert das Verhalten des SDK:
| Modus | Verhalten | Anwendungsfall |
|---|---|---|
new DemoMode() | Schließt nach 3 Sekunden automatisch ab (änderbar mit delayMs) | Showcases, Vertrieb-Demos, Landingpages |
new MockMode() | Simuliert Wallet-Antworten mit konfigurierbaren Daten | Integrationstests, CI/CD-Pipelines |
Eigene IVerificationMode-Implementierung | Reale EUDI-Wallet-Verifikation (OpenID4VP über @openeudi/openid4vp) | Live-Verifikationen (erfordert WRPAC) |
Schritt 3: eine Verifizierungssitzung erstellen
import { VerificationType } from '@openeudi/core';
const session = await service.createSession({ type: VerificationType.AGE });
// session.id ist die eindeutige Sitzungs-ID
// session.walletUrl ist der OpenID4VP-Link: als QR-Code kodieren oder mobil öffnen
// session.expiresAt ist der Ablaufzeitpunkt der Sitzung (Standard: 5 Minuten)
Das Feld type legt fest, was Sie verifizieren möchten. Das Design ist auf datenschutzorientierte boolesche Ergebnisse ausgelegt: Ihr Code bekommt eine Ja/Nein-Antwort, niemals rohe personenbezogene Daten.
| Typ | Ergebnisfelder | Beschreibung |
|---|---|---|
VerificationType.AGE | ageVerified | Ist der Nutzer 18 oder älter? |
VerificationType.COUNTRY | country, countryVerified | Ist das Land des Nutzers erlaubt? |
VerificationType.BOTH | Alle oben genannten | Alter und Land in einer Sitzung |
Länderspezifische Regeln (welche Länder erlaubt sind) legen Sie pro Sitzung mit countryWhitelist oder countryBlacklist fest (nicht beides). Das SDK gleicht das Land aus dem Nachweis mit dieser Liste ab und liefert countryVerified.
Hinweis: Im DEMO-Modus sind die Ergebnisse synthetisch. Mit einem echten Wallet wird die Altersantwort abgeleitet: Die EUDI-PID enthält kein Attribut age_over_18. Der Verifier fordert deshalb nur das Geburtsdatum an (selektive Offenlegung), prüft die 18-Jahres-Grenze und behält nur ageVerified. Ein Ja/Nein ganz ohne Geburtsdatum erfordert den separaten Altersnachweis (Proof-of-Age-Attestation, eu.europa.ec.av.1), den produktiv bisher nur Dänemark ausstellt.
Schritt 4: den QR-Code anzeigen
Aus der walletUrl der Sitzung wird ein QR-Code, den der Nutzer mit seiner EUDI-Wallet-App scannt.
// Erfordert die optionale Peer-Dependency: npm install qrcode
import { generateQRCode } from '@openeudi/core/qr';
const qrCodeUrl = await generateQRCode(session.walletUrl); // Base64-PNG-Data-URL
// Im Web-Kontext
const img = document.createElement('img');
img.src = qrCodeUrl;
document.getElementById('qr-container').appendChild(img);
// In React
function VerificationQR({ qrCodeUrl }) {
return <img src={qrCodeUrl} alt="Scan with your EUDI Wallet" />;
}
// In Next.js (mit next/image)
import Image from 'next/image';
function VerificationQR({ qrCodeUrl }) {
return <Image src={qrCodeUrl} alt="Scan with your EUDI Wallet" width={256} height={256} />;
}
Schritt 5: auf das Ergebnis warten
// Event-basierte API (für Web-Apps empfohlen)
service.on('session:verified', (session, result) => {
console.log('Verification successful!');
console.log('Verified:', result.verified); // true
console.log('Age verified:', result.ageVerified); // true
console.log('Session ID:', session.id);
console.log('Timestamp:', session.completedAt);
});
service.on('session:rejected', (session, reason) => {
console.log('Verification rejected:', reason);
});
service.on('session:expired', (session) => {
console.log('Session expired — generate a new QR code');
});
// Abgelaufene Sitzungen erkennt ein Sweep, also regelmäßig ausführen
setInterval(() => service.cleanupExpired(), 60_000);
Oder fragen Sie den Sitzungsstatus bei Bedarf ab:
import { VerificationStatus } from '@openeudi/core';
const current = await service.getSession(session.id);
if (current.status === VerificationStatus.VERIFIED) {
console.log('Age verified:', current.result.ageVerified);
}
Vollständiges Beispiel: Express.js-API-Route
import express from 'express';
import { VerificationService, DemoMode, InMemorySessionStore, VerificationType } from '@openeudi/core';
import type { CompletedSession, VerificationResult } from '@openeudi/core';
import { generateQRCode } from '@openeudi/core/qr';
const app = express();
const service = new VerificationService({
mode: new DemoMode(),
store: new InMemorySessionStore(),
});
// Neue Verifizierungssitzung erstellen
app.post('/api/verify', async (req, res) => {
const session = await service.createSession({ type: VerificationType.AGE });
res.json({
sessionId: session.id,
qrCodeUrl: await generateQRCode(session.walletUrl),
});
});
// Sitzungsstatus abrufen (oder SSE für Echtzeit nutzen)
app.get('/api/verify/:sessionId', async (req, res) => {
const session = await service.getSession(req.params.sessionId);
res.json({ status: session.status, result: 'result' in session ? session.result : null });
});
// SSE-Endpunkt für Echtzeit-Updates
app.get('/api/verify/:sessionId/events', (req, res) => {
res.setHeader('Content-Type', 'text/event-stream');
res.setHeader('Cache-Control', 'no-cache');
res.setHeader('Connection', 'keep-alive');
const { sessionId } = req.params;
// Events feuern für jede Sitzung, also auf die Sitzung dieses Clients filtern
const onVerified = (session: CompletedSession, result: VerificationResult) => {
if (session.id !== sessionId) return;
res.write(`data: ${JSON.stringify({ type: 'verified', result })}\n\n`);
res.end();
};
const onRejected = (session: CompletedSession, reason: string) => {
if (session.id !== sessionId) return;
res.write(`data: ${JSON.stringify({ type: 'rejected', reason })}\n\n`);
res.end();
};
service.on('session:verified', onVerified);
service.on('session:rejected', onRejected);
req.on('close', () => {
service.off('session:verified', onVerified);
service.off('session:rejected', onRejected);
});
});
app.listen(3000, () => console.log('Server running on port 3000'));
Was passiert im DEMO-Modus?
Wenn Sie diesen Code im DEMO-Modus ausführen:
- wird ein QR-Code erzeugt, der optisch wie ein echter aussieht
- wird die Sitzung nach 3 Sekunden automatisch abgeschlossen
- wird ein synthetisches Ergebnis zurückgegeben (
verified: true,ageVerified: true) - wird Ihr
session:verified-Listener mit dem Ergebnis ausgelöst
Es ist kein echtes Wallet beteiligt. So können Sie die gesamte UI- und Backend-Logik bauen und testen, bevor EUDI-Wallets produktiv starten.
Nächste Schritte
- Wechseln Sie in den MOCK-Modus, um konfigurierbare Antworten zu testen (ein Standardergebnis oder Überschreibungen pro Sitzung mit
setSessionResult()) - Fügen Sie das WooCommerce-Plugin hinzu, um Checkout-Verifikationen in Ihrem WordPress-Shop umzusetzen
- Lesen Sie die API-Referenz für erweiterte Konfigurationen (Sitzungs-TTL, eigene Session-Stores, Fehlerbehandlung)
- Beteiligen Sie sich an den GitHub-Diskussionen, um Bugs zu melden oder Funktionen anzufragen
Wenn die EUDI-Wallets produktiv starten, ersetzen Sie new DemoMode() durch einen produktiven IVerificationMode auf Basis von @openeudi/openid4vp und Ihren WRPAC-Credentials - oder Sie nutzen den Managed Service von eIDAS Pro und sparen sich das Zertifikatsmanagement.
OpenEUDI steht unter der Apache-2.0-Lizenz und ist auf npm veröffentlicht - geben Sie dem GitHub-Repository unter https://github.com/openeudi einen Stern, um über neue Releases informiert zu werden.
Verwandte Artikel
OpenEUDI vorgestellt: ein Open-Source-SDK für EU-Digitalidentitäts-Verifikation
Wir veröffentlichen die zentrale Protokollbibliothek hinter eIDAS Pro als Open Source. OpenEUDI ist ein kostenloses TypeScript-SDK unter Apache-2.0-Lizenz für die Integration von EUDI-Wallet-Verifikation in jede Webanwendung.
8 Min. Lesezeit
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.
12 Min. Lesezeit
Diesen Artikel teilen
Helfen Sie anderen, mehr über eIDAS-Verifizierung zu erfahren