Relying Parties · OpenID4VP · OIDC · eIDAS 2.0
CodeB EUDI Gateway – eine Anbindung für jede EU-Wallet
Jedes EU-Land bringt seine eigene Wallet, zu einem eigenen Termin, und entwickelt sie nach dem Start weiter. Für eine Bank, einen Shop oder eine Behörde ist ihre Annahme eine Aufgabe, die nie fertig wird. Das CodeB EUDI Gateway auf phone.codeb.io übernimmt sie: Ihre Website wird einmal angebunden, mit Standard-OpenID-Connect, und das Gateway spricht mit den Wallets.
- Eine Integration
- OpenID Connect für Ihre App
- Nachweis zu jeder Anfrage
Warum eine einzige Anbindung zählt
Die EU-Wallets kommen nicht alle auf einmal. Die Länder starten in Etappen, ergänzen später Dokumente und ändern ihre Wallets nach dem Start. Jede Änderung kann Protokoll, Formate oder Vertrauenslisten betreffen, auf die sich Ihre Website verlässt.
Ohne Gateway muss jede Relying Party das alles selbst verfolgen: sich als Organisation registrieren, die Wallet-Daten anfragt, jeder Wallet beweisen, dass sie fragen darf, prüfen, ob die Wallet echt ist, jede Anfrage dokumentieren – und das bei jedem Update erneut.
Was das Gateway für Sie übernimmt
Standard-Anmeldung für Ihre App: Ihre Website nutzt OpenID Connect wie bei jedem anderen Login. Das Gateway spricht OpenID4VP 1.0 mit dem HAIP-Profil, SD-JWT VC und ISO mdoc mit der Wallet und übergibt Ihrer App ein signiertes id_token mit genau den angefragten Daten. Gateway-Dokumentation.
Vertrauen und Sperrstatus: Das Gateway prüft die Signaturen der Aussteller gegen die Vertrauenslisten, die Statuslisten für gesperrte Dokumente und dass die Daten unverändert sind.
Dieselben Felder aus jedem Land: Für die PID als SD-JWT VC aus Wallets, die ARF 3.0 folgen, liest Ihre App dieselben Standard-OpenID-Connect-Claims (etwa given_name, family_name, birthdate und address) vom UserInfo-Endpunkt, egal aus welchem Land oder von welchem Aussteller – keine länderspezifische Zuordnung auf Ihrer Seite. Weitere Wallet-Attribute werden nur freigegeben, wenn sie für Ihren Client aktiviert sind. Claim-Liste.
Registrierung: Als Wallet-Intermediär fragt das Gateway im Auftrag vieler Organisationen, jede mit eigenem Registrierungszertifikat (ETSI TS 119 475), das die Wallet dem Nutzer zeigt.
Nachweise: Jede Anfrage wird als hash-verketteter Nachweis gespeichert – was gefragt wurde, warum und was die Wallet geantwortet hat.
Kunden ohne Wallet: Dasselbe Gateway liest den Chip ihres Reisepasses oder Ausweises über ihr Android-Telefon – Fern-Ausweisprüfung.
So starten Sie
Ein Script-Tag: Die Demo des Anmelde-Widgets zeigt einen Button „Mit EU-Wallet anmelden“, den Sie auf jede Seite setzen können.
OpenID-Connect-Beispiele für gängige Plattformen: Integrations-Kochbuch.
Erst ausprobieren: Lesen Sie Ihren eigenen Ausweis-Chip oder zeigen Sie Ihr Alter im Playground, und testen Sie jede Wallet mit dem Interoperabilitäts-Selbsttest.
Altersprüfung, die sonst nichts verrät
Online-Dienste mit Altersgrenzen – etwa nach dem Digital Services Act – können nur „über 18?“ fragen. Das Gateway unterstützt den EU-Link zur Altersverifikation: Die Wallet antwortet aus der PID oder einer Altersbescheinigung mit Ja oder Nein, ohne Geburtsdatum oder Namen, und die Person sieht, dass nichts anderes gefragt wird. Probieren Sie es auf der Seite zur Altersprüfung oder lesen Sie Alter nachweisen.
Eigene Nachweise ausstellen
Dieselbe Plattform stellt auch aus: Mitgliedskarten, Zutrittskarten für Türen und PCs, PKI-Karten und andere Bescheinigungen gelangen mit OpenID4VCI direkt in die Wallet der Person, signiert von Ihrer Organisation. Es sind gewöhnliche elektronische Attributsbescheinigungen (EAA) – CodeB ist kein qualifizierter Vertrauensdiensteanbieter und stellt daher keine qualifizierten Bescheinigungen (QEAA) aus.
Wo das Gateway heute steht
Das Gateway ist darauf ausgelegt, eIDAS 2.0 und dem EU Architecture and Reference Framework zu folgen. Es ist nicht zertifiziert. Zugangszertifikate stellt CodeBs eigene Test-CA nach eigener Richtlinie aus (Zertifikatsrichtlinie), noch nicht ein nationaler Registrar. Die Anbindung an ein Hardware-Sicherheitsmodul (HSM) ist im Rahmen der geplanten Zertifizierung vorgesehen.
Getestet ist es mit der EU-Referenz-Wallet und weiteren Wallets, die den Standards folgen; die nationalen Wallets werden getestet, sobald sie verfügbar sind. Eine Chip-Lesung beweist, dass ein echtes Dokument vorlag – nicht, wer es in der Hand hält. Die starke Kundenauthentifizierung für Zahlungen (PSD2) folgt, sobald die EU-Kommission ihr Regelwerk veröffentlicht.
Bank-IDs sind nicht Teil des Gateways.
Fragen zum CodeB EUDI Gateway
Was ist das CodeB EUDI Gateway?
Ein Dienst auf phone.codeb.io, mit dem eine Website die EU-Wallets für digitale Identität mit einer Integration akzeptiert. Ihre App nutzt OpenID Connect; das Gateway übernimmt OpenID4VP, die Datenformate, Vertrauens- und Sperrprüfung, Registrierung und Nachweise.
Muss ich meine Integration ändern, wenn eine Wallet ein Update bekommt?
Nein. Das Gateway folgt den Wallets und den Standards; Ihre OpenID-Connect-Integration bleibt gleich.
Welche Datenformate werden unterstützt?
SD-JWT VC und ISO mdoc über OpenID4VP 1.0 mit dem HAIP-Profil, wie sie die EU-Wallets nutzen.
Ist das Gateway zertifiziert?
Nein. Es ist darauf ausgelegt, eIDAS 2.0 und dem EU Architecture and Reference Framework zu folgen, aber nicht zertifiziert, und seine Zugangszertifikate kommen von CodeBs eigener Test-CA.
Kann das Gateway nur das Alter einer Person prüfen?
Ja. Mit dem EU-Link zur Altersverifikation teilt die Wallet nur die Antwort auf „über 18?“ (oder ein anderes Alter), sonst nichts – kein Geburtsdatum, keinen Namen.
Kann meine Organisation eigene Nachweise in EU-Wallets ausstellen?
Ja – Mitglieds-, Zutritts- und PKI-Karten und andere Bescheinigungen, mit OpenID4VCI, signiert von Ihrer Organisation. Es sind nicht qualifizierte Bescheinigungen (EAA); für qualifizierte brauchen Sie einen qualifizierten Vertrauensdiensteanbieter.
Unterstützt es Bank-IDs?
Nein. Das Gateway ist für die EU-Wallets und für das Lesen des Chips von Reisepässen und Ausweisen.