Gwida għall-verifikatur OpenID4VP – b’eżempji DCQL għal SD-JWT VC
Din il-paġna hija għall-iżviluppaturi li jibnu l-verifikatur tagħhom stess (relying party) u jridu li CodeB Wallet twieġeb it-talbiet tiegħu. Telenka x’tiċċekkja l-kartiera qabel ma turi talba, u tagħti mistoqsijiet DCQL tat-tip li jibgħat il-verifikatur demo tagħna stess – ikkopjahom u ibdel it-tip. Jekk tippreferi żżomm OpenID Connect sempliċi fl-applikazzjoni tiegħek, is-CodeB EUDI Gateway jagħmel dan kollu għalik.
It-talba: b’referenza, iffirmata, biċ-ċertifikat tal-aċċess tiegħek
openid4vp://?client_id=x509_hash:<hash of your certificate>
&request_uri=https://verifier.example/request/abc
&request_uri_method=post- Il-link jew il-kodiċi QR iġorr
client_idurequest_uri. B’request_uri_method=postil-kartiera tiġbor it-talba b’POST u tibgħatwallet_nonce; l-oġġett tat-talba tiegħek irid iġorr l-istess valur. - L-oġġett tat-talba huwa JWT iffirmat (
typoauth-authz-req+jwt, pereżempju ES256) bil-katina taċ-ċertifikati tiegħek f’x5c. client_idjuża l-prefissx509_hash:(il-hash taċ-ċertifikat tiegħek) jewx509_san_dns:(isem DNS fih).- Iċ-ċertifikat irid iwassal għal awtorità taċ-ċertifikati tal-aċċess li tinsab fuq lista ta’ fiduċja. Jekk le, CodeB Wallet tirrifjuta t-talba u ma taqsam xejn.
- Poġġi ċ-ċertifikat tar-reġistrazzjoni tiegħek f’
verifier_info. Il-kartiera tqabbel dak li titlob ma’ dak li int irreġistrat għalih u twissi lill-persuna jekk titlob aktar.
Eżempji DCQL (Digital Credentials Query Language)
OpenID4VP 1.0 jiddeskrivi f’DCQL dak li titlob; il-format eqdem Presentation Exchange m’għadux parti minnu. Kull mistoqsija ssemmi format, it-tipi aċċettati (vct_values) u l-attributi bħala mogħdijiet. Itlob mill-inqas possibbli – il-persuna tara kull element qabel taqsam.
{
"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"] } ]
}]
}Il-valuri mnaqqxa huma mogħdijiet: ["address", "locality"] hija l-belt fl-indirizz. B’trusted_authorities issemmi l-emittenti li taċċetta; karti ta’ emittenti oħra ma jiġux offruti lill-persuna.
It-tweġiba
- B’
response_modedirect_postil-kartiera tibgħat it-tweġiba lir-response_uritiegħek. B’direct_post.jwtit-tweġiba tkun ikkriptata għaċ-ċavetta fil-client_metadatatiegħek. - Għal kull mistoqsija tirċievi preżentazzjoni waħda: l-SD-JWT VC bl-iżvelar mitlub biss u JWT tal-irbit taċ-ċavetta fuq in-
nonceu l-client_idtiegħek. - Iċċekkja l-firma tal-emittent u postu fuq il-listi ta’ fiduċja, il-validità u l-istatus, l-irbit taċ-ċavetta u n-nonce. Imbagħad żomm biss dak li teħtieġ.
Formati u flussi
- Formati: SD-JWT VC (
dc+sd-jwt) u ISO mdoc (mso_mdoc). - Fluss cross-device: kodiċi QR fuq kompjuter, skennjat bit-telefon. Fluss same-device: link jew buttuna fuq it-telefon li tiftaħ il-kartiera.
- Digital Credentials API fil-brawżer: talba ffirmata trid issemmi l-websajt tiegħek f’
expected_origins.
Ittestja l-verifikatur tiegħek b’CodeB Wallet
Installa CodeB Wallet (beta magħluqa), iftaħ kont CodeB b’xejn għal PID tat-test u ipponta l-verifikatur tiegħek lejn il-kartiera. Id-demos juru kif jidhru talbiet bħal dawn lill-persuna.
Verifikatur b’ċertifikat tat-test li mhu fuq l-ebda lista ta’ fiduċja jiġi rrifjutat. Għal testijiet bħal dawn l-app għandha swiċċ għat-testers; kif tiksbu jinsab fil-paġna dwar il-playground pubbliku tat-test EUDI.