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/coreAPI-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ód | Viselkedés | Felhaszná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ó adatokkal | Integrációs tesztek, CI/CD pipeline-ok |
Saját IVerificationMode | Való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ípus | Eredménymezők | Leírás |
|---|---|---|
VerificationType.AGE | ageVerified | Betöltötte-e a felhasználó a 18. életévét? |
VerificationType.COUNTRY | country, countryVerified | Engedélyezett-e a felhasználó országa? |
VerificationType.BOTH | A 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:
- létrejön egy QR-kód, amely vizuálisan megegyezik az éles változattal
- 3 másodperc után a munkamenet automatikusan befejeződik
- szintetikus eredmény érkezik vissza (
verified: true,ageVerified: true) - a
session:verifiedesemé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
Bemutatkozik az OpenEUDI: nyílt forráskódú SDK az EU digitális személyazonosság-ellenőrzéséhez
Nyílt forráskódúvá tesszük azt a központi protokollkönyvtárat, amely az eIDAS Prót működteti. Az OpenEUDI egy ingyenes, Apache-2.0 licencű TypeScript SDK az EUDI Tárca-ellenőrzés bármely webalkalmazásba történő integrálásához.
8 perc olvasás
Az OpenID4VP megértése: az EU digitális személyazonosság-tárcái mögötti protokoll
Műszaki mélyelemzés az OpenID4VP-ről, arról a protokollról, amelyet az EUDI Tárcák használnak ellenőrzött attribútumok megosztására a vállalkozásokkal. Hogyan működik, miért fontos, és hogyan valósítja meg az OpenEUDI.
12 perc olvasás
Cikk megosztása
Segítsen másoknak megismerni az eIDAS-ellenőrzést