Javítva 2026. október 20-án: a bejegyzés korábbi változata azt állította, hogy az
age_over_18kérése nem fedi fel a születési dátumot, mintha az EUDI PID tartalmazná ezt az attribútumot. Nem tartalmazza: a PID-ből az ellenőrző a születési dátumot kapja meg, és maga képezi belőle az igen/nem választ; születési dátum nélküliage_over_18csak a külön életkor-igazoló tanúsítványban létezik. A kódpéldákat is a valódi@openeudiAPI-hoz igazítottuk. Azt is javítottuk, hogyan nevezi meg a kérés a kért adatokat: az OpenID4VP 1.0 DCQL-t (dcql_query) használ; a Presentation Exchange 2.0 csak a korábbi tervezetekben szerepelt. Töröltük továbbá azt az állítást, hogy az OpenEUDI országonkénti megfelelőségi térképet tartalmaz – ilyet nem tartalmaz. Pontosítottuk azt is, hogy a WRPAC-t a tárca ellenőrzi, nem az ellenőrző fél SDK-ja.
Mi az az OpenID4VP?
Az OpenID for Verifiable Presentations (OpenID4VP) az a protokoll, amely lehetővé teszi, hogy az EU digitális személyazonosság-tárcái ellenőrzött attribútumokat osszanak meg a vállalkozásokkal, azaz az ellenőrző felekkel (Relying Parties). Ez az eIDAS 2.0 alapú személyazonosság-ellenőrzési folyamat technikai gerince.
Amikor egy felhasználó a pénztárnál beszkennel egy QR-kódot, és a tárcája visszaküldi azt az aláírt adatot, amelyből a webáruház megválaszolja, hogy "ez a személy elmúlt-e 18 éves", az az adatcsere OpenID4VP-n keresztül történik.
Az ellenőrzési folyamat
Az OpenID4VP folyamat négy szereplőt érint:
- Kibocsátó: a kormányzati vagy megbízható hatóság, amely kiadta a hitelesítő adatot (például az osztrák állam nemzeti igazolványt ad ki)
- Birtokos: az állampolgár, akinél az EUDI Tárca van a telefonján
- Ellenőrző (Relying Party): a vállalkozás, amely az ellenőrzést kéri (webshop, KYC-rendszer stb.)
- Bizalmi keretrendszer: az EU bizalmi listái, amelyek meghatározzák, mely kibocsátók és ellenőrzők tekinthetők legitimnek
A folyamat lépésről lépésre
1. Az ellenőrző létrehoz egy Authorization Requestet
↓
2. A kérés QR-kódba (vagy deep linkbe) kerül
↓
3. A birtokos az EUDI Tárcával beszkenneli a QR-kódot
↓
4. A tárca értelmezi a kérést, és megmutatja, mit kérnek
↓
5. A birtokos áttekinti, majd biometriával/PIN-nel jóváhagyja
↓
6. A tárca létrehoz egy Verifiable Presentationt (VP)
↓
7. A VP elküldésre kerül az ellenőrző válaszvégpontjára
↓
8. Az ellenőrző kriptográfiailag validálja a VP-t
↓
9. Az ellenőrzött attribútumok kinyerésre és felhasználásra kerülnek
Két hitelesítőformátum
Az EUDI Tárcák két hitelesítőformátumot támogatnak, eltérő kriptográfiai ellenőrzési útvonallal:
SD-JWT VC (Selective Disclosure JWT)
Távoli ellenőrzési folyamatoknál használják (online, több eszköz között). A hitelesítő adat egy JSON Web Token szelektív közzétételi képességekkel.
- Formátum: JSON-alapú
- Szelektív közzététel: hash-alapú sózás; a kibocsátó minden állítást aláír, de a birtokos csak a kiválasztottakat fedi fel
- Aláírás: JWS (JSON Web Signature) ES256-tal
- Ellenőrzés: JWT feldolgozása -> közzétételi elemek újraépítése -> hash-ek ellenőrzése -> aláírás validálása -> a kibocsátó bizalmi láncának ellenőrzése
Header.Payload.Signature~Disclosure1~Disclosure2~KeyBindingJWT
mdoc / mDL (Mobile Document)
Közelségi ellenőrzési folyamatoknál használják (személyes jelenlét, NFC, BLE). Az ISO 18013-5 szabványra épül.
- Formátum: CBOR-alapú (bináris)
- Szelektív közzététel: az adatszerkezetbe építve, névterekkel és adatelemekkel
- Aláírás: COSE (CBOR Object Signing and Encryption)
- Ellenőrzés: CBOR dekódolás -> COSE-aláírás ellenőrzése -> eszközhitelesítés validálása -> a kibocsátó tanúsítványláncának ellenőrzése
Mindkét formátum ugyanazt a célt szolgálja: kriptográfiailag bizonyítani, hogy egy megbízható kibocsátó meghatározott állításokat tett a birtokosról, de technikailag eltérő módon.
Attribútumok kérése: DCQL
Az engedélyezési kérés (Authorization Request) pontosan megmondja a tárcának, melyik tanúsítványt és mely állításokat kéri az ellenőrző. Az OpenID4VP 1.0 ezt a Digital Credentials Query Language (DCQL) nyelvvel fejezi ki, a dcql_query paraméterben. (Az OpenID4VP korábbi tervezetei ehelyett a DIF Presentation Exchange 2.0-t és egy presentation_definition objektumot használtak; az 1.0-s verzió ezt DCQL-re cserélte.)
A PID-re irányuló életkor-ellenőrzés SD-JWT VC formátumban egyetlen állítást kér – a születési dátumot:
{ "credentials": [{ "id": "pid", "format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:eudi:pid:1"] },
"claims": [{ "path": ["birthdate"] }] }] }
Ugyanez a kérés az mdoc formátumú PID-re az eu.europa.ec.eudi.pid.1 névteret és a birth_date elemet használja. A DCQL alternatívákat is kínálhat: a credential_sets segítségével az ellenőrző „életkor-igazolást vagy PID-et” kérhet, és a tárca ezek egyikét adja vissza.
WRPAC: az ellenőrző tanúsítványa
Az ellenőrzési kérés kibocsátásához az ellenőrző félnek WRPAC-ra (Wallet Relying Party Access Certificate) van szüksége. Ezt az ETSI TS 119 475 definiálja, és:
- azonosítja az ellenőrző felet a tárca számára
- meghatározza, mely attribútumokat kérheti az RP
- minősített bizalmi szolgáltató bocsátja ki
- az EU bizalmi listái alapján kell validálni
A tárca még a hozzájárulási képernyő megjelenítése előtt ellenőrzi a WRPAC-ot. Ha a tanúsítvány érvénytelen, lejárt vagy nincs a bizalmi listán, a tárca elutasítja a kérést.
EU bizalmi listák
Az EU hierarchikus bizalmi infrastruktúrát tart fenn:
EU List of Trusted Lists (LOTL)
└── Country Trusted List (pl. Luxembourg)
└── Trust Service Provider (pl. LuxTrust)
└── Trust Service (pl. WRPAC-kibocsátás)
└── Certificate (az Ön WRPAC-ja)
Ezt a hierarchiát a tárca járja végig, hogy ellenőrizze: a WRPAC-t elismert tagállam jogosult szolgáltatója állította ki. Az ellenőrző oldalán az SDK a tükörfeladatot végzi: azt ellenőrzi, hogy a kapott igazolást olyan kibocsátó írta alá, amelynek tanúsítványa egy közzétett listából (PID esetén a PID-szolgáltatók listájából) vett bizalmi horgonyig vezethető vissza. Ez az implementáció egyik legösszetettebb része: a bizalmi listák formátumának (XML/JSON) saját feldolgozási követelményei vannak, és a listákat minden tagállam önállóan frissíti.
Privacy by design
Az OpenID4VP protokollszinten érvényesíti az adatvédelmet:
- Szelektív közzététel: a birtokos pontosan megválasztja, mely attribútumokat osztja meg. A PID-alapú életkor-ellenőrzés csak a születési dátumot fedi fel — a nevet, a címet és az okmányszámot nem —, az ellenőrző pedig ebből igen/nem választ képez. Születési dátum nélküli
age_over_18csak a külön életkor-igazoló tanúsítványban (eu.europa.ec.av.1) létezik, a PID-ben nem. - Nincs korreláció: minden ellenőrzési munkamenet friss kriptográfiai anyagot használ, így az ellenőrzők nem tudják összekapcsolni a munkameneteket.
- Birtokosi hozzájárulás: minden attribútumkéréshez kifejezett felhasználói jóváhagyás kell az eszközön.
- Adatminimalizálás: a protokoll azt ösztönzi, hogy csak a szükséges adatokat kérjék. A tárca felülete láthatóvá teszi a túlzott adatbekérést.
Ez alapvetően különbözik a hagyományos KYC-tól, ahol a vállalkozások gyakran a szükségesnél több adatot kapnak, majd tárolnak.
Hogyan valósítja meg ezt az OpenEUDI
Az OpenEUDI SDK rétegekre épül. Az @openeudi/openid4vp csomag egyszerű API-val implementálja a credential-feldolgozást: a parsePresentation(vpToken, options) automatikusan felismeri a credential formátumát (SD-JWT VC vagy mDOC), validálja a kriptográfiai aláírásokat és visszaadja az ellenőrzött claim-eket.
import { parsePresentation } from '@openeudi/openid4vp';
// Az SD-JWT VC és az mDOC formátumot is automatikusan kezeli
const result = await parsePresentation(vpToken, {
nonce, // az Authorization Requestben küldött nonce
trustedCertificates, // a kibocsátók bizalmi horgonyai (DER), pl. az EU bizalmi listáiról
});
// result.valid — az aláírás-, key binding- és bizalmi ellenőrzés sikeres
// result.format — 'sd-jwt-vc' | 'mdoc'
// result.claims — ellenőrzött, szelektíven közzétett attribútumok (pl. a PID születési dátuma)
A magasabb szintű VerificationService erre épül, és a teljes munkamenet-életciklust kezeli:
import { VerificationService, VerificationType } from '@openeudi/core';
import type { IVerificationMode } from '@openeudi/core';
// A @openeudi/core DemoMode-ot és MockMode-ot tartalmaz. Valódi tárcákhoz saját
// IVerificationMode kell: ez állítja össze az OpenID4VP-kérést (a WRPAC-cal
// aláírva), és az @openeudi/openid4vp segítségével ellenőrzi a választ.
declare const productionMode: IVerificationMode;
const service = new VerificationService({ mode: productionMode });
const session = await service.createSession({ type: VerificationType.AGE });
// session.walletUrl — QR-kódként vagy deep linkként jelenítse meg
service.on('session:verified', (session, result) => {
// result.ageVerified — származtatott logikai érték; a születési dátum nem része az eredménynek
});
Belsőleg a szolgáltatás és az ellenőrzési mód:
- létrehoz egy specifikációnak megfelelő Authorization Requestet
- QR-kódba kódolja azt (
generateQRCodea@openeudi/core/qrmodulból) - a
service.handleCallback()hívásán keresztül fogadja a tárca VP-jét, amelyet a saját válaszvégpontjából hív meg - az
@openeudi/openid4vpsegítségével validálja a VP-t (SD-JWT VC vagy mdoc) - ellenőrzi a kibocsátó tanúsítványát az EU bizalmi listái alapján
- a közzétett claim-eket a szabály eredményére szűkíti (
ageVerified,countryVerified) — a születési dátum csak az ellenőrzéshez kell, nem kerül visszaadásra - lejártatja a munkameneteket a TTL végén (alapértelmezés szerint öt perc után)
Mindez a service.createSession(), a service.handleCallback() és a session:verified esemény mögött történik.
Határokon átnyúló megfelelőség
Az EU tagállamai bizonyos mozgástérrel rendelkeznek abban, hogy mely attribútumok kérhetők és milyen feltételek mellett. Például:
- az életkor-küszöbök termékkategóriánként és országonként eltérnek
- egyes országok korlátozzák bizonyos attribútumok kiadását
- a nemzeti tárcamegvalósítások eltérő hitelesítési sémákat használhatnak
Mielőtt kérést állít össze, ellenőrizze, mit tartalmaz valójában a tanúsítvány: minden PID-ben kötelező a birth_date és a nationality, a resident_country viszont opcionális, és hiányozhat.
Mi jöhet ezután a protokollban
Az OpenID4VP 1.0 az OpenID Foundation végleges specifikációja, lekérdezőnyelve a DCQL – a Presentation Exchange nem része. A munka most az alapprotokoll körül folyik:
- Tanúsítványstátusz: annak ellenőrzése, hogy egy tanúsítványt visszavontak-e
- Több eszközös folyamatok fejlesztése: jobb UX mobilról asztali gépre történő ellenőrzésnél
- Alternatívák egy kérésben: a DCQL
credential_sets, például „életkor-igazolás vagy PID”
Az OpenEUDI a protokollváltozásokat npm-csomagjainak új verzióiként adja ki.
Az OpenEUDI az EUDI Tárca-ökoszisztémához valósítja meg az OpenID4VP-t. Az SDK Apache 2.0 licencű és ingyenesen használható. Az éles bevezetésekhez menedzselt WRPAC-tanúsítványokkal tekintse meg az eIDAS Pro menedzselt csomagjait.
Kapcsolódó cikkek
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.
6 perc olvasás
Hogyan működik az eIDAS-ellenőrzés: Technikai mélyelemzés
Átfogó technikai áttekintés az eIDAS ellenőrzési folyamatról a QR-kód generálástól az attribútum-validálásig, beleértve a protokollokat, biztonsági intézkedéseket és integrációs mintákat.
12 perc olvasás
Cikk megosztása
Segítsen másoknak megismerni az eIDAS-ellenőrzést