Eisiúint dintiúir OpenID4VCI mínithe: ón tairiscint go dtí an dintiúr glactha

Saolré iomlán tairiscint dintiúir

Ní shainmhíníonn an sonraíocht staideanna ainmnithe, ach is éasca sreabhadh arna thionscnamh ag an eisitheoir, ina n-eisítear an dintiúr láithreach, a leanúint mar an seicheamh thíos. Féadann gach céim teip ar a bhealach féin, agus caithfidh cur i bhfeidhm sparáin na conairí sin a láimhseáil, ní hamháin an ceann rathúil.

2. Fionnachtain meiteashonraí eisitheora

Sula n-iarrann sé rud ar bith, faigheann an sparán meiteashonraí an eisitheora chun foghlaim cad atá i roadworthiness_certificate agus cé na pointí deiridh atá le glaoch. Ní liostaíonn na meiteashonraí freastalaithe údaraithe ar leith, mar sin is é an t-eisitheoir a fhreastalaí údaraithe féin, agus léann an sparán an pointe deiridh comhartha ó mheiteashonraí an fhreastalaí sin.

Meiteashonraí eisitheora dintiúir (sliocht)

{
  "credential_issuer": "https://issuer.fleetinspect.example",
  "nonce_endpoint": "https://issuer.fleetinspect.example/nonce",
  "credential_endpoint": "https://issuer.fleetinspect.example/credential",
  "deferred_credential_endpoint": "https://issuer.fleetinspect.example/deferred",
  "notification_endpoint": "https://issuer.fleetinspect.example/notify",
  "credential_configurations_supported": {
    "roadworthiness_certificate": {
      "format": "dc+sd-jwt",
      "vct": "https://fleetinspect.example/vct/roadworthiness",
      "cryptographic_binding_methods_supported": ["jwk"],
      "credential_signing_alg_values_supported": ["ES256"],
      "proof_types_supported": {
        "jwt": { "proof_signing_alg_values_supported": ["ES256"] }
      },
      "credential_metadata": {
        "claims": [
          { "path": ["vehicle_registration"] },
          { "path": ["inspection_result"] },
          { "path": ["valid_until"] }
        ]
      }
    }
  }
}

Meiteashonraí an fhreastalaí údaraithe (sliocht), ó /.well-known/oauth-authorization-server

{
  "issuer": "https://issuer.fleetinspect.example",
  "token_endpoint": "https://issuer.fleetinspect.example/token",
  "pre-authorized_grant_anonymous_access_supported": true
}

4. Cruthúnas seilbhe

Toisc go liostaíonn na meiteashonraí nonce_endpoint, faigheann an sparán c_nonce úr ón áit sin ar dtús. Ansin cruthaíonn sé go bhfuil an eochair phríobháideach a mbeidh an dintiúr ceangailte léi aige, trí proof JWT a shíniú thar aitheantóir an eisitheora agus an c_nonce sin.

POST /nonce HTTP/1.1
Host: issuer.fleetinspect.example

Freagra

{
  "c_nonce": "fi-nonce-77aa"
}

Tógann an sparán anois an proof JWT ó dhá réad JSON, ceanntásc agus pálasta, agus sínithe iad leis an eochair phríobháideach a mbeidh an dintiúr ceangailte léi.

Ceanntásc: cad é an JWT seo agus cén eochair a shínigh é

{
  "typ": "openid4vci-proof+jwt",
  "alg": "ES256",
  "jwk": { "kty": "EC", "crv": "P-256", "x": "...", "y": "..." }
}

• typ: marcálann sé seo mar chruthúnas eochrach OpenID4VCI, ionas nach féidir é a mheascadh le haon chineál eile JWT
• alg: an t-algartam sínithe, ceann a liostaigh an t-eisitheoir i proof_signing_alg_values_supported
• jwk: an eochair phoiblí a mbeidh an dintiúr ceangailte léi; deimhníonn an t-eisitheoir an síniú ina coinne

Pálasta: cé dó a bhfuil an cruthúnas agus cathain a rinneadh é

{
  "aud": "https://issuer.fleetinspect.example",
  "iat": 1789376400,
  "nonce": "fi-nonce-77aa"
}

• aud: aitheantóir an eisitheora, ionas nach féidir an cruthúnas a athsheinm ag eisitheoir eile
• iat: an t-am ar cruthaíodh an cruthúnas, i soicindí ó 1970
• nonce: an c_nonce ón bpointe deiridh nonce, a léiríonn go bhfuil an cruthúnas úr

An toradh sínithe

Códaítear an ceanntásc agus an pálasta go leithleach i base64url agus ceanglaítear le ponc iad. Sínithe an sparán an teaghrán sin lena eochair phríobháideach agus cuireann sé an síniú códaithe base64url leis tar éis dara ponc. Is é an teaghrán mar thoradh air an proof JWT a sheolann an sparán san iarratas dintiúir i gcéim 5.

base64url(header) . base64url(payload) . base64url(signature)

eyJ0eXAiOiJvcGVuaWQ0dmNpLXByb29mK2p3dCIs...
  .eyJhdWQiOiJodHRwczovL2lzc3Vlci5mbGVldGluc3BlY3QuZXhhbXBsZSIs...
  .<ES256 signature>

Nuair nach bhfuil an dintiúr réidh fós: eisiúint iarchurtha

Glacann an sampla thuas leis go bhfuil toradh an iniúchta cinntitheach cheana féin. Má tá ar an gcomhlacht iniúchta ina ionad sin toradh teorantach a chur chuig sinsear-iniúchóir, ní féidir leis an bpointe deiridh dintiúir an dintiúr a thabhairt ar ais láithreach, mar sin iarchuireann sé an eisiúint.

Freagra iarchurtha ó /credential

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "transaction_id": "fi-tx-55c2",
  "interval": 900
}

Ag vótáil ar /deferred go dtí go mbíonn sé réidh

POST /deferred HTTP/1.1
Host: issuer.fleetinspect.example
Content-Type: application/json
Authorization: Bearer fi-at-3d91e0

{ "transaction_id": "fi-tx-55c2" }

// While the review is open: 202 with the same transaction_id and interval.
// Once approved: 200 with the credentials, optionally with a notification_id.
// If the review rejects the result: a credential_request_denied error.

Téarmaí Gaolmhara

Foinsí

1. OpenID for Verifiable Credential Issuance 1.0
2. OpenID4VC High Assurance Interoperability Profile 1.0
3. EUDI Wallet Architecture and Reference Framework