Blog
Produkt-Update #32
Community & Enterprise Stack V1, OID4VCI/VP V1 und HAIP-Konformität und mehr
TL;DR
- Neues Release – Community & Enterprise Stack V1, Crypto2 und mehr.
- Events – OID4VCI/VP V1 und HAIP-Konformitätstests bestanden, France Identité Interop.
Einführung der V1-Editionen von Community und Enterprise Stack
Wir freuen uns, die V1 des walt.id Community und Enterprise Stack anzukündigen.
Entdecken Sie die neueste Version unserer Issuer-, Verifier- und Wallet-Produkte, die OID4VCI und OID4VP v1 in unseren beiden Stacks unterstützen:
Community Stack
Sie möchten einen End-to-End-Anwendungsfall für digitale Identitäten umsetzen? Entdecken Sie unser neues Tutorial hier.
Enterprise Stack
Sie möchten einen End-to-End-Anwendungsfall für digitale Identitäten umsetzen? Entdecken Sie unser neues Tutorial hier
Die Änderungen der einzelnen Stacks seit unserem letzten Release finden Sie unten.
Community Stack (1.0)
Nachfolgend finden Sie die Highlights aus Version 1.0 der identity lib. Das vollständige Änderungsprotokoll für v1.0 finden Sie hier. Möchten Sie mehr über die identity lib im Allgemeinen erfahren? Sehen Sie sich unser Intro-Video an.
1.0
Funktionen
Crypto V2
Wir freuen uns, crypto2 vorzustellen – die nächste Generation unserer crypto lib für den walt.id-Stack. Sie gestaltet die Schlüsselverwaltung grundlegend neu und erweitert die Multiplattform-Reichweite auf weitere Plattformen inkl. Android und iOS. Außerdem führt sie Coroutine-native APIs, versionierte Schlüsselpersistenz und austauschbare Software-, Geräte-, Remote-KMS- und HSM-Provider (PKCS#11) ein. Ein Migrationspfad für bestehende v1-Schlüssel ist verfügbar.
Mehr erfahren Sie hier.
Verbesserungen
Verifier2 / OpenID4VP
- Verifier2-Session-Bodys vereinheitlicht:
coreheißt jetzt für jeden Flowcore_flow, einschließlich DC API (#1821). - Rate-Limit-Konfiguration vereinheitlicht und auf die Protokoll-Endpunkte des Verifiers angewendet (#1994).
- Nonce-Binding für signierte Anfragen beim
request_uri-POST ergänzt (#2015). - Annex-Labels durch Protokollnamen für die Parameter zur Erstellung von Verifizierungs-Sessions ersetzt. DC-API-Sessions verwenden
dc_api_openid4vp(OpenID4VP Annex D) oderdc_api_18013_7(ISO 18013-7 Annex C). Für 18013-7 istrequestedElementseine Alternative zudcql_query. (#1821)
Die aktualisierte Verifier2-Dokumentation finden Sie hier.
Wallet API 2
- Isolierte Präsentations-Endpunkte hinzugefügt (Claims in der Vorschau anzeigen, ablehnen, dann erstellen/senden) (#1970). Mehr dazu erfahren Sie auch hier in unserer Dokumentation.
- Aussteller- und Anfrage-Metadaten mit empfangenen Credentials gespeichert (#1970).
- DID-Erstellung in Wallet2 erweitert (#1980).
- Typprofile für Transaktionsdaten in Wallet2 present/preview/build/send integriert, inklusive
urn:eudi:sca:payment:1, und die Route-Handler-Overloads von Wallet2 binärkompatibel gehalten (#2084, #2076, #2088). Mehr über die Transaktionsdaten-Profile erfahren Sie hier.
Die aktualisierte Wallet2-Dokumentation finden Sie hier.
Issuer / OpenID4VCI
- Stage- und Fehler-Events im gesamten OpenID4VCI-Ausstellungsablauf veröffentlicht, damit Integratoren Blockaden erkennen können (PIN, abgelehnte Wallet, unbrauchbare IdP-Antwort), statt auf den Ablauf der Session zu warten (#2080).
- Pre-authorized Grants atomar eingelöst, sodass eine zweite Token-Anfrage mit demselben Code
invalid_grantzurückgibt. Ein ungültigertx_codeverbraucht den Grant nicht (#2074) (Legacy Issuer, issuer2 enthielt diese Funktionalität bereits) - Verbliebene
c_nonce-Kompatibilitätspfade von issuer2 entfernt (#2010). - EdDSA zu den standardmäßigen
proofSigningAlgValuesSupportedhinzugefügt (#2008).
Die aktualisierte Issuer2-Dokumentation finden Sie hier.
Trust Registry
- Unterstützung für ETSI TS 119 612 nationale TSL und EU LoTL XML, Source-Assurance-/Acceptance-Policies und offizielle Schema-Validierung hinzugefügt. Legacy-Pilotformate von walt.id (JSON/XML) entfernt (#1931).
Crypto / KMS / X.509
- Umstellung auf Crypto2 im gesamten Stack (KMS, Signierung des Credential-Status, Protokoll-Crypto) und ABI-Baselines für Nicht-Android-Builds angeglichen. Lokal gespeicherte v1-JWK-Schlüssel werden automatisch migriert; Remote-KMS-Schlüssel bleiben auf ihren Cloud-Backends (#1954, #2044).
- Azure Key Vault-/Externe-KMS-URLs werden nicht mehr als JWT-, JAR-, JWKS- oder DID-
kid-Werte veröffentlicht; öffentliche Identifikatoren sind JWK-Thumbprints oder DID-URL-Fragmente (#2031). - Die EC-
signRaw-Ausgabe von Azure Key Vault auf ASN.1 DER normalisiert, passend zu allen anderen Crypto-Backends (#2072). - Eine X.509-Zertifikat-Bibliothek zum Erstellen und Signieren von CSRs und Zertifikaten hinzugefügt (#1901).
- Das CWT-Statuslisten-Label korrigiert (Label 16) (#2021).
- Klarere 400-Meldungen, wenn Request-Bodys nicht dekodiert werden können (#2014).
Breaking Changes
Verifier2 Session Create
flow_type: "dc_api"wurde entfernt. Verwenden Sie"dc_api_openid4vp"oder"dc_api_18013_7".- Das verschachtelte Konfigurationsfeld
coreheißt jetzt für alle Flowscore_flow. expectedOriginsmüssen HTTPS-Secure-Context-Origins sein (ohne abschließenden Schrägstrich).- Wird bei unsignierten Cross-Device-Sessions clientId weggelassen, wird jetzt redirect_uri:<response_uri> gesetzt. Signierte Anfragen müssen eine echte clientId angeben (nicht das Präfix redirect_uri:).
Legacy Issuer API
- Pre-authorized Codes ohne
tx_codesind einmalig verwendbar. Ein zweiter Token-Austausch gibtinvalid_grantzurück. POST /onboard/iso-mdl/document-signers:iacaSignererfordert das Root-CA-PEM (#1901).
Externes KMS / DID
- Veröffentlichte
kid-Werte sind Thumbprints / DID-URLs, keine Vault- oder KMS-Locator-URLs (#2031). - Neu ausgestellte did:jwk-JWTs verwenden kid {did}#0. Verifier akzeptieren weiterhin ältere kids ohne #0 (#2115, #2136).
Zertifikate
- mdoc- und SD-JWT-Profile teilen sich kein End-Entity-Zertifikat mehr. mdoc verwendet ein Document-Signer-Leaf; SD-JWT verwendet ein separates Leaf. IACA bleibt ein Verifier-Vertrauensanker und ist nicht Teil der
x5Chain(#2118).
Enterprise Stack (1.0)
Nachfolgend finden Sie die Highlights der neuen Funktionen aus Version 1.0 des Enterprise Stack. Das vollständige Änderungsprotokoll für 1.0 finden Sie hier. Möchten Sie mehr über den Enterprise Stack im Allgemeinen erfahren? Sehen Sie sich unser Intro-Video an.
1.0
Funktionen
Wallet2 als Standard-Wallet
Die Funktionen von Wallet2 sind jetzt unter den /v2-Pfaden verfügbar. Die Updates umfassen:
- Enterprise UI und Protokoll-Routen auf Wallet2 unter
/v2/{target}/wallet-service-api/...migriert. - Isolierte Präsentationsschritte hinzugefügt (Claims in der Vorschau anzeigen, ablehnen, dann erstellen/senden).
- Unterstützung für
urn:eudi:sca:payment:1-Transaktionsdaten, autorisierte mdoc-Datentypen und die Discovery von Wallet2-Transaktionsdaten-Profilen hinzugefügt.
Die neue Wallet2-Dokumentation finden Sie hier
Verifier2
- Die Bodies zur Erstellung von Verifizierungs-Sessions über alle Flow-Typen hinweg angeglichen, einschließlich Digital Credentials API.
- Die gemeinsame Rate-Limit-Konfiguration auf die Protokoll-Endpunkte des Verifiers angewendet.
Die aktualisierte Verifier2-Dokumentation finden Sie hier
Issuer2
- Stage- und Fehler-Events im gesamten OpenID4VCI-Ausstellungsablauf veröffentlicht, damit Integratoren erkennen können, warum die Ausstellung ins Stocken geraten ist.
- EdDSA zu den standardmäßigen
proofSigningAlgValuesSupportedhinzugefügt. - Verbliebene
c_nonce-Kompatibilitätspfade entfernt.
Die aktualisierte Issuer2-Dokumentation finden Sie hier
PKCS#11-Unterstützung
Speichern und verwenden Sie Signaturschlüssel auf einem PKCS#11-Token über den Key Management Service des Enterprise Stack.
Mehr erfahren Sie hier.
eIDAS-2-Audit-Logging
Das eIDAS Audit Log erfasst Konformitätsnachweise für die Ausstellung von Credentials und die Verifizierung von Präsentationen im Enterprise Stack.
Mehr erfahren Sie hier.
Lizenzierung
Der Enterprise Stack erfordert für den Betrieb jetzt eine aktive Lizenz. Wählen Sie eine Online-Aktivierung über ein OpenID Credential Offer oder ein Offline-.waltlicense-Bundle für vom Netz getrennte Umgebungen. Der neue Endpunkt /license/status gibt Superadmins Einblick in Aktivierungsstatus, Berechtigungen und Ablaufdatum.
Mehr erfahren Sie hier.
Allgemein
- Ein Endpunkt zur Auflistung aller unterstützten Berechtigungen hinzugefügt. Mehr erfahren Sie hier.
- Die Superadmin-Registrierung verwendet jetzt ein typisiertes Request-Objekt. Mehr erfahren Sie hier.
Crypto / KMS / X.509
- KMS, Signierung des Credential-Status (CWT/JWT/W3C), Client-Attestierung und die Crypto-Funktionen von Issuer2/Verifier2/Wallet2 auf die neue Crypto2-Bibliothek umgestellt.
- Lokal gespeicherte v1-JWK-Schlüssel werden automatisch migriert; Remote-KMS-Schlüssel bleiben über den Enterprise-KMS-Adapter angebunden.
- PKCS#11-/HSM- und Cloud-KMS-Pfade laufen auf den Crypto2-Backends.
- Veröffentlichte JWT-/JAR-/JWKS-/DID-
kid-Werte für externe KMS-Schlüssel sind JWK-Thumbprints oder DID-URLs, keine Cloud-KMS-Locator-URLs. - X.509-Zertifikat-Helfer hinzugefügt (CSR und Zertifikat erstellen/signieren). Das Onboarding von ISO-mDL-Document-Signern erfordert das IACA-Root-CA-PEM.
Fixes und Verbesserungen
- Token-Exchange-Fehler von Wallet2 werden auf den vorgelagerten OAuth-Status (oder
502) abgebildet statt auf ein generisches500. - Freundlichere 400-Meldungen, wenn Request-Bodys nicht dekodiert werden können.
- Beibehaltene KMS-Schlüssel werden bei der erneuten Signierung von
request_uri-POST-Anfragen des Verifiers nun berücksichtigt. - Das Content-Type-Label der CWT-Statusliste korrigiert (Label 16).
Breaking Changes
Prüfen Sie diese Änderungen vor dem Upgrade. Legacy-Protokollrouten der v1 können, wo angegeben, weiterhin über Feature-Flags aktiviert werden.
Lizenz für den Betrieb erforderlich
Die Enterprise API verarbeitet ohne aktive Lizenz keinen Datenverkehr. Knoten ohne Lizenz oder mit eingeschränkter Lizenz geben auf allen Routen 503 zurück, mit Ausnahme von /livez, Login/Logout, GET /license/status und dem Export von Nutzungsberichten. Mehr dazu erfahren Sie hier.
Legacy-Services standardmäßig deaktiviert
- Die Protokollrouten von Issuer v1, Verifier v1 und Wallet v1 sind deaktiviert, sofern nicht das entsprechende Feature-Flag aktiviert ist (
wallet-draft-routesfür Wallet1). - Neue Deployments sollten Issuer2, Verifier2 und Wallet2 verwenden.
Wallet
init-wallet entfernt
- Alt:
POST /v1/{org}.{tenant}/wallet-service-api/init-wallet - Neu:
POST /v1/{org}.{tenant}/resource-api/services/initmit einem komponierbarenwallet-Payload (optional KMS, DID-Store/-Service, Credential-Store). - Die Antwort ist ein
wallet-Ergebnisobjekt. Der Servicetyp istwallet2, nichtwallet.
Protokollrouten nach /v2 verschoben
- Die Routen von Wallet2 für Empfang, Präsentation, Client Attestation und Abhängigkeiten liegen unter
/v2/{target}/wallet-service-api/..., nicht unter/v1. - Beispiele:
.../credentials/receive/pre-authorized,.../credentials/present,.../client-attestation/obtain.
Empfangs-Body und Antwort
useClientAttestationundrunPoliciessind keine Request-Felder mehr. Die Client Attestation wird automatisch verwendet, wenn der Aussteller sie ankündigt und die Wallet einen verknüpften Client Attester hat.- Geben Sie
offerUrl(oderofferJson) sowie optionalkeyReference/didan. - Die Antwort ist ein Objekt
{ "credentialIds": [...], "deferredTransactionIds": {} }, kein Array gespeicherter Credentials.
Präsentations-Body
didReferenceheißt jetztdid(Inline-DID-String oder DID-Store-Referenz).- Der Present-Endpunkt für den vollständigen Ablauf akzeptiert kein
credentials-Array mehr; er führt ein DCQL-Matching aus dem Credential-Store der Wallet durch. - Um Inline-Credentials zu präsentieren, verwenden Sie
POST /v2/{wallet}/wallet-service-api/credentials/present/isolated.
Verifier2
Protokollrouten nach /v2/.../verifier-service-api verschoben
- Alt:
/v1/{target}/verifier2-service-api/{endpoint} - Neu:
/v2/{target}/verifier-service-api/{endpoint} - Das Anlegen des Service ist unverändert:
POST /v1/{target}/resource-api/services/createmit"type": "verifier2".
Body der DC-API-Session
flow_type: "dc_api"wurde entfernt. Verwenden Sie"dc_api_openid4vp"oder"dc_api_18013_7".- Das verschachtelte Konfigurationsfeld heißt
core_flow, nichtcore. expectedOriginsmüssen HTTPS-Origins im Secure Context sein (ohne abschließenden Schrägstrich). Lokale HTTP-Origins werden abgelehnt.
Client ID
- Wird
clientIdbei unsignierten Cross-Device-Sessions weggelassen, wird jetztredirect_uri:<response_uri>gesetzt. Signierte Anfragen müssen eine echteclientIdangeben.
DID-Service
- Die Felder
keyId/keyIdSetzum Anlegen einer DID heißen jetztkeyReference/keyReferenceSet. - Sie können anstelle einer Referenz auf einen gespeicherten Schlüssel einen Inline-
key(JWK) übergeben. - URLs unverändert (
POST /v1/{did-service}/did-service-api/dids/create/key|jwk|web).
Superadmin-Registrierung
- Das Registrierungstoken ist kein reiner String mehr. Senden Sie:
{
"token": "superadmin-token"
}
Service-Abhängigkeiten
POST .../dependencies/addakzeptiert keinen reinen Pfad-String mehr. Senden Sie:
{
"dependency": "org.tenant.kms"
}
Dev-Setup
POST /v1/admin/initial-setupwurde entfernt. Verwenden SiePOST /v1/dev/initial-setup(erfordert das Featuredev-mode).
Data Retention Service entfernt
- Der Ablauf von Sessions und OAuth-Artefakten wird über data ejection / TTLs gesteuert. Entfernen Sie Konfiguration und Aufrufe des Data Retention Service. Mehr dazu erfahren Sie hier.
Externe KMS-Key-IDs
- Veröffentlichte
kid-Werte in JWT, JAR, JWKS und DID-Dokumenten sind Thumbprints oder DID-URLs, keine Vault-/KMS-Locator-URLs.
Onboarding des ISO-mDL-Document-Signers
iacaSignererfordert das PEM der IACA-Root-CA.
X.509-Zertifikatsspeicher
PUT /v1/{target}/x509-store-api/certificatesfügt ein oder aktualisiert und gibt das Zertifikat zurück.POST /v1/{target}/x509-store-api/certificatesfügt nur ein und schlägt fehl, wenn die Zertifikats-ID bereits existiert.- Der Speicher validiert das Zertifikat nicht mehr.
typewird ignoriert. Verwenden Sie für VICAL-Einträgemetadataanstelle des veraltetencomplementaryMetadata.
eIDAS-Audit
- Das dauerhafte eIDAS-Audit-Log ist deaktiviert, sofern nicht das Feature
eidas-auditaktiviert ist. Bei deaktiviertem Feature fehlen die Audit-HTTP-Routen.
Zertifikate
- Die mdoc- und SD-JWT-Ausstellungsbeispiele/-profile teilen sich kein gemeinsames End-Entity-Zertifikat mehr. mdoc verwendet ein Document-Signer-Leaf, SD-JWT ein separates Leaf. Die IACA bleibt ein Vertrauensanker für den Verifier und ist nicht Teil der `x5Chain
OID4VCI/VP V1 & HAIP-Konformität
Unser neuester Verifier und Issuer haben die offiziellen Konformitätstests für OpenID4VCI, OpenID4VP und die OpenID4VC-HAIP-Profile erfolgreich bestanden.
Unsere Wallet-APIs und unser SDK bestehen ebenfalls die offiziellen Konformitätstests für OpenID4VCI und OpenID4VP sowie ausgewählte Testpläne für OpenID4VC HAIP (die Unterstützung wird in künftigen Releases erweitert).
walt.id x France Identité Wallet
Der walt.id Verifier funktioniert jetzt mit der France Identité Wallet. Verifizieren Sie PIDs und Age-Verification-Credentials. Mehr dazu erfahren Sie im France-Identité-Marketplace hier.
PS: Wenn Sie gerne mit unseren Tools arbeiten, hinterlassen Sie uns doch einen ⭐ auf GitHub