Siirry pääsisältöön

DCQL selitettynä: näin todentaja pyytää lompakolta juuri sen, mitä tarvitsee

DCQL eli Digital Credentials Query Language on sovittu tapa, jolla organisaatio kertoo walletille, mitä todistuksia se tarvitsee ja mitä tietoja niiden sisältä. Se muuttaa pyynnön kuten "osoita, että yrityksesi on rekisteröity Alankomaissa" muotoon, jonka jokainen vaatimustenmukainen wallet ymmärtää, ilman erillistä integraatiota kutakin wallettia varten.

Ongelma, jonka DCQL ratkaisee

Business Wallet sisältää monenlaisia todistuksia, joita ovat myöntäneet eri tahot eri maissa ja jotka on tallennettu eri teknisissä muodoissa. Organisaatiolla, jonka tarvitsee vain vahvistaa rekisterinumero ja virallinen nimi, ei ole siirrettävää tapaa pyytää juuri sitä. Se päätyy joko ottamaan koko todistuksen kaikkine sisältöineen tai rakentamaan erillisen integraation jokaista kohtaamaansa wallettia varten.

DCQL korjaa pyytämisen puolen. Yksi standardipyyntö nimeää halutut todistukset ja kustakin halutut yksittäiset tiedot. Wallet vertaa sitä siihen, mitä haltijalla todella on, näyttää haltijalle, mitä pyydetään, ja luovuttaa vain sen. Todentaja saa ennakoitavan vastauksen riippumatta siitä, mitä wallettia haltija käyttää.

1. Todentaja

Pyytää täsmälleen ne todistukset ja tiedot, joita se tarvitsee

2. Lompakko

Selvittää, mitkä tallennetuista todistuksista sopivat pyyntöön

3. Haltija

Näkee, mitä pyydetään, ja hyväksyy vain sen luovuttamisen

4. Todentaja

Saa hyväksytyt tiedot, eikä mitään muuta

Mitä todentaja voi pyytää

Pyyntö on lyhyt luettelo siitä, mitä tarvitaan. Se voi nimetä yhden todistuksen tai useita, ja kustakin se voi nimetä halutut yksittäiset tiedot koko sisällön sijaan. Kolme lisävaihtoehtoa kattaa lähes jokaisen todellisen tilanteen: vaihtoehdot, yhdistelmät ja rajaus siihen, mitkä myöntäjät hyväksytään.

  • Mitkä todistukset tarvitaan ja mitkä tiedot kunkin sisältä.
  • Hyväksyttävät vaihtoehdot mieltymysjärjestyksessä niille haltijoille, joilla ei ole kaikkea.
  • Yhdistelmät, jotta pyyntö voi vaatia yhden todistuksen ja jommankumman kahdesta muusta.
  • Rajaus myöntäjiin, jotka ovat virallisella trusted list -luettelolla, jolloin muiden todistuksia ei koskaan tarjota.

Vaihtoehdon pyytäminen

Kaikilla haltijoilla ei ole samaa todistusta. Todentaja voi kertoa, mitä se mieluiten saisi ja mitä se vielä hyväksyisi, järjestyksessä, ja wallet käyttää parasta vaihtoehtoa, jonka haltija pystyy todella täyttämään. Näin vältetään toinen pyyntökierros ja vältetään asiakkaan käännyttäminen, kun häneltä puuttuu vain kaikkein toivotuin tieto.

1. Ensisijainen

RekisterinumeroVirallinen nimi

Käytetään, kun todistus sisältää molemmat

2. Varavaihtoehto

Virallinen nimi

Käytetään vain, kun ensimmäinen vaihtoehto ei toteudu

Tässä todentaja saisi mieluiten rekisterinumeron yhdessä virallisen nimen kanssa, mutta hyväksyy pelkän virallisen nimen, kun haltijan todistus ei sisällä rekisterinumeroa.

Useiden todistusten yhdistäminen yhteen pyyntöön

Asiakkaaksi oton tarkistukset nojaavat harvoin yhteen asiakirjaan. Todentaja voi vaatia yhtä todistusta ja hyväksyä sen rinnalla jommankumman kahdesta muusta, kaikki yhdessä pyynnössä, joten haltija hyväksyy kerran ja todentaja saa täyden vastauksen yhdellä askeleella.

Pakollinen

Yritysrekisteröinti

JA

Yksi näistä

ALV-rekisteröinti

TAI

Yksi näistä

Pankkitilitodiste

Kaupparekisteriote vaaditaan. Sen lisäksi käy joko arvonlisäverorekisteröinti tai pankkitilitodistus, ja haltijalla riittää, että hänellä on toinen niistä.

Vain luotettujen myöntäjien hyväksyminen

Todentaja voi rajata pyynnön todistuksiin, joiden myöntäjä on virallisella trusted list -luettelolla. Muiden todistuksia ei edes tarjota haltijalle, joten itse myönnetty jäljitelmä ei pääse tarkistukseen lainkaan.

Todentaja sanoo: vain myöntäjiltä, jotka ovat EU:n virallisella trusted list -luettelolla

Rekisteröintitodiste listatulta myöntäjältä

Myöntäjä on trusted list -luettelossa

✓ Tarjotaan haltijalle

Rekisteröintitodiste listaamattomalta myöntäjältä

Myöntäjä ei ole trusted list -luettelossa

✗ Ei tarjota haltijalle

Tämä on suodatin walletissa, ei sellaisenaan takuu. Todentaja tarkistaa myöntäjän trusted list -luettelosta edelleen, kun se validoi saamansa tiedot.

DCQL:n tilanne nyt

  • DCQL on osa itse OpenID4VP-määrittelyä eikä erillinen asiakirja, ja se korvasi aiemman riippuvuuden DIF Presentation Exchangesta.
  • EUDI Walletin Architecture and Reference Framework nimeää OpenID4VP:n esittämisprotokollaksi ja DCQL:n sen kanssa, joten ekosysteemin walleteilta ja todentajilta odotetaan sen tukea.
  • EUDI Wallet -ohjelman referenssiwalletit ja -todentajat ovat päätyneet DCQL:ään, joten tänään aloitettavan Business Wallet -integraation tulisi olettaa se vanhemman vaihtoehdon sijaan.

Mitä tämä tarkoittaa sinulle

Todentaja

Yksi pyyntömuoto kattaa jokaisen walletin, ja saat vain pyytämäsi tiedot, eli vähemmän tietoa säilytettäväksi, suojattavaksi ja perusteltavaksi.

Haltija

Näet tarkalleen, mitä sinulta pyydetään, ennen kuin hyväksyt, eikä walletistasi lähde mitään sen ulkopuolelta.

Myöntäjä

Myöntämäsi todistukset pysyvät käyttökelpoisina osittaisiin tarkistuksiin, joten yksi todistus voi palvella monia eri tarkoituksia.

Tekninen syväsukellus

Tämä sivu kertoo, mitä teknologia tekee ja keitä se koskee. Kehittäjädokumentaatiomme käsittelee itse toteutusta: viestit, kentät ja käytännön esimerkit, joita integraatiotiimi tarvitsee.

Lue tekninen dokumentaatio

Aiheeseen liittyvät termit

Usein kysytyt kysymykset

Miten DCQL eroaa DIF Presentation Exchangesta?

Molemmat ovat tapoja, joilla todentaja kuvaa, mitä se haluaa walletilta. Presentation Exchange on näistä vanhempi ja laajempi, ja se on suunniteltu toimimaan useiden protokollien kanssa. DCQL on tarkoituksella suppeampi ja se on määritelty OpenID4VP:n sisällä. EUDI Wallet -ekosysteemi on valinnut DCQL:n standardikseen, joten Euroopan markkinoita koskevat suunnitelmat kannattaa rakentaa sen varaan.

Voiko yksi pyyntö koskea useampaa kuin yhtä todistusta?

Kyllä, ja se on yksi syy sen olemassaoloon. Todentaja voi pyytää kaupparekisteriotetta ja pankkitilitodistusta yhdessä pyynnössä tai hyväksyä jommankumman kahdesta vaihtoehdosta, ja haltija hyväksyy kaiken yhdellä askeleella sen sijaan, että häneltä kysyttäisiin kahdesti.

Mitä tapahtuu, jos haltijalla ei ole kaikkea pyydettyä?

Todentaja voi nimetä hyväksyttävät vaihtoehdot mieltymysjärjestyksessä, ja wallet käyttää parasta, jonka haltija pystyy todella täyttämään. Todentaja voi siis pyytää tarkkaa rekisterinumeroa siellä, missä sellainen on, ja tyytyä viralliseen nimeen siellä, missä ei ole, lähettämättä toista pyyntöä ja käännyttämättä haltijaa.

Onko DCQL EUDI Walletin oma ratkaisu?

Ei. DCQL on osa OpenID4VP:tä, ja mikä tahansa kyseisen protokollan toteutus voi käyttää sitä. EUDI Wallet -ekosysteemi on näkyvä käyttöönottaja: Architecture and Reference Framework nimeää OpenID4VP:n ja DCQL:n tavaksi esittää todistuksia, ja siksi sillä on merkitystä kaikille, jotka rakentavat Euroopan markkinoille.

Auttaako tämä GDPR:n mukaisessa tietojen minimoinnissa?

Se tekee vähimmäismäärän näkyväksi. Pyyntö kertoo, mitä tietoja tarvitaan, haltija näkee luettelon ennen hyväksymistä eikä wallet luovuta mitään sen ulkopuolelta. Näin tietojen minimoinnista tulee lupauksen sijaan raja, jonka vaihto itse pakottaa, ja sen osoittaminen on paljon helpompaa.

Lähteet

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

Tämä sivu on tarkoitettu tiedoksi eikä ole oikeudellista neuvontaa. Luotettavaa ohjeistusta saat suoraan OpenID Foundationilta ja Euroopan komissiolta.

Keskustele kanssamme EUDI Wallet -integraatiosta