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.

Az eIDAS Pro csapata
2026. március 22.
12 perc olvasás

Javítva 2026. október 20-án: a bejegyzés korábbi változata azt állította, hogy az age_over_18 ké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üli age_over_18 csak a külön életkor-igazoló tanúsítványban létezik. A kódpéldákat is a valódi @openeudi API-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:

  1. 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)
  2. Birtokos: az állampolgár, akinél az EUDI Tárca van a telefonján
  3. Ellenőrző (Relying Party): a vállalkozás, amely az ellenőrzést kéri (webshop, KYC-rendszer stb.)
  4. 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_18 csak 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:

  1. létrehoz egy specifikációnak megfelelő Authorization Requestet
  2. QR-kódba kódolja azt (generateQRCode a @openeudi/core/qr modulból)
  3. 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
  4. az @openeudi/openid4vp segítségével validálja a VP-t (SD-JWT VC vagy mdoc)
  5. ellenőrzi a kibocsátó tanúsítványát az EU bizalmi listái alapján
  6. 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
  7. 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

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