Hoppa till huvudinnehåll

DCQL förklarat: så begär en verifierare exakt det den behöver från en plånbok

DCQL, Digital Credentials Query Language, är det överenskomna sättet för en organisation att tala om för en plånbok vilka intyg den behöver och vilka uppgifter inuti dem. Det är det som gör en begäran som "visa att ditt företag är registrerat i Nederländerna" till något som varje regelefterlevande plånbok förstår, utan en separat integration per plånbok.

Problemet som DCQL löser

En business wallet rymmer intyg av många slag, utfärdade av olika organ i olika länder och lagrade i olika tekniska format. En organisation som bara behöver bekräfta ett organisationsnummer och ett registrerat namn har inget portabelt sätt att be om just det. Den slutar antingen med att ta emot hela intyget, med allt annat som finns i det, eller med att bygga en separat integration för varje plånbok den möter.

DCQL löser frågesidan. En standardiserad begäran anger vilka intyg som önskas och vilka specifika uppgifter som önskas ur vart och ett. Plånboken stämmer av den mot vad innehavaren faktiskt har, visar innehavaren vad som efterfrågas och lämnar bara ut det. Verifieraren får ett förutsägbart svar oavsett vilken plånbok innehavaren använder.

1. Verifierare

Ber om exakt de intyg och uppgifter den behöver

2. Plånbok

Räknar ut vilka av de sparade intygen som passar begäran

3. Innehavare

Ser vad som efterfrågas och godkänner att endast det lämnas ut

4. Verifierare

Tar emot de godkända uppgifterna, och inget mer

Vad en verifierare kan be om

En begäran är en kort lista över vad som behövs. Den kan ange ett intyg eller flera, och för vart och ett kan den ange de specifika uppgifter som önskas i stället för hela innehållet. Tre ytterligare möjligheter täcker nästan alla verkliga fall: alternativ, kombinationer och en gräns för vilka utfärdare som godtas.

  • Vilka intyg som behövs, och vilka uppgifter inuti vart och ett.
  • Godtagbara alternativ, i prioritetsordning, för innehavare som inte har allt.
  • Kombinationer, så att en begäran kan kräva ett intyg och något av två andra.
  • En begränsning till utfärdare på en officiell trusted list, så att intyg från någon annan aldrig erbjuds.

Att be om ett alternativ

Alla innehavare bär inte på samma intyg. En verifierare kan ange vad den helst vill ha och vad den ändå skulle godta, i tur och ordning, och plånboken använder det bästa alternativ som innehavaren faktiskt kan uppfylla. Det undviker en andra rundtur och undviker att avvisa en kund som bara saknar den mest önskvärda uppgiften.

1. Föredraget

RegistreringsnummerJuridiskt namn

Används när intyget innehåller båda

2. Reserv

Juridiskt namn

Används bara när det första alternativet inte kan uppfyllas

Här skulle verifieraren helst vilja ha ett organisationsnummer tillsammans med det registrerade namnet, men godtar enbart det registrerade namnet när innehavarens intyg inte innehåller något organisationsnummer.

Att kombinera intyg i en och samma begäran

Kontroller vid onboarding vilar sällan på ett enda dokument. En verifierare kan kräva ett intyg och vid sidan av det godta något av två andra, allt i en enda begäran, så att innehavaren godkänner en gång och verifieraren får ett fullständigt svar i ett enda steg.

Obligatorisk

Företagsregistrering

OCH

En av

Momsregistrering

ELLER

En av

Intyg om bankkonto

Ett registreringsbevis krävs. Utöver det duger antingen en momsregistrering eller ett bankkontointyg, och innehavaren behöver bara ha ett av dem.

Att bara godta betrodda utfärdare

En verifierare kan begränsa en begäran till intyg vars utfärdare finns med på en officiell trusted list. Intyg från någon annan erbjuds aldrig ens innehavaren, så en självutfärdad efterapning når över huvud taget inte fram till kontrollen.

Verifieraren säger: endast från utfärdare på en officiell trusted list inom EU

Registreringsintyg från en listad utfärdare

Utfärdaren finns med på trusted list

✓ Erbjuds innehavaren

Registreringsintyg från en olistad utfärdare

Utfärdaren finns inte med på trusted list

✗ Erbjuds inte innehavaren

Detta är ett filter i plånboken, inte en garanti i sig. Verifieraren kontrollerar fortfarande utfärdaren mot trusted list när den validerar det den tagit emot.

Var DCQL står i dag

  • DCQL ingår i själva OpenID4VP-specifikationen snarare än i ett separat dokument, och det ersatte ett tidigare beroende av DIF Presentation Exchange.
  • EUDI Wallets Architecture and Reference Framework anger OpenID4VP som presentationsprotokoll och DCQL tillsammans med det, så plånböcker och verifierare i ekosystemet förväntas stödja det.
  • Referensplånböckerna och referensverifierarna i EUDI Wallet-programmet har samlats kring DCQL, så en integration av en business wallet som påbörjas i dag bör utgå från det i stället för från det äldre alternativet.

Vad detta betyder för dig

Verifierare

Ett enda begäranformat täcker alla plånböcker, och du får bara de uppgifter du bad om, alltså mindre data att lagra, skydda och motivera.

Innehavare

Du ser exakt vad som efterfrågas innan du godkänner, och inget utöver det lämnar din plånbok.

Utfärdare

De intyg du utfärdar förblir användbara för delkontroller, så ett intyg kan tjäna många olika syften.

Teknisk fördjupning

Den här sidan förklarar vad tekniken gör och vilka den berör. Vår utvecklardokumentation täcker själva implementationen: meddelandena, fälten och de genomarbetade exempel som ett integrationsteam behöver.

Läs den tekniska dokumentationen

Relaterade begrepp

Vanliga frågor

Hur skiljer sig DCQL från DIF Presentation Exchange?

Båda är sätt för en verifierare att beskriva vad den vill ha från en plånbok. Presentation Exchange är det äldre och bredare av de två och är utformat för att fungera över flera protokoll. DCQL är medvetet mindre och definieras inuti OpenID4VP självt. EUDI Wallet-ekosystemet har standardiserat på DCQL, så det är det man ska planera för på den europeiska marknaden.

Kan en begäran omfatta mer än ett intyg?

Ja, och det är ett av skälen till att det finns. En verifierare kan be om ett registreringsbevis och ett bankkontointyg i en enda begäran, eller godta något av två alternativ, och innehavaren godkänner allt i ett steg i stället för att tillfrågas två gånger.

Vad händer om innehavaren inte har allt som efterfrågades?

Verifieraren kan ange godtagbara alternativ, i prioritetsordning, och plånboken använder det bästa som innehavaren faktiskt kan uppfylla. En verifierare kan alltså be om ett exakt organisationsnummer där det finns och nöja sig med det registrerade namnet där det inte finns, utan att skicka en andra begäran eller avvisa innehavaren.

Är DCQL specifikt för EUDI Wallet?

Nej. DCQL är en del av OpenID4VP och alla implementationer av det protokollet kan använda det. EUDI Wallet-ekosystemet är en framträdande användare: Architecture and Reference Framework anger OpenID4VP med DCQL som sättet att presentera intyg, vilket är varför det har betydelse för alla som bygger för den europeiska marknaden.

Hjälper detta med uppgiftsminimering enligt GDPR?

Det gör minimum uttryckligt. Begäran anger vilka uppgifter som behövs, innehavaren ser den listan innan den godkänner, och plånboken lämnar inte ut något utöver den. Det gör uppgiftsminimering till en gräns som själva utbytet upprätthåller i stället för ett löfte, vilket är betydligt lättare att visa.

Källor

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

Den här sidan är endast informativ och utgör inte juridisk rådgivning. För auktoritativ vägledning, kontakta OpenID Foundation och Europeiska kommissionen direkt.

Prata med oss om integration med EUDI Wallet