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.

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

Frissítve 2026. október 20-án: az OpenEUDI 2026. április 1-jén, nem sokkal a bejegyzés megjelenése után MIT licencről Apache-2.0 licencre váltott, ezért a licenchivatkozásokat ennek megfelelően frissítettük. A kódpélda mostantól a közzétett @openeudi/core API-t követi (result.ageVerified). Az SDK már nincs fejlesztés alatt: 2026. április 11. óta elérhető az npm-en (jelenleg @openeudi/core 0.8.0, @openeudi/openid4vp 0.13.0 és @openeudi/dcql 0.2.0), ezért a kiadási ütemterv helyére a jelenlegi állapot került. A csomaglistát és a WooCommerce plugin licencét (GPL v2 vagy újabb) is javítottuk, és töröltük a TEST módot, a referenciaszervert és a megfelelőségi térképet, mert ezek nem jelentek meg.

Miért tesszük nyílttá a protokollréteget?

Az EU digitális személyazonosság-tárcája érkezik. 2026 decemberére minden EU-tagállamnak el kell indítania az EUDI Tárcákat a 2024/1183/EU rendelet alapján. Azoknak a vállalkozásoknak, amelyek ügyfélazonosságot ellenőriznek, legyen szó korhatáros e-kereskedelemről vagy pénzügyi KYC-ről, OpenID4VP protokollon kell tudniuk kommunikálni ezekkel a tárcákkal.

Itt van azonban a probléma: nincs gyártásra kész, nyílt forráskódú ellenőrző könyvtár az ellenőrző fél oldalára.

Az Európai Bizottság közzétett egy referencia-tárcaalkalmazást a birtokosi/állampolgári oldalra, de nem adott ki referenciaimplementációt azoknak a vállalkozásoknak, amelyeknek a hitelesítő adatokat ellenőrizniük kell. A meglévő SSI eszközkészletek, mint a walt.id (Kotlin/JVM) vagy a SpruceID (Rust), általános használati eseteket céloznak, nem az EUDI Tárca Architecture Reference Framework sajátosságait.

Az elmúlt évben az eIDAS Prót, egy menedzselt személyazonosság-ellenőrzési platformot építettünk. E munka során elkészült az OpenID4VP ellenőrzési protokoll TypeScript implementációja. Most ezt a protokollréteget kiválasztjuk és OpenEUDI néven tesszük közzé: egy ingyenes, Apache-2.0 licencű SDK-ként, amelyet bármely fejlesztő használhat.

Mi az az OpenEUDI?

Az OpenEUDI egy TypeScript könyvtár, amely kezeli az EU digitális személyazonosság-tárcáinak hitelesítő adatainak ellenőrzéséhez szükséges technikai összetettséget. Az alábbiakat valósítja meg:

  • OpenID4VP (Verifiable Presentations) - ez a protokoll az EUDI Tárcák és a vállalkozások közötti ellenőrzött attribútummegosztáshoz
  • SD-JWT VC ellenőrzés - szelektív közzétételű JWT a távoli ellenőrzésekhez
  • mdoc/mDL ellenőrzés - CBOR-alapú mobil dokumentumformátum közelségi folyamatokhoz
  • A kibocsátó megbízhatóságának ellenőrzése - tanúsítványlánc-validáció az Ön által beállított bizalmi horgonyokkal szemben, például az EU bizalmi listáiból
  • QR-kódos munkamenet-kezelés - QR-kód generálás, munkamenetkövetés, eredmények fogadása eseményként
import { VerificationService, DemoMode, InMemorySessionStore, VerificationType } from '@openeudi/core';
import { generateQRCode } from '@openeudi/core/qr';

const service = new VerificationService({
  mode: new DemoMode(),
  store: new InMemorySessionStore(),
});

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

console.log(await generateQRCode(session.walletUrl)); // Megjelenítés a felhasználónak

service.on('session:verified', (_session, result) => {
  console.log(result.ageVerified); // true
});

Mi nem az OpenEUDI?

Az OpenEUDI a protokollkönyvtár, nem a teljes éles infrastruktúra. Ahhoz, hogy valódi EUDI Tárcákkal szemben éles ellenőrzéseket végezzen (indulás 2026 decemberében), az alábbiakra is szüksége van:

  • egy WRPAC-tanúsítványra (Wallet Relying Party Access Certificate) minősített bizalmi szolgáltatótól
  • ellenőrzőfél-regisztrációra egy nemzeti hatóságnál
  • éles infrastruktúrára: sebességkorlátozásra, monitorozásra, auditnaplózásra, SLA-garanciákra

Pontosan erre épül az eIDAS Pro menedzselt szolgáltatása; a menedzselt WRPAC akkor következik, amikor WRPAC már beszerezhető. Az SDK a protokollt kezeli, a menedzselt szolgáltatás az infrastruktúrát.

Ez olyan, mint a PostgreSQL (ingyenes, nyílt forráskódú adatbázismotor) és egy menedzselt adatbázis-szolgáltatás összehasonlítása. Mindkettő értékes. A nyílt forráskódú eszköz segít elindulni, a menedzselt szolgáltatás pedig üzemeltetési terhek nélkül visz éles környezetbe.

Az open core modell

Úgy gondoljuk, hogy az ellenőrzési protokollnak nyílt infrastruktúrának kell lennie, akárcsak a HTTP- vagy TLS-könyvtáraknak. Mindenki nyer vele, ha a protokollréteg átlátható, auditálható és közösségileg fenntartott.

Üzleti modellünk egyszerű:

RétegModellTartalom
ProtokollIngyenes, Apache-2.0 licencOpenEUDI SDK, dokumentáció
InfrastruktúraFizetős SaaSMenedzselt WRPAC, éles API, vezérlőpultok, SLA, támogatás

Ez azt jelenti, hogy:

  • a fejlesztők ingyen építhetnek és tesztelhetnek ellenőrzési folyamatokat
  • a vállalkozások, amelyek menedzselt megfelelőséget szeretnének, az infrastruktúráért fizetnek
  • az ökoszisztéma egy közös, auditálható protokollimplementációból profitál
  • a biztonsági kutatók átnézhetik a személyazonosság-ellenőrzést kezelő kódot

Mi tartozik bele?

Core SDK (@openeudi/core)

Maga a protokollkönyvtár: OpenID4VP kérés/válasz kezelés, hitelesítő adat ellenőrzés és munkamenetkezelés. Az OpenEUDI ökoszisztéma három csomagból áll: az @openeudi/core kezeli az ellenőrzési munkameneteket, az @openeudi/openid4vp credential-feldolgozást biztosít SD-JWT VC és mDOC formátumokhoz kriptográfiai aláírásvalidálással, az @openeudi/dcql pedig validálja és illeszti a DCQL-lekérdezéseket, az OpenID4VP 1.0 credential-lekérdező nyelvét.

E-kereskedelmi bővítmények (eIDAS Pro)

Az eIDAS Pro ugyanerre az ellenőrzési folyamatra építi e-kereskedelmi integrációit. Ezek az eIDAS Pro API-hoz kapcsolódnak:

  • WooCommerce plugin (GPL v2 vagy újabb) - életkor-ellenőrzés a pénztárnál
  • Shopify alkalmazás - Checkout UI Extension személyazonosság-ellenőrzéshez
  • JavaScript widget - beágyazható ellenőrzés bármely weboldalra

Fejlesztői módok

Az @openeudi/core két fejlesztői módot tartalmaz:

  • DEMO: alapértelmezés szerint 3 másodperc után automatikusan befejeződik a bemutatókhoz
  • MOCK: beállítható válaszok integrációs teszteléshez

Dokumentáció

Minden csomag README-je leírja a telepítést, a használati példákat és az API-t.

Luxemburgban építve

Az OpenEUDI Luxemburgban készül, Európa fintech ökoszisztémájának egyik központjában. Luxemburg digitális személyazonosságra, fintechekre és szabályozási megfelelőségre irányuló stratégiai fókusza, valamint az olyan programok, mint a Fit 4 Start, a LHoFT és az SNCI ideális bázissá teszik a pán-európai identitásinfrastruktúra fejlesztéséhez.

Első lépések

Az SDK Apache-2.0 licenccel elérhető az npm-en. Ön:

  1. Telepítheti: npm install @openeudi/core (a credential-feldolgozáshoz és a DCQL-hez adja hozzá az @openeudi/openid4vp és az @openeudi/dcql csomagot)
  2. Elolvashatja a forráskódot a GitHubon: https://github.com/openeudi
  3. Kipróbálhatja az élő demót a főoldalon, hogy lássa az ellenőrzési folyamatot működés közben
  4. Elolvashatja a technikai mélyelemzést arról, hogyan működik az eIDAS-ellenőrzés

Hol tartunk (2026. október)

  • 2026. április 11.: az @openeudi/core első nyilvános kiadása (0.1.0) az npm-en
  • Ma: @openeudi/core 0.8.0, @openeudi/openid4vp 0.13.0, @openeudi/dcql 0.2.0
  • Következő lépés: éles használatra kész kiadás az EUDI Tárca indulásához igazítva
  • Folyamatosan: közösségi hozzájárulások, további framework-integrációk, más nyelvekhez készült bindingok

Az OpenEUDI-t nyíltan építjük. Ha Ön EUDI Tárca-integráción, személyazonosság-ellenőrzésen vagy EU-szintű szabályozási megfelelőségen dolgozik, örömmel beszélünk Önnel.


Az OpenEUDI Apache-2.0 licencű és örökre ingyenes. Az eIDAS Pro menedzselt szolgáltatása arra épül, hogy éles infrastruktúrát, menedzselt WRPAC-tanúsítványokat (amint beszerezhetők) és SLA-t biztosítson azoknak a vállalkozásoknak, amelyek menedzselt megfelelőséget szeretnének.

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