DCQL lahti seletatuna: kuidas kontrollija küsib rahakotilt täpselt seda, mida vajab
DCQL ehk Digital Credentials Query Language on kokkulepitud viis, kuidas organisatsioon ütleb rahakotile, milliseid tõendeid ja milliseid andmeid nende sees ta vajab. Just see muudab päringu nagu "tõenda, et sinu ettevõte on registreeritud Madalmaades" millekski, mida iga nõuetele vastav rahakott mõistab, ilma iga rahakoti jaoks eraldi liidestust tegemata.
Probleem, mida DCQL lahendab
Ärirahakott sisaldab paljusid eri liiki tõendeid, mille on välja andnud erinevad asutused eri riikides ja mis on salvestatud erinevates tehnilistes vormingutes. Organisatsioonil, kes peab kinnitama ainult registrikoodi ja ametliku nime, ei ole ülekantavat viisi täpselt seda küsida. Lõpuks võtab ta kas kogu tõendi koos kõige muuga, mis selles on, või ehitab iga rahakoti jaoks eraldi liidestuse.
DCQL lahendab küsimise poole. Üks standardne päring nimetab soovitud tõendid ja konkreetsed andmed, mida igaühest soovitakse. Rahakott võrdleb seda sellega, mis valdajal tegelikult olemas on, näitab valdajale, mida küsitakse, ja avaldab ainult selle. Kontrollija saab prognoositava vastuse sõltumata sellest, millist rahakotti valdaja kasutab.
1. Kontrollija
Küsib täpselt neid tõendeid ja andmeid, mida ta vajab
2. Rahakott
Selgitab välja, millised salvestatud tõendid päringule vastavad
3. Omanik
Näeb, mida küsitakse, ja kinnitab ainult selle avaldamise
4. Kontrollija
Saab kinnitatud andmed ja mitte midagi enamat
Mida kontrollija saab küsida
Päring on lühike loetelu sellest, mida vajatakse. See võib nimetada üht või mitut tõendit ja iga tõendi puhul võib see nimetada konkreetseid soovitud andmeid terve tõendi asemel. Lisaks katavad kolm valikut peaaegu iga tegeliku juhtumi: varuvariandid, kombinatsioonid ja piirang selle kohta, millised väljaandjad on vastuvõetavad.
- Millised tõendid on vajalikud ja millised andmed igaühe sees.
- Vastuvõetavad varuvariandid eelistusjärjekorras nende valdajate jaoks, kellel ei ole kõike.
- Kombinatsioonid, nii et päring võib nõuda üht tõendit ja üht kahest muust.
- Piirang ametlikus usaldusnimekirjas olevatele väljaandjatele, nii et teiste tõendeid kunagi ei pakuta.
Varuvariandi küsimine
Kõigil valdajatel ei ole samu tõendeid. Kontrollija saab eelistusjärjekorras nimetada, mida ta eelistaks ja mida ta veel aktsepteeriks, ning rahakott kasutab parimat võimalust, mille valdaja tegelikult täita suudab. Nii välditakse teist päringuvooru ja seda, et klient saadetakse ära ainult seetõttu, et tal puudub üks meeldiv lisadetail.
1. Eelistatud
Kasutatakse, kui tõend sisaldab mõlemat
2. Varuvariant
Kasutatakse ainult siis, kui esimest võimalust täita ei saa
Siin eelistaks kontrollija registrikoodi koos ametliku nimega, kuid aktsepteerib ka ainult ametlikku nime, kui valdaja tõendil registrikoodi ei ole.
Tõendite kombineerimine ühes päringus
Kliendi vastuvõtmise kontrollid tuginevad harva ühele dokumendile. Kontrollija saab nõuda üht tõendit ja aktsepteerida selle kõrval kaht muud varianti, kõik ühes päringus, nii et valdaja annab nõusoleku korra ja kontrollija saab täieliku vastuse ühe sammuga.
Nõutud
Äriregistri andmed
Üks neist
KMKR registreering
Üks neist
Pangakonto kinnitus
Äriregistri kanne on nõutav. Lisaks sobib kas käibemaksukohustuslase registreering või pangakonto tõend ning valdajal peab olema neist ainult üks.
Ainult usaldusväärsete väljaandjate aktsepteerimine
Kontrollija saab päringut kitsendada tõenditele, mille väljaandja on ametlikus usaldusnimekirjas. Teiste tõendeid ei pakuta valdajale kunagi isegi mitte, nii et ise väljastatud järeletehtud tõend ei jõua kontrollini üldse.
Kontrollija ütleb: ainult väljaandjatelt, kes on ELi ametlikus usaldusnimekirjas
Registritõend nimekirjas olevalt väljaandjalt
Väljaandja on usaldusnimekirjas
✓ Valdajale pakutakse
Registritõend nimekirjast puuduvalt väljaandjalt
Väljaandjat usaldusnimekirjas ei ole
✗ Valdajale ei pakuta
See on filter rahakotis, mitte iseseisev garantii. Kontrollija kontrollib väljaandjat usaldusnimekirja suhtes ikkagi siis, kui ta saadut valideerib.
DCQL-i praegune seis
- DCQL on osa OpenID4VP spetsifikatsioonist endast, mitte eraldi dokument, ja see asendas varasema sõltuvuse DIF Presentation Exchange'ist.
- EUDI Wallet Architecture and Reference Framework nimetab esitamisprotokolliks OpenID4VP ja koos sellega DCQL-i, seega eeldatakse, et ökosüsteemi rahakotid ja kontrollijad seda toetavad.
- EUDI Wallet programmi etalonrahakotid ja -kontrollijad on koondunud DCQL-i ümber, seega peaks täna alustatud ärirahakoti liidestus lähtuma sellest, mitte vanemast alternatiivist.
Mida see sinu jaoks tähendab
Kontrollija
Üks päringuvorming katab kõik rahakotid ja sa saad ainult need andmed, mida küsisid, mis tähendab vähem andmeid, mida säilitada, kaitsta ja põhjendada.
Omanik
Sa näed enne nõusoleku andmist täpselt, mida küsitakse, ja midagi enamat sinu rahakotist ei lahku.
Väljaandja
Sinu väljastatud tõendid jäävad kasutatavaks ka osaliste kontrollide jaoks, nii et üks tõend võib teenida paljusid eri eesmärke.
Tehniline süvitsiminek
See leht selgitab, mida tehnoloogia teeb ja keda see puudutab. Meie arendajadokumentatsioon käsitleb teostust ennast: sõnumeid, välju ja läbitöötatud näiteid, mida liidestusmeeskond vajab.
Loe tehnilist dokumentatsiooniSeotud mõisted
Korduma kippuvad küsimused
Mille poolest erineb DCQL DIF Presentation Exchange'ist?
Mõlemad on viisid, kuidas kontrollija kirjeldab, mida ta rahakotilt soovib. Presentation Exchange on neist vanem ja laiem ning loodud töötama mitme protokolliga. DCQL on teadlikult väiksem ja määratletud OpenID4VP enda sees. EUDI Wallet ökosüsteem on standardinud DCQL-i, seega tuleb Euroopa turu jaoks planeerida just sellega.
Kas üks päring võib küsida rohkem kui üht tõendit?
Jah, ja see on üks põhjus, miks see olemas on. Kontrollija saab ühes päringus küsida äriregistri kannet ja pangakonto tõendit või aktsepteerida üht kahest alternatiivist ning valdaja kinnitab kõik ühe sammuga, selle asemel et temalt kaks korda küsitaks.
Mis juhtub, kui valdajal ei ole kõike, mida küsiti?
Kontrollija saab eelistusjärjekorras nimetada vastuvõetavad varuvariandid ja rahakott kasutab parimat, mille valdaja tegelikult täita suudab. Nii saab kontrollija küsida täpset registrikoodi seal, kus see on olemas, ja leppida ametliku nimega seal, kus seda ei ole, ilma teist päringut saatmata või valdajat ära saatmata.
Kas DCQL on mõeldud ainult EUDI Walleti jaoks?
Ei. DCQL on OpenID4VP osa ja seda saab kasutada iga selle protokolli teostus. EUDI Wallet ökosüsteem on silmapaistev kasutuselevõtja: Architecture and Reference Framework nimetab tõendite esitamise viisiks OpenID4VP koos DCQL-iga, mistõttu on see oluline igaühele, kes ehitab Euroopa turu jaoks.
Kas see aitab GDPR-i andmete minimeerimise nõude täitmisel?
See muudab miinimumi selgesõnaliseks. Päring ütleb, millised andmed on vajalikud, valdaja näeb seda loetelu enne nõusoleku andmist ja rahakott ei avalda midagi enamat. Nii muutub andmete minimeerimine lubatud põhimõttest piiranguks, mida andmevahetus ise jõustab, ja seda on palju lihtsam tõendada.
Allikad
See leht on informatiivne ega ole õigusnõuanne. Autoriteetsete juhiste saamiseks pöörduge otse OpenID Foundationi ja Euroopa Komisjoni poole.