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.

eIDAS Pro Team
24. März 2026
6 Min. Lesezeit

Korrigiert am 20. Oktober 2026: Eine frühere Fassung dieses Beitrags listete Attribute wie age_over_18 auf 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:

ModusVerhaltenAnwendungsfall
new DemoMode()Schließt nach 3 Sekunden automatisch ab (änderbar mit delayMs)Showcases, Vertrieb-Demos, Landingpages
new MockMode()Simuliert Wallet-Antworten mit konfigurierbaren DatenIntegrationstests, CI/CD-Pipelines
Eigene IVerificationMode-ImplementierungReale 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.

TypErgebnisfelderBeschreibung
VerificationType.AGEageVerifiedIst der Nutzer 18 oder älter?
VerificationType.COUNTRYcountry, countryVerifiedIst das Land des Nutzers erlaubt?
VerificationType.BOTHAlle oben genanntenAlter 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:

  1. wird ein QR-Code erzeugt, der optisch wie ein echter aussieht
  2. wird die Sitzung nach 3 Sekunden automatisch abgeschlossen
  3. wird ein synthetisches Ergebnis zurückgegeben (verified: true, ageVerified: true)
  4. 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

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