OpenEUDI SDK gyorsindító: az első ellenőrzése 5 perc alatt

Lépésről lépésre bemutató az OpenEUDI SDK telepítéséhez, egy ellenőrzési munkamenet létrehozásához és az eredmény kezeléséhez, mindez 5 percen belül DEMO módban.

Az eIDAS Pro csapata
2026. március 24.
6 perc olvasás

Javítva 2026. október 20-án: a bejegyzés korábbi változata age_over_18-típusú attribútumokat sorolt fel, és azt állította, hogy a tárca a születési dátum felfedése nélkül bizonyítja a logikai értéket. Az EUDI PID-ben nincs életkor-attribútum: az ellenőrző a születési dátumot kéri el, és maga vezeti le belőle az igen/nem választ. A kódpéldák mostantól a közzétett @openeudi/core API-t követik.

Előfeltételek

  • Telepített Node.js 20+
  • TypeScript-projekt (vagy JavaScript ESM-mel)
  • Terminál és a kedvenc szerkesztője

Ennyi. Nincs API-kulcs, nincs regisztráció, nincs WRPAC-tanúsítvány. A DEMO mód azonnal működik.

1. lépés: telepítés

npm install @openeudi/core

Vagy a kívánt csomagkezelővel:

pnpm add @openeudi/core
yarn add @openeudi/core

2. lépés: ellenőrző létrehozása

import { VerificationService, DemoMode, InMemorySessionStore } from '@openeudi/core';

// Inicializálás DEMO módban — nem kell hitelesítő adat
const service = new VerificationService({
  mode: new DemoMode(),
  store: new InMemorySessionStore(), // opcionális: ez az alapértelmezett tároló
});

A mode opció szabályozza az SDK működését:

MódViselkedésFelhasználási eset
new DemoMode()3 másodperc után automatikusan befejeződik (a delayMs opcióval módosítható)Bemutatók, értékesítési demók, landing oldalak
new MockMode()Szimulált tárcaválaszok konfigurálható adatokkalIntegrációs tesztek, CI/CD pipeline-ok
Saját IVerificationModeValódi EUDI Tárca-ellenőrzés (OpenID4VP a @openeudi/openid4vp csomaggal)Éles ellenőrzések (WRPAC kell)

3. lépés: ellenőrzési munkamenet létrehozása

import { VerificationType } from '@openeudi/core';

const session = await service.createSession({ type: VerificationType.AGE });

// session.id a munkamenet egyedi azonosítója
// session.walletUrl az OpenID4VP-link: QR-kódba kódolható, vagy mobilon megnyitható
// session.expiresAt a munkamenet lejárati ideje (alapértelmezés: 5 perc)

A type mező mondja meg, mit szeretne ellenőrizni. Az eIDAS Pro adatvédelem-központú logikai eredményekre épül: a kódja igen/nem választ kap, nyers személyes adatot soha.

TípusEredménymezőkLeírás
VerificationType.AGEageVerifiedBetöltötte-e a felhasználó a 18. életévét?
VerificationType.COUNTRYcountry, countryVerifiedEngedélyezett-e a felhasználó országa?
VerificationType.BOTHA fentiek mindegyikeÉletkor és ország egy munkamenetben

Az országszintű megfelelőséget (mely országok engedélyezettek) munkamenetenként a countryWhitelist vagy a countryBlacklist mezővel adhatja meg (a kettőt együtt nem). Az SDK a hitelesítő adatban szereplő országot veti össze a listával, és a countryVerified mezőben adja vissza az eredményt.

Megjegyzés: DEMO módban az eredmények szintetikusak. Valódi tárcával az életkorra adott válasz levezetett: az EUDI PID-ben nincs age_over_18 attribútum, ezért az ellenőrző csak a születési dátumot kéri el (szelektív közzététel), kiszámolja a 18 éves küszöböt, és csak az ageVerified értéket tartja meg. Születési dátum nélküli igen/nem válaszhoz a külön életkor-igazolás (proof-of-age attestation, eu.europa.ec.av.1) kell, amelyet élesben egyelőre csak Dánia bocsát ki.

4. lépés: a QR-kód megjelenítése

A munkamenet walletUrl értékéből QR-kód készül, amelyet a felhasználó az EUDI Tárca alkalmazásával beszkennel.

// Az opcionális peer dependency kell hozzá: npm install qrcode
import { generateQRCode } from '@openeudi/core/qr';

const qrCodeUrl = await generateQRCode(session.walletUrl); // base64 PNG data URL

// Webes környezetben
const img = document.createElement('img');
img.src = qrCodeUrl;
document.getElementById('qr-container').appendChild(img);

// React-ben
function VerificationQR({ qrCodeUrl }) {
  return <img src={qrCodeUrl} alt="Scan with your EUDI Wallet" />;
}

// Next.js-ben (next/image használatával)
import Image from 'next/image';
function VerificationQR({ qrCodeUrl }) {
  return <Image src={qrCodeUrl} alt="Scan with your EUDI Wallet" width={256} height={256} />;
}

5. lépés: várakozás az eredményre

// Eseményalapú API (webalkalmazásokhoz ajánlott)
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');
});

// A lejáratot egy takarító futás észleli, ezért futtassa rendszeresen
setInterval(() => service.cleanupExpired(), 60_000);

Vagy kérdezze le a munkamenet állapotát, amikor szüksége van rá:

import { VerificationStatus } from '@openeudi/core';

const current = await service.getSession(session.id);
if (current.status === VerificationStatus.VERIFIED) {
  console.log('Age verified:', current.result.ageVerified);
}

Teljes példa: Express.js API útvonal

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(),
});

// Új ellenőrzési munkamenet létrehozása
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),
  });
});

// Munkamenet állapotának lekérdezése (vagy SSE valós idejű frissítéshez)
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 végpont valós idejű frissítésekhez
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;

  // Az események minden munkamenetre lefutnak, ezért szűrjön arra, amelyet ez a kliens figyel
  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'));

Mi történik DEMO módban?

Amikor ezt a kódot DEMO módban futtatja:

  1. létrejön egy QR-kód, amely vizuálisan megegyezik az éles változattal
  2. 3 másodperc után a munkamenet automatikusan befejeződik
  3. szintetikus eredmény érkezik vissza (verified: true, ageVerified: true)
  4. a session:verified eseményfigyelő megkapja az eredményt

Valódi tárca nem vesz részt a folyamatban. Így az EUDI Tárcák indulása előtt felépítheti és letesztelheti a teljes UI- és backendfolyamatot.

Következő lépések

  • Váltson MOCK módra, ha konfigurálható válaszokat szeretne tesztelni (alapértelmezett eredmény, vagy munkamenetenkénti felülírás a setSessionResult() hívással)
  • Adja hozzá a WooCommerce plugint a WordPress-áruházához a pénztári ellenőrzéshez
  • Olvassa el az API referenciát a haladó konfigurációhoz (munkamenet-élettartam, saját munkamenet-tárolók, hibakezelés)
  • Csatlakozzon a GitHub-beszélgetésekhez, ha hibát jelentene vagy funkciót kérne

Amikor az EUDI Tárcák elindulnak, a new DemoMode() helyére tegyen egy éles IVerificationMode implementációt, amely a @openeudi/openid4vp csomagra és a WRPAC-hoz tartozó hitelesítő adatokra épül, vagy használja az eIDAS Pro menedzselt szolgáltatását, hogy ne kelljen tanúsítványkezeléssel foglalkoznia.


Az OpenEUDI Apache-2.0 licencű, és elérhető az npm-en; jelölje be a https://github.com/openeudi tárhelyet, hogy értesüljön az új kiadásokról.

Kapcsolódó cikkek

Cikk megosztása

Segítsen másoknak megismerni az eIDAS-ellenőrzést

Kapcsolódó cikkek

Technikai

Az eu.europa.ec.av.1 magyarázata: hogyan validál egy verifier egy EU-s életkor-igazolást a megbízhatósági listával szemben

Az EU életkor-ellenőrző alkalmazása egy aláírt logikai értéket ad át a szolgáltatásodnak az eu.europa.ec.av.1 névtérben — de egy logikai érték csak annyira megbízható, amennyire az, aki aláírta. Mutatjuk, mit tartalmaz ez a névtér, és hogyan bizonyítja egy verifier az Age Verification Trusted List segítségével, hogy a tanúsítvány valódi.

8 perc olvasás
Technikai

Az életkor-igazolás validálása az EU megbízhatósági listájával szemben: a lépés, amelyet mindenki kihagy

Egy életkor-igazoló tanúsítvány fogadása nem ugyanaz, mint megbízni benne. Az EU verifier-útmutatója megköveteli, hogy minden életkori bizonyítékot validálj az Age Verification Trusted Listtel szemben, mielőtt hozzáférést adsz. A Bizottság már most hosztol egy tesztlistát az eIDAS Dashboard ACC-környezetében — és ez nem ugyanaz a lista, mint a WRPAC-szolgáltatói lista.

9 perc olvasás
Technikai

Az EU életkor-igazoló tanúsítvány integrálása: fejlesztői útmutató az eu.europa.ec.av.1 névtérhez

Az EU életkor-ellenőrzési kibocsátója egy „életkor-igazolás” (Proof of Age) tanúsítványt bocsát ki mso_mdoc formátumban, az eu.europa.ec.av.1 névtér alatt, OpenID4VCI fölött. Íme, mit tartalmaz valójában ez a névtér, hogyan működik a kibocsátás, és hogyan irányítsd az integrációdat az élő referencia-kibocsátóra — azzal a kikötéssel, hogy ez egy referencia, nem éles végpont.

11 perc olvasás