Plūsma soli pa solim
- Lietotne novirza lietotāju uz Dorvis authorization galapunktu ar
client_id,redirect_uri,scope,stateunnonce. - Ja
acr_valuesnav 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ā. - Pēc veiksmīgas pieslēgšanās Dorvis novirza lietotāju atpakaļ uz
redirect_uriar parametriemcodeunstate. - Lietotnes serveris pārbauda
stateun nosūta kodu kopā ar klienta rekvizītiem uz tokenu galapunktu. - Atbildē ir
id_tokenunaccess_token. ID tokenā ir lietotāja vārds, uzvārds, personas kods un izmantotais eID rīks. - Lietotnes serveris pārbauda ID tokena parakstu,
iss,aud,expunnonceun izveido savu sesiju.
Autorizācijas pieprasījums
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| Parametrs | Obligāts | Nozīme |
|---|---|---|
response_type | jā | Vienmēr code |
client_id | jā | Integrācijas ID no portāla |
redirect_uri | jā | Precīzi jāsakrīt ar portālā reģistrēto adresi |
scope | jā | openid profile, lai saņemtu vārdu, uzvārdu un personas kodu |
state | ieteicams | Nejauša vērtība aizsardzībai pret CSRF; to pārbauda pēc atgriešanās |
nonce | ieteicams | Nejauša vērtība, kas atgriežas ID tokenā |
code_challenge | ieteicams | PKCE izaicinājums ar metodi S256 |
acr_values | nē | Viens eID rīks, piemēram, idp:smartid |
Atgriešanās
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.
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"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/callbackAtbilde
{
"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.






