Dōrvis

Pieslēgties

Authorization Code plūsma

Dorvis ir OpenID Connect pakalpojums ar Authorization Code plūsmu. Lietotājs pieslēdzas Dorvis pusē, lietotnes serveris saņem kodu un apmaina to pret ID tokenu.

Plūsma soli pa solim

  1. Lietotne novirza lietotāju uz Dorvis authorization galapunktu ar client_id, redirect_uri, scope, state un nonce.
  2. Ja acr_values nav norādīts, Dorvis parāda eID rīku izvēli. Ja ir norādīts, lietotājs uzreiz nonāk Smart-ID, eParaksts vai bankas lapā.
  3. Pēc veiksmīgas pieslēgšanās Dorvis novirza lietotāju atpakaļ uz redirect_uri ar parametriem code un state.
  4. Lietotnes serveris pārbauda state un nosūta kodu kopā ar klienta rekvizītiem uz tokenu galapunktu.
  5. Atbildē ir id_token un access_token. ID tokenā ir lietotāja vārds, uzvārds, personas kods un izmantotais eID rīks.
  6. Lietotnes serveris pārbauda ID tokena parakstu, iss, aud, exp un nonce un izveido savu sesiju.

Autorizācijas pieprasījums

HTTPGET
https://dorvis.eu/oidc/oauth2/auth
  ?response_type=code
  &client_id=your-client-id
  &redirect_uri=https%3A%2F%2Fexample.lv%2Fcallback
  &scope=openid%20profile
  &state=4f1c8a…
  &nonce=9b27e0…
  &code_challenge=E9Melhoa…
  &code_challenge_method=S256
  &acr_values=idp%3Asmartid
ParametrsObligātsNozīme
response_typejāVienmēr code
client_idjāIntegrācijas ID no portāla
redirect_urijāPrecīzi jāsakrīt ar portālā reģistrēto adresi
scopejāopenid profile, lai saņemtu vārdu, uzvārdu un personas kodu
stateieteicamsNejauša vērtība aizsardzībai pret CSRF; to pārbauda pēc atgriešanās
nonceieteicamsNejauša vērtība, kas atgriežas ID tokenā
code_challengeieteicamsPKCE izaicinājums ar metodi S256
acr_valuesnēViens eID rīks, piemēram, idp:smartid

Atgriešanās

HTTPGET
https://example.lv/callback?code=ory_ac_…&scope=openid%20profile&state=4f1c8a…

Kods ir derīgs īsu laiku un izmantojams tikai vienu reizi, tāpēc apmainiet to servera pusē uzreiz.

Koda apmaiņa

Pēc noklusējuma integrācija izmanto client_secret_basic: klienta rekvizītus sūta HTTP Basic galvenē. Ja bibliotēka tos sūta pieprasījuma pamattekstā, integrācijas papildu iestatījumos izvēlieties client_secret_post.

Shellclient_secret_basic
curl -X POST https://dorvis.eu/oidc/oauth2/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=authorization_code \
  -d code="$CODE" \
  -d redirect_uri=https://example.lv/callback \
  -d code_verifier="$CODE_VERIFIER"
Shellclient_secret_post
curl -X POST https://dorvis.eu/oidc/oauth2/token \
  -d grant_type=authorization_code \
  -d client_id="$CLIENT_ID" \
  -d client_secret="$CLIENT_SECRET" \
  -d code="$CODE" \
  -d redirect_uri=https://example.lv/callback

Atbilde

JSON
{
  "access_token": "ory_at_…",
  "token_type": "bearer",
  "expires_in": 3599,
  "scope": "openid profile",
  "id_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6…"
}

Neatradāt atbildi?

Rakstiet mums, atbildēs Dorvis izstrādātājs.

Uzdot jautājumu
Ielāde ir pabeigta

Mēs izmantojam sīkdatnes, lai vietne darbotos un mēs varētu to uzlabot. Plašāka informācija ir mūsu privātuma un sīkdatņu politikā.