Preskoči na glavno vsebino

DCQL razložen: kako preveritelj od denarnice zahteva natanko to, kar potrebuje

DCQL, Digital Credentials Query Language, je dogovorjen način, kako organizacija denarnici pove, katere poverilnice potrebuje in katere podatke v njih. Prav on zahtevo, kot je "dokažite, da je vaše podjetje registrirano na Nizozemskem", spremeni v nekaj, kar razume vsaka skladna denarnica, brez posebne integracije za vsako denarnico.

Težava, ki jo rešuje DCQL

Poslovna denarnica hrani poverilnice mnogih vrst, ki so jih izdali različni organi v različnih državah in so shranjene v različnih tehničnih oblikah. Organizacija, ki mora potrditi le matično številko in uradno ime, nima prenosljivega načina, da bi zahtevala točno to. Na koncu bodisi prevzame celotno poverilnico z vsem drugim, kar je v njej, bodisi za vsako denarnico, na katero naleti, zgradi posebno integracijo.

DCQL ureja stran zahteve. Ena sama standardna zahteva navede želene poverilnice in točno določene podatke, ki jih želi iz vsake. Denarnica jo primerja s tem, kar imetnik dejansko ima, imetniku pokaže, kaj se zahteva, in izda samo to. Preverjevalec dobi predvidljiv odgovor ne glede na to, katero denarnico imetnik uporablja.

1. Preveritelj

Zahteva točno tiste poverilnice in podatke, ki jih potrebuje

2. Denarnica

Ugotovi, katere shranjene poverilnice ustrezajo zahtevi

3. Imetnik

Vidi, kaj se zahteva, in potrdi izdajo samo tega

4. Preveritelj

Prejme potrjene podatke in nič več

Kaj lahko preverjevalec zahteva

Zahteva je kratek seznam tega, kar je potrebno. Navede lahko eno poverilnico ali več, pri vsaki pa lahko navede točno določene želene podatke namesto celote. Tri dodatne možnosti pokrijejo skoraj vsak dejanski primer: nadomestne možnosti, kombinacije in omejitev glede tega, kateri izdajatelji so sprejemljivi.

  • Katere poverilnice so potrebne in kateri podatki v vsaki od njih.
  • Sprejemljive nadomestne možnosti po vrstnem redu prednosti za imetnike, ki nimajo vsega.
  • Kombinacije, tako da zahteva lahko terja eno poverilnico in katero koli od dveh drugih.
  • Omejitev na izdajatelje z uradnega seznama zaupanja vrednih subjektov, tako da poverilnice kogar koli drugega nikoli niso ponujene.

Prošnja za nadomestno možnost

Vsak imetnik nima enakih poverilnic. Preverjevalec lahko po vrstnem redu navede, kaj bi imel najraje in kaj bi še sprejel, denarnica pa uporabi najboljšo možnost, ki jo imetnik dejansko lahko izpolni. S tem se izogne drugemu krogu zahtev in temu, da bi zavrnil stranko, ki ji manjka le najbolj zaželena podrobnost.

1. Prednostno

Matična številkaFirma

Uporabi se, kadar poverilnica vsebuje oboje

2. Nadomestno

Firma

Uporabi se le, kadar prve možnosti ni mogoče izpolniti

Tu bi preverjevalec najraje prejel matično številko skupaj z uradnim imenom, sprejel pa bo tudi zgolj uradno ime, če poverilnica imetnika matične številke ne vsebuje.

Združevanje poverilnic v eni zahtevi

Preverjanja ob sprejemu stranke le redko slonijo na enem samem dokumentu. Preverjevalec lahko zahteva eno poverilnico in poleg nje sprejme katero koli od dveh drugih, vse v eni zahtevi, tako da imetnik potrdi enkrat, preverjevalec pa dobi celovit odgovor v enem koraku.

Obvezno

Registracija podjetja

IN

Eno od

Registracija za DDV

ALI

Eno od

Potrdilo o bančnem računu

Registracija podjetja je obvezna. Poleg tega zadošča bodisi registracija za DDV bodisi potrdilo o bančnem računu, imetnik pa mora imeti le eno od njiju.

Sprejemanje le zaupanja vrednih izdajateljev

Preverjevalec lahko zahtevo zoži na poverilnice, katerih izdajatelj je na uradnem seznamu zaupanja vrednih subjektov. Poverilnice kogar koli drugega imetniku sploh niso ponujene, zato samoizdan posnetek do preverjanja sploh ne pride.

Preverjevalec pravi: samo od izdajateljev z uradnega seznama zaupanja vrednih subjektov EU

Poverilnica o registraciji od izdajatelja s seznama

Izdajatelj je na seznamu zaupanja vrednih subjektov

✓ Imetniku je ponujeno

Poverilnica o registraciji od izdajatelja, ki ni na seznamu

Izdajatelja ni na seznamu zaupanja vrednih subjektov

✗ Imetniku ni ponujeno

To je filter v denarnici, ne pa jamstvo samo po sebi. Preverjevalec izdajatelja vseeno preveri na seznamu zaupanja vrednih subjektov, ko potrjuje, kar je prejel.

Kje je DCQL danes

  • DCQL je del same specifikacije OpenID4VP in ne samostojen dokument, nadomestil pa je prejšnjo odvisnost od DIF Presentation Exchange.
  • EUDI Wallet Architecture and Reference Framework navaja OpenID4VP kot protokol za predložitev in z njim DCQL, zato se pričakuje, da ga denarnice in preverjevalci v ekosistemu podpirajo.
  • Referenčne denarnice in preverjevalci v programu EUDI Wallet so se poenotili okoli DCQL, zato naj integracija poslovne denarnice, ki se začne danes, računa nanj in ne na starejšo možnost.

Kaj to pomeni za vas

Preveritelj

Ena oblika zahteve pokrije vsako denarnico, prejmete pa samo podatke, ki ste jih zahtevali, kar pomeni manj podatkov za hrambo, zavarovanje in utemeljitev.

Imetnik

Pred potrditvijo natančno vidite, kaj se zahteva, in nič več od tega ne zapusti vaše denarnice.

Izdajatelj

Poverilnice, ki jih izdajate, ostanejo uporabne tudi za delna preverjanja, tako da lahko ena poverilnica služi mnogim različnim namenom.

Tehnična poglobitev

Ta stran pojasnjuje, kaj tehnologija počne in koga zadeva. Naša razvijalska dokumentacija obravnava samo izvedbo: sporočila, polja in razdelane primere, ki jih potrebuje integracijska ekipa.

Preberite tehnično dokumentacijo

Sorodni pojmi

Pogosta vprašanja

Po čem se DCQL razlikuje od DIF Presentation Exchange?

Oboje je način, kako preverjevalec opiše, kaj želi od denarnice. Presentation Exchange je starejši in širši od obeh ter zasnovan tako, da deluje z več protokoli. DCQL je namenoma manjši in je opredeljen kar znotraj OpenID4VP. Ekosistem EUDI Wallet je standardiziral DCQL, zato je za evropski trg treba načrtovati prav z njim.

Ali lahko ena zahteva obsega več kot eno poverilnico?

Da, in to je eden od razlogov za njegov obstoj. Preverjevalec lahko v eni zahtevi zahteva registracijo podjetja in potrdilo o bančnem računu ali pa sprejme eno od dveh možnosti, imetnik pa vse potrdi v enem koraku, namesto da bi bil vprašan dvakrat.

Kaj se zgodi, če imetnik nima vsega, kar je bilo zahtevano?

Preverjevalec lahko po vrstnem redu prednosti navede sprejemljive nadomestne možnosti, denarnica pa uporabi najboljšo, ki jo imetnik dejansko lahko izpolni. Preverjevalec lahko tako zahteva natančno matično številko tam, kjer obstaja, in se zadovolji z uradnim imenom tam, kjer je ni, ne da bi poslal drugo zahtevo ali imetnika zavrnil.

Ali je DCQL namenjen samo EUDI Wallet?

Ne. DCQL je del OpenID4VP in ga lahko uporabi vsaka izvedba tega protokola. Ekosistem EUDI Wallet je njegov vidni uporabnik: Architecture and Reference Framework navaja OpenID4VP z DCQL kot način predložitve poverilnic, zato je pomemben za vsakogar, ki gradi za evropski trg.

Ali to pomaga pri najmanjšem obsegu podatkov po GDPR?

Najmanjši obseg postane izrecen. Zahteva navede, kateri podatki so potrebni, imetnik ta seznam vidi pred potrditvijo, denarnica pa ne izda ničesar čez to. Najmanjši obseg podatkov se tako iz načela, ki ga obljubljate, spremeni v omejitev, ki jo uveljavlja sama izmenjava, to pa je veliko lažje dokazati.

Viri

  1. OpenID for Verifiable Presentations 1.0, razdelek Digital Credentials Query Language (DCQL)
  2. EUDI Wallet Architecture and Reference Framework
  3. Specifikacija DIF Presentation Exchange 2.1.1

Ta stran je informativne narave in ne predstavlja pravnega nasveta. Za verodostojne smernice se obrnite neposredno na OpenID Foundation in Evropsko komisijo.

Pogovorite se z nami o integraciji EUDI Wallet