← Alle Beiträge

Blog

Produkt-Update #32

25. August 2026

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: core heißt jetzt für jeden Flow core_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) oder dc_api_18013_7 (ISO 18013-7 Annex C). Für 18013-7 ist requestedElements eine Alternative zu dcql_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_grant zurückgibt. Ein ungültiger tx_code verbraucht 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 proofSigningAlgValuesSupported hinzugefü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 core heißt jetzt für alle Flows core_flow.
  • expectedOrigins mü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_code sind einmalig verwendbar. Ein zweiter Token-Austausch gibt invalid_grant zurück.
  • POST /onboard/iso-mdl/document-signers: iacaSigner erfordert 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 proofSigningAlgValuesSupported hinzugefü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 generisches 500.
  • 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-routes fü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/init mit einem komponierbaren wallet-Payload (optional KMS, DID-Store/-Service, Credential-Store).
  • Die Antwort ist ein wallet-Ergebnisobjekt. Der Servicetyp ist wallet2, nicht wallet.

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

  • useClientAttestation und runPolicies sind 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 (oder offerJson) sowie optional keyReference / did an.
  • Die Antwort ist ein Objekt { "credentialIds": [...], "deferredTransactionIds": {} }, kein Array gespeicherter Credentials.

Präsentations-Body

  • didReference heißt jetzt did (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/create mit "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, nicht core.
  • expectedOrigins müssen HTTPS-Origins im Secure Context sein (ohne abschließenden Schrägstrich). Lokale HTTP-Origins werden abgelehnt.

Client ID

  • Wird clientId bei unsignierten Cross-Device-Sessions weggelassen, wird jetzt redirect_uri:<response_uri> gesetzt. Signierte Anfragen müssen eine echte clientId angeben.

DID-Service

  • Die Felder keyId / keyIdSet zum Anlegen einer DID heißen jetzt keyReference / 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/add akzeptiert keinen reinen Pfad-String mehr. Senden Sie:
{
  "dependency": "org.tenant.kms"
}

Dev-Setup

  • POST /v1/admin/initial-setup wurde entfernt. Verwenden Sie POST /v1/dev/initial-setup (erfordert das Feature dev-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

  • iacaSigner erfordert das PEM der IACA-Root-CA.

X.509-Zertifikatsspeicher

  • PUT /v1/{target}/x509-store-api/certificates fügt ein oder aktualisiert und gibt das Zertifikat zurück.
  • POST /v1/{target}/x509-store-api/certificates fügt nur ein und schlägt fehl, wenn die Zertifikats-ID bereits existiert.
  • Der Speicher validiert das Zertifikat nicht mehr. type wird ignoriert. Verwenden Sie für VICAL-Einträge metadata anstelle des veralteten complementaryMetadata.

eIDAS-Audit

  • Das dauerhafte eIDAS-Audit-Log ist deaktiviert, sofern nicht das Feature eidas-audit aktiviert 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.

Video ansehen


PS: Wenn Sie gerne mit unseren Tools arbeiten, hinterlassen Sie uns doch einen ⭐ auf GitHub