Guide du vérificateur OpenID4VP – avec des exemples DCQL pour SD-JWT VC
Cette page s’adresse aux développeurs qui construisent leur propre vérificateur (partie utilisatrice) et veulent que CodeB Wallet réponde à ses demandes. Elle indique ce que le portefeuille vérifie avant d’afficher une demande et donne des requêtes DCQL du type de celles qu’envoie notre propre vérificateur de démonstration – copiez-les et changez le type. Si vous préférez garder OpenID Connect dans votre application, le CodeB EUDI Gateway fait tout cela pour vous.
La demande : par référence, signée, avec votre certificat d’accès
openid4vp://?client_id=x509_hash:<hash of your certificate>
&request_uri=https://verifier.example/request/abc
&request_uri_method=post- Le lien ou le code QR porte
client_idetrequest_uri. Avecrequest_uri_method=post, le portefeuille récupère la demande par POST et envoie unwallet_nonce; votre objet de demande doit porter la même valeur. - L’objet de demande est un JWT signé (
typoauth-authz-req+jwt, par exemple ES256) avec votre chaîne de certificats dansx5c. client_idutilise le préfixex509_hash:(l’empreinte de votre certificat) oux509_san_dns:(un nom DNS qu’il contient).- Le certificat doit mener à une autorité de certificats d’accès figurant sur une liste de confiance. Sinon, CodeB Wallet refuse la demande et ne partage rien.
- Placez votre certificat d’enregistrement dans
verifier_info. Le portefeuille compare ce que vous demandez avec ce pour quoi vous êtes enregistré et avertit la personne si vous demandez davantage.
Exemples DCQL (Digital Credentials Query Language)
OpenID4VP 1.0 décrit en DCQL ce que vous demandez ; l’ancien format Presentation Exchange n’en fait plus partie. Chaque requête nomme un format, les types acceptés (vct_values) et les attributs sous forme de chemins. Demandez le moins possible – la personne voit chaque élément avant de partager.
{
"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"] } ]
}]
}Les valeurs imbriquées sont des chemins : ["address", "locality"] est la ville dans l’adresse. Avec trusted_authorities, vous nommez les émetteurs que vous acceptez ; les cartes d’autres émetteurs ne sont pas proposées à la personne.
La réponse
- Avec
response_modedirect_post, le portefeuille envoie la réponse à votreresponse_uri. Avecdirect_post.jwt, la réponse est chiffrée pour la clé de vosclient_metadata. - Pour chaque requête, vous recevez une présentation : le SD-JWT VC avec les seules divulgations demandées et un JWT de liaison de clé portant votre
nonceet votreclient_id. - Vérifiez la signature de l’émetteur et sa présence sur les listes de confiance, la validité et le statut, la liaison de clé et le nonce. Ne gardez ensuite que ce dont vous avez besoin.
Formats et parcours
- Formats : SD-JWT VC (
dc+sd-jwt) et ISO mdoc (mso_mdoc). - Parcours cross-device : un code QR sur un ordinateur, scanné avec le téléphone. Parcours same-device : un lien ou un bouton sur le téléphone qui ouvre le portefeuille.
- Digital Credentials API dans le navigateur : une demande signée doit nommer votre site dans
expected_origins.
Tester votre vérificateur avec CodeB Wallet
Installez CodeB Wallet (bêta fermée), ouvrez un compte CodeB gratuit pour obtenir un PID de test et dirigez votre vérificateur vers le portefeuille. Les démonstrations montrent comment ces demandes apparaissent à la personne.
Un vérificateur dont le certificat de test ne figure sur aucune liste de confiance est refusé. Pour ces tests, l’app a un réglage réservé aux testeurs ; la page sur le playground de test EUDI public explique comment l’obtenir.