Blog
Produkt-Update Nr. 25
Hallo zusammen,
mit dem neuesten Release haben wir Unterstützung für die Pre-Auth-Transaktions-PIN in der Wallet API hinzugefügt, Onboarding-Endpunkte für IACA- und Document-Signer für die mDL-Ausstellung in der Issuer API ergänzt, eine neue Status-Policy eingeführt und vieles mehr.
Community Stack (v0.15.0/0.15.1)
Nachfolgend finden Sie alle Features, die über v0.15.0/0.15.1 der Identity Lib verfügbar sind. Das vollständige Änderungsprotokoll finden Sie hier und hier. Sie möchten mehr über die Identity Lib im Allgemeinen erfahren? Schauen Sie sich unser Intro-Video an.
Features
Wallet API
Unterstützung für Pre-Auth-Flow-Transaktions-PIN
Die Credential-Ausstellung akzeptiert jetzt einen optionalen pinOrTxCode-Parameter beim Aufruf von POST /exchange/useOfferRequest. Geben Sie bei Bedarf eine PIN oder einen Transaktionscode des Ausstellers an.
Erweiterung der Microsoft-Entra-ID-OIDC-Login-Verarbeitung
Die Wallet API versucht jetzt, einen Authorization Code gegen ein id_token einzulösen, wenn ein JWT nicht validiert werden kann, was die Kompatibilität mit Anbietern verbessert, die opake Tokens zurückgeben. Rund um OIDC-Login-Routen und Authentifizierungsabläufe wurde Trace-Logging ergänzt, um das Debugging zu erleichtern. Konfigurationsänderungen erfordern, dass publicBaseUrl in oidc.conf gesetzt ist; keycloakUserApi ist jetzt optional.
Unterstützung für die Signierung von Flattened JWS+Json
Der Endpunkt /keys/{keyId}/sign der Wallet API versteht jetzt Flattened-JWS-JSON-Payloads. Weitere Informationen in diesem PR hier.
Wallet UI
Credential-Anzeige
Die visuelle Darstellung der Credential-Karten wurde aktualisiert, um Aussteller-Logos anzuzeigen und Hintergrundbilder zu unterstützen.
Umgang mit mehreren passenden Credentials
Wenn mehrere Credentials desselben Typs zu einer Presentation Request passen, gruppiert die Web-Wallet sie jetzt und fordert Nutzer auf, eines auszuwählen.
Logik zum Löschen von Credentials
Das Löschen eines Credentials aus der Web-Wallet entfernt es standardmäßig dauerhaft (nutzt permanent=true).
Issuer API
IACA- und Document-Signer-Onboarding für die mDL-Ausstellung
Neue Onboarding-Endpunkte zum Erzeugen eines selbstsignierten Issuing-Authority-Certification-Authority-Zertifikats (Doku-Link) und zum Ausstellen von Document-Signer-Zertifikaten, die an eine IACA gebunden sind (Doku-Link).
Credential-Branding
Die Credential-Branding-Funktionen wurden erweitert. Aussteller-Metadaten können jetzt neben den bestehenden Logo- und Hintergrundfeldern ein optionales secondary_image angeben. Beispiel-Metadaten.
Verifier API
Status-Policy
Eine flexible Status-Policy zur Validierung gängiger Statustypen wie Widerruf oder Aussetzung, aber auch benutzerdefinierter Gründe auf Basis der Standards BitstringStatusList, StatusList2021, RevocationList2020 und TokenStatusList. Mehr erfahren Sie hier.
Fixes & Verbesserungen
EBSI-Umgebungs-Updates
Die DID-Auflösung funktioniert jetzt sowohl mit den Conformance- als auch den Pilot-Registries. Update zur Verarbeitung verschachtelter Deskriptor-Objekte bei der Presentation-Verifizierung. Links zu den PRs hier und hier.
Wallet UI
Die Wallet-Oberfläche kürzt lange Benutzernamen jetzt mit Auslassungspunkten und zeigt den vollständigen Namen beim Darüberfahren an. So werden Layout-Probleme bei ungewöhnlich langen Benutzernamen vermieden. Link zum PR.
Verbessertes Parsing von Presentation Definitions
Credentials, die Arrays enthalten, werden jetzt korrekt abgeglichen, wenn der Filter einen String-Typ angibt. Link zum PR.
Verarbeitung von SD-JWT-VC-Presentations
Der Verifier kann jetzt Presentations verarbeiten, die SD-JWT-Credentials direkt oder eingebettet in W3C-VPs enthalten. Link zum PR.
EBSI – IDToken-Antwort kann nicht signiert werden
Verbesserte Schlüsselauflösung: Das Signieren einer Nachricht akzeptiert jetzt eine Key-ID, einen DID oder eine Verification-Method-ID. Signaturen enthalten jetzt standardmäßig den JWT-Typ-Header und unterstützen teilweise gebildete JWS-JSON-Daten. Link zum PR.
Unterstützung mehrerer Schlüssel bei der DID-Auflösung
Die DID-Auflösungs-Bibliotheken und der Verifier verarbeiten jetzt DID-Dokumente mit mehreren Schlüsseln. Die Verifizierung von SD-JWT-Credentials und allgemeinen JWS-Signaturen iteriert über jeden aufgelösten Schlüssel, was die Kompatibilität mit DID-Dokumenten mit mehreren Schlüsseln verbessert. Link zum PR.
Parsing des SD-JWT-Credential-Formats
Die Bibliothek verarbeitet jetzt credential_format-Werte mit Leerzeichen (z. B. vc sd-jwt) zusätzlich zur Standarddarstellung vc+sd-jwt. Link zum PR.
Spezifikationsimplementierung für BitstringStatusList bei der Listenkodierung
Die Verifizierungs-Bibliothek unterscheidet jetzt korrekt zwischen regulären und Multibase-Base64-URL-Statuslisten. Link zum PR
Docs / Docker Compose
Erweiterung der mDoc-Lib-Dokumentation
Detaillierte Anleitung zur Kodierung des Widerrufsstatus mit IETF-Status- oder Identifier-Listen, neue Beispiele für NFC, BLE und Wi-Fi Aware zum Erzeugen und Parsen von DeviceEngagement-Strukturen sowie erweiterte Anleitungen zum Signieren von Dokumenten und zur Einbindung von Widerrufsdaten. Die Dokumentation finden Sie hier.
Docker Compose
Docker-Images referenzieren jetzt Versions- und Repository-Einstellungen aus der .env-Datei, sodass Sie Image-Quellen und Hostnamen ändern können, ohne docker-compose.yaml zu bearbeiten. Stellen Sie sicher, dass Sie die neuen Variablen IMAGE_PREFIX, SERVICE_HOST und die Versionsvariablen (VERSION_OPA, VERSION_VAULT, VERSION_VC_REPO) setzen, wenn Sie die Services ausführen. Link zum PR
Breaking Changes
SD-JWT-VC-Lib
Jeder Code, der SDJwtVC.sign(...), SDJwtVC.doSign(...) oder SDJwtVC.defaultPayloadProperties(...) aufruft, muss jetzt den status-Parameter als JsonObject? statt als String? übergeben.
Enterprise Stack (v0.7.0)
Nachfolgend finden Sie alle Features, die über v0.7.0 des Enterprise Stack verfügbar sind. Sie möchten mehr über den Enterprise Stack im Allgemeinen erfahren? Schauen Sie sich unser Intro-Video an.
Features
Holder-Policies für Silent Wallet Flows
Nutzen Sie Holder-Policies, damit Nutzer granulare Freigaberegeln für Credentials festlegen können, um eine einwilligungsbasierte Datenfreigabe bei Silent-Issuance- und -Verifizierungs-Flows zu gewährleisten. Mehr erfahren Sie hier.
Neue Status-Policy im Verifier Service
Eine flexible Status-Policy zur Validierung gängiger Statustypen wie Widerruf oder Aussetzung, aber auch benutzerdefinierter Gründe auf Basis der Standards BitstringStatusList, StatusList2021, RevocationList2020 und TokenStatusList. Mehr erfahren Sie hier.
Unterstützung für nicht ablaufende Ausstellungssitzungen
Die Issuer Service API ermöglicht jetzt die Erstellung nicht ablaufender Ausstellungssitzungen. Wenn Sie POST /issuer-service-api/credentials/issue aufrufen, können Sie die Sitzung unbegrenzt aktiv halten, indem Sie den Parameter expiresInSeconds: -1 angeben. Wenn Sie eine Sitzung mit einer bestimmten Dauer bevorzugen, können Sie die gewünschte Länge in Sekunden über den Parameter expiresInSeconds angeben. Standardmäßig läuft die Sitzung nach fünf Minuten ab, wenn dieser Parameter weggelassen wird.
Vereinfachte mDL-Ausstellung
Die mDL-Ausstellungsanfrage erfordert nicht mehr das Feld trustedRootCAs. Außerdem wurden die OpenAPI-Beispiele aktualisiert.
Erweiterung des Credential-Brandings
Aussteller können jetzt beim Einrichten eines Issuer Service ein sekundäres Bild für die Credential-Branding-Informationen angeben. Ein aktualisiertes Beispiel finden Sie in der SWAGGER-Dokumentation hier. Beispielname -> Create Issuer with credential branding information
Enterprise-UI-Updates
- Die Verwaltung der Service-Konfiguration im JSON-Format wurde für die folgenden Services implementiert: DID Registry, KMS, Status, Credential Store, DID Store, Verifier und Wallet.
- Verbesserte Verarbeitung von Authorization Requests bei der Präsentation von Credentials über die Wallet-Service-UI.
Fixes
Laden von SD-JWT-VC-Display-Informationen
Wenn Sie ein SD-JWT-VC-Credential über den Endpunkt credentials/issue des Issuer Service ausstellen, werden die Display-Informationen jetzt korrekt aus der Issuer-Service-Konfiguration abgerufen. Dies geschieht, wenn Sie keine Display-Informationen direkt in Ihrer Ausstellungsanfrage angeben.
Durchsetzung von Wallet-Service-Schlüsseln
Der Presentation-Flow der Wallet erzwingt nicht länger, dass Holder-Schlüssel vom Typ secp256r1 sein müssen. Anwendungen können jetzt Nicht-MDOC-Credentials mit anderen Schlüsseltypen präsentieren.
Docs
Verbesserte OpenAPI-Dokumentation
Jeder Endpunkt verfügt jetzt über klarere Beschreibungen, und die OpenID4VCI-Spezifikationen enthalten die standardVersion als Pfadparameter. Diese Updates stellen sicher, dass aus api.json generierte Clients das API-Verhalten korrekt widerspiegeln.
Community-Favoriten
How-To-Videoreihe
- How to Present SD-JWT VC Credentials from an ID Wallet
- How to Present W3C Credentials from an ID Wallet
- How to Receive SD-JWT VC Credentials in an ID Wallet
- How to Receive W3C Credentials in an ID Wallet
Community-Stack-Tutorial
In unserem neuesten Videotutorial lernen Sie, einen durchgängigen Digital-ID-Anwendungsfall mit dem walt.id Community Stack aufzubauen: Richten Sie eine Custodial Wallet ein, stellen Sie ein W3C-konformes University Degree Credential aus und speichern Sie es, und verifizieren Sie es sicher über die Issuer-, Wallet- und Verifier-APIs;
Feature-Liste & Roadmap
Übersicht – Produktfeatures heute und in Zukunft
PS: Wenn Sie gerne mit unseren Tools arbeiten, hinterlassen Sie uns doch einen ⭐ auf GitHub