Blog
Produkt-Update #33
Demo-Wallets für Web und Mobil, Batch-Ausstellung und mehr
TL;DR
- Neues Release – Demo-Web- und Mobile-Wallets, Batch-Ausstellung und mehr
- Neue eIDAS-2-Branchenleitfäden – Leitfäden für 10 Branchen, von öffentlicher Verwaltung und Finanzdienstleistungen bis hin zu Telekommunikation, Gesundheitswesen und Online-Plattformen.
- Events – WeBuild-Pilot-Payments-Demo mit Authologic, Visa und Mastercard auf der GDC
Community Stack (1.1.1)
Nachfolgend finden Sie die Highlights aus Version 1.1.1 der Identity Lib. Das vollständige Änderungsprotokoll für v1.1.1 finden Sie hier. Beachten Sie, dass diese Woche auch die Version 1.1.0 veröffentlicht wurde. Möchten Sie mehr über die Identity Lib im Allgemeinen erfahren? Sehen Sie sich unser Intro-Video an.
1.1.1
Features
Demo-Web-Wallet
Empfangen und präsentieren Sie Credentials über unsere neue Demo-Web-Wallet, die auf der wallet2-API aufbaut.
Demo-Mobile-Wallet für Android & iOS
Testen Sie den vollständigen Credential-Lebenszyklus auf einem Mobilgerät mit unseren neuen Open-Source-Referenz-Wallet-Apps für Android und iOS, inklusive mDL-Sharing vor Ort via NFC oder Bluetooth. Die Apps bauen auf unserem kommenden Wallet SDK auf, das sich noch in Entwicklung befindet.
OpenID4VP-Request-Authentifizierung in Wallet2
Wallets prüfen jetzt, wer anfragt, bevor sie etwas anzeigen oder teilen. Signierte Anfragen werden gegen Zertifikate verifiziert, denen Sie vertrauen, und registrierte Clients werden mit den von Ihnen hinterlegten Metadaten abgeglichen.
Batch-Ausstellung in Issuer2
Fassen Sie mehrere Credentials in einem Angebot zusammen, oder lassen Sie eine Wallet mehrere proof-gebundene Kopien eines Credentials in einem einzigen Aufruf anfordern. Bestehende Angebote mit einem einzelnen Credential funktionieren genau wie bisher.
Gültigkeit ausgestellter mDocs steuern
Legen Sie fest, wann ein mDoc gültig wird, wann es abläuft und wann Wallets eine Aktualisierung erwarten sollten – einmalig im Profil oder pro Angebot. Werte können feste Zeitstempel oder Zeitstempel-Datenfunktionen sein, die aufgelöst werden, wenn die Wallet das Credential abruft.
Ausstellern vertrauen, die per Public Key registriert sind, sowie EUDI-Zertifikatsprofile
ETSI-Vertrauenslisten können jetzt Aussteller abgleichen, die einen Public Key, aber kein Zertifikat haben – typisch für did:web. Die X.509-Bibliothek erhielt außerdem EUDI-Profile für Zertifikate von PID-Anbietern, Wallet-Anbietern und Wallet-Relying-Parties.
Sichererer Speicherverbrauch von Verifier2
Verifier2 begrenzt jetzt seine In-Memory-Sessions (standardmäßig 2.000 Sessions und 256 MiB, konfigurierbar), speichert große Byte-Werte kompakt und meldet eine nicht erreichbare Abhängigkeit als temporären 503 statt als Client-Fehler.
Namespace-Mapping und Datumsfunktionen für mDocs
Das Mapping erreicht jetzt die Claims innerhalb von mDoc-Namespaces, einschließlich ISO-Full-Date-Claims über die neuen Funktionen
Fixes und Verbesserungen
- Strengere x509_hash-Client-IDs. Die Zertifikatskette der Anfrage wird validiert, die Signatur wird gegen das Leaf-Zertifikat geprüft, und der Hash des Leaf-Zertifikats muss mit dem Hash in der Client-ID übereinstimmen. Andernfalls wird die Anfrage abgelehnt. #2193
- Verifier2: Das Weglassen von clientId funktioniert weiterhin. Eine unsignierte Verifier2-Session ohne clientId bindet weiterhin an redirect_uri:<response_uri>, und die Konfiguration lädt korrekt. #2170
- Client-gebundene OpenID4VCI-Proofs enthalten iss, gesetzt auf die OAuth client_id. Anonyme pre-authorized Proofs lassen es weg, und Issuer2 prüft es nur, wenn es vorhanden ist. #2246
- Ausgestellte mDocs bleiben an den Holder-Schlüssel gebunden, der die Gerätesignatur erstellt hat. Die isolierte Ausstellung muss diese Key-ID übergeben; die Präsentation fällt nicht mehr auf einen Wallet-Standardschlüssel zurück. #2154
- Das Policy-Result-Ereignis wird einmal ausgelöst. credential_policy_results_available wird pro Verifizierungssession von einer einzigen Stelle ausgelöst. #2153
- Verifier2 und die Wallet-Präsentation führen eine DCQL-Auswahl pro Präsentation durch, und die Wiederherstellung von crypto2-Schlüsseln cacht den Nachweis der Konsistenz von privatem und öffentlichem Schlüssel #2209
- Porträt-Aufnahmedaten sind in neu ausgestellten mDocs vollständige Zeitstempel. Eingaben nur mit Datum werden weiterhin akzeptiert. #2192
- Ein Status-List-Codec für alle Formate. Token Status List, Bitstring Status List, StatusList2021 und RevocationList2020 nutzen eine gemeinsame Bibliothek, und die Verification Policies verwenden sie. #2248
- Issuer2 und Verifier2 können eine Teilmenge der Protokoll-Routen registrieren. Nicht registrierte Gruppen fehlen im Routing-Baum und liefern 404. Vollständige Deployments behalten den vollständigen Routensatz #2158
- Portal2 hält Signaturschlüssel serverseitig. Signierte PID-Presets lesen ihre Schlüssel aus den Umgebungsvariablen NUXT_PID_*, das unsignierte basic-pid bleibt unverändert, und das Helm-Deployment kann das Secret bereitstellen. #2186 · #2219
- Die Ausstellung in Portal2 zeigt ein Raster mit Credential-Karten. Der mitgelieferte Issuer2-Beispielkatalog enthält jetzt Anzeigemetadaten für die Karten. #2252
- Die Zertifikatsausstellung kann den Subject-DN der CSR als binären Distinguished Name übernehmen, validiert Basic Constraints und bietet einen Java-seitigen Helper für die Erstellung von Zertifikaten und Crypto2-Schlüsseln
Enterprise Stack (1.1.1)
Nachfolgend finden Sie die neuen Feature-Highlights aus Version 1.1.1 des Enterprise Stack. Das vollständige Änderungsprotokoll für 1.1.1 finden Sie hier. Beachten Sie, dass diese Woche auch die Version 1.1.0 veröffentlicht wurde. Möchten Sie mehr über den Enterprise Stack im Allgemeinen erfahren? Sehen Sie sich unser Intro-Video an.
1.1.1
Features
OpenID4VP-Request-Authentifizierung in Wallet2
Wallet2 prüft jetzt, wer anfragt, bevor es etwas anzeigt oder teilt. Signierte OpenID4VP-Anfragen müssen zu festgelegten Zertifikaten, zu Relying Parties aus einer verknüpften Trust Registry oder zu von Ihnen registrierten Clients passen. Andernfalls werden sie abgelehnt.
Batch-Ausstellung in Issuer2
Fassen Sie mehrere Credentials in einem Angebot zusammen, oder lassen Sie eine Wallet mehrere proof-gebundene Kopien desselben Credentials in einem Durchgang anfordern. Bestehende Angebote mit einem einzelnen Credential funktionieren unverändert weiter.
mDoc-Gültigkeit mit msoData steuern
Entscheiden Sie, wann ein ausgestelltes mDoc gültig wird, wann es abläuft und wann Wallets eine Aktualisierung erwarten sollten. Legen Sie es einmalig im Profil fest oder überschreiben Sie es pro Angebot. Werte können feste Zeitstempel oder Zeitstempel-Datenfunktionen sein, die aufgelöst werden, wenn die Wallet das Credential abruft.
Standardanfragen für Services
Hinterlegen Sie die Einstellungen, die sich nie ändern, direkt im Service, etwa Verifier-Flow-Typ, Signierung und Schlüssel. Senden Sie dann nur noch das, was pro Aufruf abweicht. Funktioniert mit Verifier2, Wallet2, dem X.509-Service, dem DID-Service, VICAL, Client Attestation und Trust Registry.
EUDI-Zertifikatsprofile im X.509-Service
Stellen Sie Zugangszertifikate für PID-Anbieter, Wallet-Anbieter und Wallet-Relying-Parties aus und erstellen oder ersetzen Sie jedes Zertifikat unter einer bekannten ID. Ein Entwurf des Registrierungszertifikat-Profils für Wallet-Relying-Parties ist enthalten.
X.509-Aussteller-Onboarding mit einem Aufruf
Richten Sie einen vollständigen X.509-Aussteller mit einer einzigen Init-Anfrage ein: KMS-Schlüssel, X.509-Service und -Store, eine IACA (oder Ihre bestehende) und einen Document Signer.
Ausstellern vertrauen, die nur einen Public Key haben
Aussteller, die allein per Schlüssel in einer ETSI-Vertrauensliste registriert sind – typisch für did:web –, genießen jetzt Vertrauen. Verifier2 löst ihren Schlüssel auf und gleicht ihn automatisch mit der Liste ab; Sie können ihn auch direkt abfragen.
Status eines Credentials lesen
Rufen Sie den aktuellen Status eines ausgestellten Credentials über seine Ausstellungssession oder seinen Status-List-Index ab.
Mit gespeicherten Zertifikaten signieren
Verifier2 und die Signierung des Credential-Status können jetzt Zertifikate aus einem X.509-Store verwenden, sodass Sie keine Ketten mehr in Konfigurationen einfügen müssen.
Klarere Lizenzlimits
Monatliche Nutzungslimits werden jetzt als solche im Fehler ausgewiesen, sodass Sie sie von stündlichen Obergrenzen unterscheiden können. Offline-Lizenzen werden bei steigender Nutzung schrittweise herabgestuft, und eine Installation kann sich mit ihrem Seed von einer abgelaufenen Lizenz erholen.
Sicherere Standardeinstellungen für Dev-Modus und Superadmin-Setup
Dev-Modus-Routen benötigen jetzt ein geheimes Token, und Superadmin-Bootstrap-Tokens funktionieren nur im Dev-Modus, es sei denn, Sie markieren sie für die Produktion.
Fixes und Verbesserungen
- Verifier2 protokolliert die Verifizierungssession-ID bei Session-Updates.
- Die Webhook-Abdeckung sichert die Ereignisreihenfolge von issuer2 für die Ausstellungs- und Präsentationspfade v1 und v2 ab.
- Die Erstellung von Document-Signer-Zertifikaten lehnt einen Gültigkeitszeitraum außerhalb des zulässigen Fensters und einen Subject-DN ab, der nicht zur IACA passt.
PUTeines Zertifikats über den X.509-Service ist ohne angeschlossenen Store nur auf den Pfaden erfolgreich, die noch einen lokalen Schreibvorgang erlauben. Ein zusammengesetzter Store ohne angeschlossene Komponente liefert 405.- EUDI-Beispiele, das Annex-C-Verifier-Setup und die festgelegte Zertifikatsgültigkeit in Tests wurden an die aktuellen X.509- und Signed-Request-Regeln angeglichen.
- Trivy-HIGH-Befunde zu
fast-uriim Abhängigkeitsbaum der Enterprise UI sind gepatcht. - ZAP-Baseline-Scans laufen bei Pull Requests. Der tägliche Scan schlägt bei High- oder Medium-Befunden fehl, die nicht in der Regeldatei stehen.
- CLI-Integrationstests laufen bei Pull Requests, die die API ändern.
- Workflows für Sicherheitsscans laufen wieder auf dem gemeinsamen Runner-Pool, und der Hinweis zu
devalueim UI-Baum ist aktualisiert. - Sonar-Befunde wurden bereinigt, einschließlich Beispiel-Logo-URIs, die über HTTPS ausgeliefert werden.
- Lasttest-Läufe können Worker-Knoten auf Spot-Kapazität platzieren, MongoDB anhand des Knotentyps dimensionieren und Last aus dem Cluster heraus erzeugen. Der API-Prozess endet mit einem Fehlercode ungleich null, wenn der Start fehlschlägt. Die Fähigkeiten der PostgreSQL-Engine entsprechen dem, was dieses Profil tatsächlich leisten kann.
Breaking Changes
Dabei handelt es sich um Änderungen an Anfragen, Antworten oder Deployments, die laufende Integrationen betreffen.
Authentifizierung von Wallet2-Anfragen
Wallet2 lehnt eine Authorization Request ab, die 1.0.0 noch präsentiert hätte.
- Eine signierte Anfrage mit
x509_san_dns,x509_hash, einem DID,verifier_attestationoderpre-registeredschlägt fehl (fail closed), sofern kein passendes Trust-Material vorliegt (PEM-Pins, eine verknüpfte Trust Registry oder gespeicherte JWKS fürpre-registered). - Eine unsignierte
pre-registered-Anfrage ohne gespeicherteredirect_uris, die zum Ziel passen, schlägt mitinvalid_clientfehl. - Unsignierte
redirect_uri-Anfragen, die überrequest_uriabgerufen werden, bleiben unverändert. - Es wurde keine Präsentationsroute entfernt. Es gibt kein Konfigurationsflag, um die Prüfung zu überspringen.
X.509-Zertifikat-API
PUT /v1/{target}/x509-service-api/certificateserfordert die BerechtigungES_X509_SERVICE_UPSERT_CERTIFICATE.- Die Erstellung von Zertifikaten (generische Zertifikate und ISO-Document-Signer) gibt 400 zurück, wenn das Gültigkeitsfenster inkonsistent ist oder der Subject-DN eines Document Signers nicht zu seiner IACA passt.
- Ein
PUTgegen einen zusammengesetzten Zertifikatsspeicher, dem kein Speicher zugeordnet ist, gibt405 Method Not Allowedzurück.
Superadmin-Bootstrap
- Ein Registrierungstoken mit ausgelassenem oder auf
truegesetztemdevModeOnlyfunktioniert nur, solangedev-modeaktiviert ist. Produktionstoken müssendevModeOnlyauffalsesetzen. POST /v1/superadmin/create-by-tokenkann nach 5 Anfragen pro Minute von einer Client-Adresse 429 zurückgeben.
Dev-Modus
- Ein Deployment mit aktiviertem
dev-modeund ohneaccessTokenindev-mode-access.conflehnt/v1/dev/*mit 503 ab, bis das Token gesetzt ist. - Ein
accessTokenmit dem Wertreplace-with-a-per-deployment-secretverhindert den Start des Prozesses. - Bei aktiviertem
dev-modewird die mitgeliefertedev-mode.confgeladen, einschließlichenableDidWebResolverHttps = false.
eIDAS 2 Branchenleitfäden
Wir haben eigene Leitfäden dazu veröffentlicht, was eIDAS 2 und die EUDI-Wallet für verschiedene Branchen bedeuten, welche Fristen gelten und wie Sie die Anforderungen erfüllen.
- Öffentlicher Sektor – Verpflichtende Wallet-Akzeptanz und die Ausstellung amtlicher Dokumente als digitale Credentials.
- Finanzdienstleistungen – Wallet-Akzeptanz, Wallet-basierte SCA nach PSD2 mit TS12, wiederverwendbare KYC und die Frist 2027.
- Versicherungen – Sorgfaltspflichten gegenüber Kunden, Wallet-basiertes Onboarding, Risikoprüfung anhand verifizierter Credentials und Deckungsnachweis.
- Gesundheitswesen – Identifizierung von Patienten und Ärzten, der Europäische Gesundheitsdatenraum, grenzüberschreitende Versorgung und die digitale EHIC.
- Bildung – Wallet-Akzeptanz für Institutionen, Ausstellung von Diplomen und Micro-Credentials in Wallets und die Anbindung an Europass und European Digital Credentials.
- Telekommunikation – Kunden-Onboarding und SIM-Registrierung, grenzüberschreitende Anmeldung sowie Schutz vor SIM-Swap und Portierung.
- Verkehr & Mobilität – Der EU-Führerschein in der EUDI-Wallet, Verifizierung von Führerscheinen und Berechtigungen in Sekunden sowie digitale Travel Credentials.
- Energie & Versorgungswirtschaft – Schnelleres Kunden-Onboarding, Nachweis der Anspruchsberechtigung für Förderungen und Ausstellung eines Versorgungsnachweises.
- Post- & Lieferdienste – Online-Identifizierung, Verifizierung von Empfängern bei Abholung und Übergabe sowie altersbeschränkte Lieferungen.
- Sehr große Online-Plattformen – Was die Pflicht zur Wallet-Akzeptanz verlangt, verifizierte Konten für Personen und Unternehmen, Altersüberprüfung und Händlerverifizierung.
Das vollständige Bild finden Sie in unserem eIDAS 2 Hub.
WeBuild-Pilot-Zahlungsdemo auf der GDC
Im Rahmen der GDC-Konferenz haben wir gemeinsam mit Authologic, Visa und Mastercard kommende WeBuild-Pilot-Use-Cases für Zahlungen demonstriert, wobei walt.id als Wallet-Anbieter fungierte.
Die Demo zeigt:
- DPC- & mDL-Ausstellung
- Zahlungsauthentifizierungen & Altersprüfung
unter Verwendung des Cross-Device-Flows (Mobiltelefon & Desktop) und der Digital Credentials API.
Sehen Sie die Demo auf LinkedIn
PS: Wenn Sie gerne mit unseren Tools arbeiten, hinterlassen Sie uns doch einen ⭐ auf GitHub