DCQL spjegat: kif verifikatur jitlob minn kartiera eżattament dak li jeħtieġ

Il-problema li jsolvi DCQL

Talba għal alternattiva: claim_sets

claim_sets telenka gruppi ta' id tad-dejta skont l-ordni tal-preferenza. Il-kartiera tirritorna l-ewwel grupp li tista' tissodisfa għalkollox minn dak li d-detentur għandu fil-fatt, minflok ma l-verifikatur ikollu jibgħat żewġ talbiet separati għal każ preċiż u għal każ alternattiv.

{
  "credentials": [
    {
      "id": "company_registration",
      "format": "dc+sd-jwt",
      "meta": { "vct_values": ["urn:eudi:business:company-registration:1"] },
      "claims": [
        { "id": "reg_no", "path": ["registration_number"] },
        { "id": "legal_name", "path": ["legal_name"] }
      ],
      "claim_sets": [
        ["reg_no", "legal_name"],
        ["legal_name"]
      ]
    }
  ]
}

Hawn il-verifikatur jippreferi n-numru tar-reġistrazzjoni flimkien mal-isem legali, iżda jaċċetta l-isem legali waħdu jekk il-kredenzjali tad-detentur ma jkollhiex element tan-numru tar-reġistrazzjoni.

{
  "vp_token": {
    "company_registration": [
      "<issuer-signed JWT>~<disclosure: legal_name>~<key binding JWT>"
    ]
  }
}

{
  "vct": "urn:eudi:business:company-registration:1",
  "legal_name": "Example Logistics B.V."
}

Kombinazzjoni ta' kredenzjali: credential_sets

credential_sets jaħdem livell wieħed ogħla minn claim_sets. Kull element jelenka options, fejn kull għażla hi grupp ta' id ta' mistoqsijiet għal kredenzjali. Il-kartiera trid tissodisfa għażla waħda minn kull element meħtieġ, u b'hekk verifikatur ikollu loġika AND u OR bejn il-kredenzjali f'talba waħda.

"credential_sets": [
  { "options": [["company_registration"]] },
  { "options": [["vat_registration"], ["bank_account"]] }
]

Eżempju ta' tweġiba: reġistrazzjoni u kont bankarju

X'tibgħat il-kartiera

{
  "vp_token": {
    "company_registration": [
      "<issuer-signed JWT>~<disclosures>~<key binding JWT>"
    ],
    "bank_account": [
      "<issuer-signed JWT>~<disclosures>~<key binding JWT>"
    ]
  }
}

Id-dejta li jara l-verifikatur wara l-validazzjoni

{
  "company_registration": {
    "vct": "urn:eudi:business:company-registration:1",
    "registration_number": "12345678",
    "legal_name": "Example Logistics B.V."
  },
  "bank_account": {
    "vct": "urn:eudi:business:bank-account:1",
    "iban": "NL91ABNA0417164300",
    "account_holder": "Example Logistics B.V."
  }
}

Id-detentur m'għandux kredenzjali tar-reġistrazzjoni tal-VAT, għalhekk il-kartiera għażlet it-tieni għażla tat-tieni sett. L-id tal-mistoqsijiet li ma ntużawx, hawn vat_registration, sempliċement ma jidhrux f'vp_token.

Emittenti ta' fiduċja biss: trusted_authorities

trusted_authorities tillimita mistoqsija għal kredenzjali li l-emittent tagħhom hu appoġġat minn awtorità li l-verifikatur jafda. Kull element għandu tip u lista ta' valuri: aki għal identifikatur taċ-ċavetta tal-awtorità, etsi_tl għal lista ta' fiduċja ETSI, jew openid_federation għal trust anchor ta' federazzjoni. Il-kartiera toffri biss kredenzjali li jaqblu.

Eżempju prattiku: reġistrazzjoni minn emittent fil-lista

{
  "credentials": [
    {
      "id": "company_registration",
      "format": "dc+sd-jwt",
      "meta": { "vct_values": ["urn:eudi:business:company-registration:1"] },
      "trusted_authorities": [
        {
          "type": "etsi_tl",
          "values": ["https://ec.europa.eu/tools/lotl/eu-lotl.xml"]
        }
      ],
      "claims": [
        { "id": "reg_no", "path": ["registration_number"] },
        { "id": "legal_name", "path": ["legal_name"] }
      ]
    }
  ]
}

Eżempju ta' tweġiba: il-kredenzjali tal-emittent fil-lista biss

X'tibgħat il-kartiera

{
  "vp_token": {
    "company_registration": [
      "<issuer-signed JWT>~<disclosure: registration_number>~<disclosure: legal_name>~<key binding JWT>"
    ]
  }
}

Id-dejta li jara l-verifikatur wara l-validazzjoni

{
  "vct": "urn:eudi:business:company-registration:1",
  "registration_number": "12345678",
  "legal_name": "Example Logistics B.V."
}

Id-detentur kellu wkoll kredenzjali tar-reġistrazzjoni minn emittent barra l-lista, iżda l-kartiera ma offrietx. trusted_authorities hu filtru għall-kartiera, mhux garanzija: il-verifikatur xorta jivverifika hu stess l-emittent mal-lista ta' fiduċja meta jivvalida l-preżentazzjoni.

Qbil ma' valur: claims.values

Mistoqsija għad-dejta tista' jkun fiha values, lista ta' strings, numri interi jew booleans. Il-kartiera tirritorna d-dejta biss meta t-tip u l-valur tagħha jaqblu eżattament ma' wieħed minnhom, u b'hekk verifikatur jista' jivverifika kundizzjoni mingħajr ma jitlob xejn ieħor qabel.

Eżempju prattiku: kumpaniji rreġistrati fl-Olanda jew fil-Belġju biss

{
  "credentials": [
    {
      "id": "company_registration",
      "format": "dc+sd-jwt",
      "meta": { "vct_values": ["urn:eudi:business:company-registration:1"] },
      "claims": [
        { "id": "legal_name", "path": ["legal_name"] },
        {
          "id": "reg_country",
          "path": ["registration_country"],
          "values": ["NL", "BE"]
        }
      ]
    }
  ]
}

Eżempju ta' tweġiba: kumpanija Olandiża

X'tibgħat il-kartiera

{
  "vp_token": {
    "company_registration": [
      "<issuer-signed JWT>~<disclosure: legal_name>~<disclosure: registration_country>~<key binding JWT>"
    ]
  }
}

Id-dejta li jara l-verifikatur wara l-validazzjoni

{
  "vct": "urn:eudi:business:company-registration:1",
  "legal_name": "Example Logistics B.V.",
  "registration_country": "NL"
}

Il-kredenzjali ta' kumpanija Ġermaniża għandha registration_country "DE", għalhekk ma tissodisfax il-mistoqsija u l-kartiera m'għandha xejn x'tirritorna għaliha. Il-verifikatur xorta għandu jivverifika l-valur fid-dejta vvalidata minflok ma jistrieħ fuq il-filtrazzjoni tal-kartiera.

Fejn wasal DCQL illum

• DCQL hu definit fl-ispeċifikazzjoni OpenID4VP innifisha, mhux f'dokument separat, u ilu parti mill-abbozz minn meta l-mekkaniżmu ġie introdott biex jissostitwixxi dipendenza preċedenti fuq DIF Presentation Exchange għat-talbiet OpenID4VP.
• L-EUDI Wallet Architecture and Reference Framework tispeċifika OpenID4VP bħala l-protokoll tal-preżentazzjoni u, flimkien miegħu, DCQL bħala l-mekkaniżmu tal-mistoqsijiet li l-partijiet li jistrieħu fuqu u l-kartieri fl-ekosistema huma mistennija jappoġġaw.
• L-implimentazzjonijiet ta' referenza tal-kartieri u tal-verifikaturi fil-programm EUDI Wallet Reference Implementation ikkonverġew fuq DCQL, għalhekk integrazzjonijiet ġodda ta' kartieri tan-negozju mibnija fuq OpenID4VP illum għandhom jassumu DCQL, u mhux Presentation Exchange, bħala l-format tal-mistoqsijiet għat-talbiet ta' preżentazzjoni.

Mistoqsijiet frekwenti

Din il-paġna hi għal skop ta' informazzjoni u ma tikkostitwixxix parir legali. Għal gwida awtorevoli kkuntattja direttament lill-OpenID Foundation u lill-Kummissjoni Ewropea.