Blog
Produkt-Update #34
Key Attestation, Batch-Ausstellung in Wallet2, verpflichtender PAR und mehr
TL;DR
- Neues Release – Key Attestation, Batch-Ausstellung in Wallet2, verpflichtende PAR und mehr
- walt.id Verifier x Google Wallet – Demo, die das Anfordern eines digitalen Credentials aus der Google Wallet zeigt
Community Stack (1.2.0)
Im Folgenden finden Sie die Highlights aus Version 1.2.0 der Identity Lib. Das vollständige Änderungsprotokoll für 1.2.0 finden Sie hier. Möchten Sie mehr über die Identity Lib im Allgemeinen erfahren? Sehen Sie sich unser Intro-Video an.
1.2.0
Features
Key Attestations in Issuer2 verpflichtend machen
Issuer2 kann jetzt eine Key Attestation verifizieren, die in einem JWT Proof enthalten oder als eigenständiger Attestation Proof übermittelt wird. Legen Sie den vertrauenswürdigen Attester einmal in keyAttestationConfig mit einem öffentlichen JWK oder vertrauenswürdigen X.509-CA-Zertifikaten fest und machen Sie mit key_attestations_required eine Attestation für eine Credential-Konfiguration verpflichtend. Die OAuth-Client-Attestation bleibt eine separate Konfiguration.
Batch-Ausstellung in Wallet2
Wählen Sie aus, welche angebotenen Credentials Sie erhalten möchten, und fordern Sie mehrere Kopien eines Credentials an, die jeweils an einen eigenen Holder-Schlüssel gebunden sind. Kopien eines Credentials werden in einer einzigen Credential Request mit mehreren JWT Proofs ausgegeben, während unterschiedliche Credentials separate Anfragen bleiben. Ohne Auswahl erhält Wallet2 weiterhin jedes gewährte Credential einmal mit einem einzigen Holder Binding.
Pushed Authorization Requests (PAR) in Issuer2 erzwingen
Setzen Sie enforcePushedAuthorizationRequests in issuer-service.conf auf true, und Wallets müssen die Autorisierungsparameter am PAR-Endpoint einreichen, bevor sie den Authorization Endpoint aufrufen. Direkte Authorization Requests werden abgelehnt. Der Standardwert ist false, sodass bestehende Issuer weiterhin beides zulassen.
Signaturschlüssel für signierte Metadaten in Issuer2 wählen
Wählen Sie den Schlüssel und die Zertifikatskette, mit denen Issuer2 seine Credential-Issuer-Metadaten signiert. Dieselbe signedMetadata-Konfiguration signiert jetzt auch die Metadaten des OAuth Authorization Server. Lassen Sie sie weg, signiert Issuer2 die Credential-Issuer-Metadaten weiterhin mit seinem Token-Schlüssel.
Fixes und Verbesserungen
- Verifier2 akzeptiert eine IETF Token Status List, die mit demselben x5c-Leaf-Zertifikat wie das Credential signiert wurde, zusätzlich zu übereinstimmenden DID- und https-Ausstellern. #2272
- Verifier2 verwendet eine abgerufene Statusliste wieder, solange deren
Cache-Control: max-ageaktuell ist. #2327 - W3C-Credentials, deren
@contextURLs mit Inline-JSON-LD-Objekten mischt, wie es bei Gaia-X-Credentials der Fall ist, schlagen beim Import oder bei der Ausstellung nach VC Data Model 2.0 nicht mehr fehl. #2344 - DCQL
type_valuesstimmen jetzt nach der JSON-LD-@context-Expansion mit W3C-Typen überein, sodass eine Abfrage nach einer expandierten IRI mit einem kompakten Typ wiegx:LegalPersonübereinstimmt. Kompakte Werte wieVerifiableCredentialstimmen weiterhin überein. #2345 - Wallet2 akzeptiert wieder
jwt_vc_json-ld- undjwt_vc-Credentials. JWT-gesicherte W3C-Credentials werden weiterhin alsjwt_vc_jsongespeichert. #2378 - Eine Presentation wird mit dem Holder-Schlüssel signiert, der für dieses Credential gespeichert ist. Das Senden eines anderen Schlüssels schlägt fehl, bevor der Verifier den Proof sieht, während eine OpenID4VP-Anfrage weiterhin mehrere Credentials anfordern kann, die an unterschiedliche Schlüssel gebunden sind. #2336
- Credential-Antworten von Issuer2 werden mit
Cache-Control: no-storegekennzeichnet, und iOS-Wallets umgehen den HTTP-Cache von Foundation für Credential-Antworten. #2299 - Zeitstempel von Authorization- und Credential-Anfragen werden immer kodiert, sodass
requestedAtnicht mehr durch einen Uhrenvergleich im selben Tick verworfen wird. #2371 - Die Swagger-Beispiele von Issuer2 für Transaktionscode- und Runtime-Override-Angebote entsprechen dem JSON, das die API akzeptiert. #2334
- X.509-Zertifikats- und PKCS#10-CSR-Signaturen werden mit dem Algorithmus interpretiert, den das Objekt deklariert. #2322
- Ein Trust Store kann mehrere CAs mit demselben Subject-DN und unterschiedlichen Schlüsseln enthalten. Die Pfadvalidierung wählt die CA anhand des Schlüssels aus, und Zertifikate werden nicht mehr nur nach Seriennummer gespeichert. #2349
ktor-authnzverwendet eine Valkey-Verbindung für Session- und Token-Store. Fehlgeschlagene LDAP- und Web3-Logins liefern 401, und fehlgeschlagene Logins werden rate-limitiert. Opaque Tokens enden mit ihrer Session, ein verwendeter TOTP-Code wird innerhalb seines Gültigkeitsfensters abgelehnt, und neue OIDC-Konten erhalten eine zufällige Account-ID stattsub. #2310- Das erneute Öffnen einer mobilen Wallet initialisiert die DID-Resolver erneut, sodass eine signierte DID-Presentation-Anfrage nach einem Prozessneustart funktioniert. #2314
- Wenn ein Presentation-Fehler nicht sicher gemeldet werden kann, bleibt der ursprüngliche OpenID4VP-Fehler erhalten, statt durch den Meldefehler ersetzt zu werden. #2317
- TestFlight-Builds der nativen und der Compose-Wallet-Demos werden beim Anhalten der App nicht mehr beendet, weil sie eine SQLCipher-Shared-Memory-Sperre halten. #2346
- Eine überholte biometrische Signaturprüfung unter Android wird außerhalb des Main-Threads abgebrochen, sodass die Neuerstellung der Activity einen laufenden HTTP-Aufruf nicht mehr schließt. #2341
- Die Compose-Web-Wallet kann mit
WALLET_API_FLAVORundWALLET_API2_PUBLIC_URLauf die Enterprise Wallet API zugreifen. Die Open-Source-API bleibt der Standard. #2335 - Die Compose- und die native iOS-Demo-Wallet können eine Test-Key-Attestation für die bekannten ITB- und EUDI-Test-Issuer anhängen. Dies ist nur für die Demo gedacht. #2351
Enterprise Stack (1.2.0)
Im Folgenden finden Sie die neuen Feature-Highlights aus Version 1.2.0 des Enterprise Stack. Das vollständige Änderungsprotokoll für 1.2.0 finden Sie hier. Möchten Sie mehr über den Enterprise Stack im Allgemeinen erfahren? Sehen Sie sich unser Intro-Video an.
1.2.0
Features
Key Attestations in Issuer2 verpflichtend machen
Issuer2 kann jetzt eine Key Attestation verifizieren, die in einem JWT Proof enthalten oder als eigenständiger Attestation Proof übermittelt wird, und eine Credential-Konfiguration kann mit key_attestations_required eine solche verlangen. Legen Sie den vertrauenswürdigen Attester in keyAttestationConfig als öffentlichen JWK, als vertrauenswürdige X.509-Root-Zertifikate oder als KMS-Verifizierungsschlüssel fest.
Batch-Ausstellung in Wallet2
Ein einziger Receive-Aufruf kann angebotene Credential-Konfigurationen auswählen und mehrere Kopien anfordern, die jeweils an einen eigenen Holder-Schlüssel gebunden sind. Kopien eines Credentials werden als eine Credential Request mit mehreren JWT Proofs ausgegeben, während unterschiedliche Konfigurationen separate Anfragen bleiben. Eine einzige Holder Binding bleibt der Standard.
Pushed Authorization Requests (PAR) in Issuer2 erzwingen
Setzen Sie requirePushedAuthorizationRequests beim Erstellen oder Aktualisieren eines Issuer2-Service auf true, und Wallets müssen die Autorisierungsparameter zuerst am Pushed Authorization Endpoint einreichen. Direkte Authorization Requests werden mit invalid_request abgelehnt. Der Standardwert ist false, sodass bestehende Issuer weiterhin beides zulassen.
Signaturschlüssel für signierte Metadaten in Issuer2 wählen
Wählen Sie mit signedMetadata den Schlüssel, der die Credential-Issuer-Metadaten signiert: einen Inline-JWK, einen Inline-PEM-Schlüssel mit Zertifikatskette oder einen KMS-Schlüssel, optional mit x5c-Zertifikaten aus dem X.509-Store. Dieselbe Konfiguration signiert jetzt auch die Metadaten des OAuth Authorization Server. Lassen Sie sie weg, signiert Issuer2 die Credential-Issuer-Metadaten weiterhin mit tokenKeyId.
Wartungsmodus für Organisationen und Mandanten
Machen Sie eine Organisation oder einen einzelnen Mandanten für einen zeitlich begrenzten Zeitraum schreibgeschützt, während Lesezugriffe weiterhin funktionieren. Ein Zeitraum dauert standardmäßig 1 Tag und höchstens 30 Tage, und Sie können ihn vorzeitig beenden. Er ist deaktiviert, sofern das Feature maintenance nicht aktiviert ist, und Konten mit organization-management-maintenance-override, das in der Berechtigung all enthalten ist, können weiterhin schreiben.
Lebensdauer und Rollover von Statuslisten im Credential Status Service
Legen Sie ttl in Sekunden für eine IETF-Token-Status-List-Konfiguration fest. Das veröffentlichte Token verwendet sie, Objekte in S3, Azure Blob Storage und Google Cloud Storage erhalten ein passendes Cache-Control: public, max-age, und Verifier2 verwendet eine heruntergeladene Liste wieder, bis sie abläuft. Das Erstellen eines Statuseintrags gibt jetzt statusListRef zurück, also die Liste, die den neuen Index enthält, und nach einem automatischen Rollover müssen spätere Indexaktualisierungen diese Liste verwenden.
Fixes und Verbesserungen
- Der vorautorisierte Receive in Wallet2 auf DocumentDB schlägt nicht mehr mit einem Speicherfehler fehl, nachdem der Issuer das Credential bereits zurückgegeben hat.
- Gleichzeitige Receive-Vorgänge in eine Wallet2-Wallet wiederholen einen umkämpften Credential-Schreibvorgang, statt eine bereits erfolgreiche Ausstellung fehlschlagen zu lassen.
- Eine Presentation wird mit dem Holder-Schlüssel signiert, an den das Credential ausgestellt wurde. Ein anderer Schlüssel wird abgelehnt, bevor er gesendet wird.
- Das Widerrufen oder Lesen eines Statusindex funktioniert nach einem automatischen Rollover jetzt auf der Liste, die diesen Index enthält, und nicht auf der Basisliste, die frühere Einträge vergeben hat.
- Verifier2 akzeptiert eine externe IETF-Statusliste, deren
x5c-Leaf zum Credential passt. Von diesem Deployment gehostete Listen bleiben ebenfalls zulässig. - Credential-Antworten von Issuer2, einschließlich Fehlern vor dem Response Writer, senden
Cache-Control: no-store. - Das Löschen einer Organisation entfernt auch ihre Host-Aliase, Rolleneinträge auf Konten, Events und den OAuth-Zustand von Issuer2. Die Konten bleiben erhalten, und die eIDAS-Audit-Chain bleibt bestehen.
- Das Zuweisen einer Rolle zu einem Nutzer oder API-Schlüssel erfordert jede Berechtigung, die diese Rolle gewährt. Das Entfernen einer Deny-Regel erfordert die Berechtigung, die sie zurückgehalten hat, während das Entfernen einer Grant-Regel keine erfordert.
- Der Receive in Wallet2 setzt
clientIdstandardmäßig auf die Wallet-Client-ID, die die Wallet Library verwendet, sodass ein Authorization-Code-Austausch nicht mehr mit einer Client-Abweichung fehlschlägt. - Die OpenAPI-Beispiele von Issuer2 entsprechen den Request Bodies, die die API akzeptiert.
- Das Auflisten von Mandantenkonten prüft, ob der Mandantenpfad innerhalb der authentifizierten Organisation liegt.
- Die Admin-Organisationsliste berücksichtigt die angekündigten Paginierungsparameter und lehnt ungültige ab.
- Aktualisierungen der Organisations- und Mandantenkonfiguration validieren Organisations-IDs und DID-Registry-Referenzen und geben die dokumentierten Fehler zurück.
- Ein Fehler bei der Migrationsplanung, der beim Dokumentieren von PostgreSQL gefunden wurde, ist behoben, und Datenbankprofilfelder, die die API nie gelesen hat, sind als ungenutzt markiert. Das Verhalten der Profile ist ansonsten unverändert.
walt.id Verifier x Google Wallet
Diese Demo zeigt die Interoperabilität zwischen der walt.id Verifier API und Google Wallet.
Digital-ID-End-to-End-Tutorial
Ein praxisnahes End-to-End-Tutorial mit dem walt.id Community Stack, das zeigt, wie Issuer, Wallet und Verifier zusammenwirken, um digitale Credentials auszustellen, zu verwalten und zu verifizieren. Sie starten den Stack mit Docker Compose, stellen ein W3C Open Badge Credential über OID4VCI aus und fordern es mit OID4VP und Verification Policies an und verifizieren es.
PS: Wenn Sie gern mit unseren Tools arbeiten, hinterlassen Sie uns doch einen ⭐ auf GitHub