DCQL mínithe: conas a iarrann fíoraitheoir ar sparán go díreach an méid a theastaíonn uaidh

An fhadhb a réitíonn DCQL

Cúltaca a iarraidh: claim_sets

Liostaíonn claim_sets grúpaí d'id éileamh in ord tosaíochta. Seolann an sparán ar ais an chéad ghrúpa is féidir leis a shásamh go hiomlán ón méid atá ag an sealbhóir i ndáiríre, in ionad go gcaithfeadh an fíoraitheoir dhá iarratas ar leith a sheoladh, ceann don chás beacht agus ceann don chás cúltaca.

{
  "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"]
      ]
    }
  ]
}

Anseo is fearr leis an bhfíoraitheoir uimhir chláraithe móide an t-ainm dlíthiúil, ach glacfaidh sé leis an ainm dlíthiúil leis féin mura bhfuil éileamh uimhir chláraithe i ndintiúr an tsealbhóra.

{
  "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."
}

Dintiúir a chomhcheangal: credential_sets

Oibríonn credential_sets leibhéal amháin os cionn claim_sets. Liostaíonn gach iontráil options, áit ar grúpa d'id ceisteanna dintiúir gach rogha. Ní mór don sparán rogha amháin de gach iontráil riachtanach a shásamh, rud a thugann loighic AND agus OR thar dhintiúir don fhíoraitheoir in iarratas amháin.

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

Freagra samplach: clárú móide cuntas bainc

An méid a sheolann an sparán

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

Éilimh a fheiceann an fíoraitheoir tar éis bailíochtaithe

{
  "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."
  }
}

Níl dintiúr cláraithe CBL ag an sealbhóir, mar sin roghnaigh an sparán an dara rogha den dara tacar. Níl id na gceisteanna nár úsáideadh, vat_registration sa chás seo, le fáil in vp_token ar chor ar bith.

Eisitheoirí iontaofa amháin: trusted_authorities

Cúngaíonn trusted_authorities ceist dintiúir go dintiúir a bhfuil a n-eisitheoir á thacú ag údarás a bhfuil muinín ag an bhfíoraitheoir as. Tá cineál agus liosta luachanna ag gach iontráil: aki d'aitheantóir eochrach údaráis, etsi_tl do liosta iontaofa ETSI, nó openid_federation d'ancaire muiníne cónaidhme. Ní thairgeann an sparán ach dintiúir a oireann.

Sampla oibrithe: clárú ó eisitheoir liostaithe

{
  "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"] }
      ]
    }
  ]
}

Freagra samplach: dintiúr an eisitheora liostaithe amháin

An méid a sheolann an sparán

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

Éilimh a fheiceann an fíoraitheoir tar éis bailíochtaithe

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

Bhí dintiúr cláraithe ó eisitheoir neamhliostaithe ag an sealbhóir freisin, ach níor thairg an sparán é. Is scagaire don sparán é trusted_authorities, ní ráthaíocht: seiceálann an fíoraitheoir féin an t-eisitheoir i gcoinne an liosta iontaofa nuair a bhailíochtaíonn sé an cur i láthair.

Luach a mheaitseáil: claims.values

Is féidir values a bheith i gceist éilimh, liosta teaghrán, slánuimhreacha nó luachanna Boole. Ní sheolann an sparán an t-éileamh ar ais ach amháin nuair a oireann a chineál agus a luach go beacht do cheann acu, ionas gur féidir le fíoraitheoir coinníoll a sheiceáil gan aon rud eile a iarraidh ar dtús.

Sampla oibrithe: cuideachtaí atá cláraithe san Ísiltír nó sa Bheilg amháin

{
  "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"]
        }
      ]
    }
  ]
}

Freagra samplach: cuideachta Ollannach

An méid a sheolann an sparán

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

Éilimh a fheiceann an fíoraitheoir tar éis bailíochtaithe

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

Tá registration_country "DE" i ndintiúr cuideachta Gearmánaí, mar sin ní shásaíonn sé an cheist agus níl aon rud le seoladh ar ais ag an sparán dó. Ba cheart don fhíoraitheoir an luach sna héilimh bhailíochtaithe a sheiceáil fós seachas a bheith ag brath ar scagadh an sparáin.

Staid DCQL inniu

• Sainítear DCQL laistigh de shonraíocht OpenID4VP féin, ní mar dhoiciméad ar leith, agus bhí sé mar chuid den dréacht ó tugadh an mheicníocht isteach chun spleáchas níos luaithe ar DIF Presentation Exchange d'iarratais OpenID4VP a athsholáthar.
• Sonraíonn an EUDI Wallet Architecture and Reference Framework OpenID4VP mar an prótacal cur i láthair agus, in éineacht leis, DCQL mar an mheicníocht ceiste a bhfuiltear ag súil go dtacóidh páirtithe spleácha agus sparáin san éiceachóras léi.
• Tá cur i bhfeidhm tagartha sparán agus fíoraitheoirí i gclár EUDI Wallet Reference Implementation tar éis teacht le chéile ar DCQL, mar sin ba cheart do chomhtháthuithe nua sparán gnó a thógtar ar OpenID4VP inniu glacadh le DCQL seachas Presentation Exchange mar fhormáid ceiste d'iarratais cur i láthair.

Ceisteanna coitianta

Is chun críocha faisnéise amháin atá an leathanach seo agus ní comhairle dhlíthiúil é. Chun treoir údarásach a fháil, téigh i dteagmháil go díreach leis an OpenID Foundation agus leis an gCoimisiún Eorpach.