OpenID4VP-Verifier-Leitfaden – mit DCQL-Beispielen für SD-JWT VC
Diese Seite ist für Entwickler, die einen eigenen Verifier (Relying Party) bauen und möchten, dass die CodeB Wallet dessen Anfragen beantwortet. Sie nennt, was die Wallet prüft, bevor sie eine Anfrage zeigt, und gibt DCQL-Abfragen, wie sie unser eigener Demo-Verifier sendet – kopieren Sie sie und ändern Sie den Typ. Wenn Ihre Anwendung lieber beim normalen OpenID Connect bleibt, übernimmt das CodeB EUDI Gateway all das für Sie.
Die Anfrage: per Verweis, signiert, mit Ihrem Zugangszertifikat
openid4vp://?client_id=x509_hash:<hash of your certificate>
&request_uri=https://verifier.example/request/abc
&request_uri_method=post- Der Link oder QR-Code trägt
client_idundrequest_uri. Mitrequest_uri_method=postholt die Wallet die Anfrage per POST und sendet einewallet_nonce; Ihr Request-Objekt muss denselben Wert tragen. - Das Request-Objekt ist ein signiertes JWT (
typoauth-authz-req+jwt, zum Beispiel ES256) mit Ihrer Zertifikatskette inx5c. client_idverwendet das Präfixx509_hash:(der Hash Ihres Zertifikats) oderx509_san_dns:(ein DNS-Name darin).- Das Zertifikat muss zu einer Zugangszertifikats-CA auf einer Vertrauensliste führen. Sonst lehnt die CodeB Wallet die Anfrage ab und gibt nichts weiter.
- Legen Sie Ihr Registrierungszertifikat in
verifier_info. Die Wallet vergleicht, was Sie fragen, mit dem, wofür Sie registriert sind, und warnt die Person, wenn Sie mehr verlangen.
DCQL-Beispiele (Digital Credentials Query Language)
OpenID4VP 1.0 beschreibt in DCQL, wonach Sie fragen; das ältere Format Presentation Exchange gehört nicht mehr dazu. Jede Abfrage nennt ein Format, die akzeptierten Typen (vct_values) und die Angaben als Pfade. Fragen Sie nur nach dem, was Sie brauchen – die Person sieht jede Angabe, bevor sie teilt.
{
"credentials": [{
"id": "age",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:eudi:pid:de:1"] },
"claims": [ { "path": ["age_equal_or_over", "18"] } ]
}]
}{
"credentials": [{
"id": "city",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:eudi:pid:1", "urn:eudi:pid:de:1"] },
"claims": [ { "path": ["address", "locality"] } ]
}]
}{
"credentials": [{
"id": "name",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["urn:eudi:pid:1", "urn:eudi:pid:de:1"] },
"claims": [ { "path": ["given_name"] }, { "path": ["family_name"] } ],
"trusted_authorities": [ { "type": "aki", "values": ["<key identifier of an issuer CA you accept>"] } ]
}]
}{
"credentials": [{
"id": "member",
"format": "dc+sd-jwt",
"meta": { "vct_values": ["https://issuer.example/vc/member-card/1.0"] },
"claims": [ { "path": ["member_number"] }, { "path": ["member_name"] } ]
}]
}Verschachtelte Werte sind Pfade: ["address", "locality"] ist der Ort in der Adresse. Mit trusted_authorities nennen Sie die Aussteller, die Sie akzeptieren; Karten anderer Aussteller werden der Person nicht angeboten.
Die Antwort
- Mit
response_modedirect_postsendet die Wallet die Antwort an Ihreresponse_uri. Mitdirect_post.jwtist die Antwort für den Schlüssel in Ihrenclient_metadataverschlüsselt. - Je Abfrage erhalten Sie eine Präsentation: das SD-JWT VC nur mit den gefragten Offenlegungen und ein Key-Binding-JWT über Ihre
nonceund Ihreclient_id. - Prüfen Sie die Signatur des Ausstellers und seinen Platz auf den Vertrauenslisten, Gültigkeit und Status, das Key Binding und die Nonce. Behalten Sie dann nur, was Sie brauchen.
Formate und Abläufe
- Formate: SD-JWT VC (
dc+sd-jwt) und ISO mdoc (mso_mdoc). - Cross-Device-Ablauf: ein QR-Code am Computer, mit dem Telefon gescannt. Same-Device-Ablauf: ein Link oder eine Schaltfläche auf dem Telefon, die die Wallet öffnet.
- Digital Credentials API im Browser: Eine signierte Anfrage muss Ihre Website in
expected_originsnennen.
Ihren Verifier mit der CodeB Wallet testen
Installieren Sie die CodeB Wallet (geschlossene Beta), eröffnen Sie ein kostenloses CodeB-Konto für eine Test-PID und richten Sie Ihren Verifier auf die Wallet. Die Anwendungsbeispiele zeigen, wie solche Anfragen für die Person aussehen.
Ein Verifier mit einem Testzertifikat, das auf keiner Vertrauensliste steht, wird abgelehnt. Für solche Tests hat die App einen Schalter für Tester; wie Sie ihn bekommen, steht auf der Seite zum öffentlichen EUDI-Test-Playground.