Kas nepieciešams pirms sākšanas
- Keycloak realm ar administratora piekļuvi. Lauku nosaukumi atbilst pašreizējai Keycloak administrēšanas konsolei (identitātes sniedzēju saskarne kopš Keycloak 24).
- Dorvis konts un integrācija pašapkalpošanās portālā. Bezmaksas plānā pieejams Digimaks; Smart-ID, eParaksts un banku pieslēgšanai nepieciešams maksas plāns.
- Līgums ar SK ID Solutions Smart-ID produkcijas videi un līgumi ar bankām banku pieslēgšanai. Pieteikumus uzņēmuma vietā var sagatavot Dorvis komanda, ja izvēlēts starta komplekts.
- Sniedzēja aizstājvārds (alias), piemēram,
dorvis. Tas kļūst par daļu no novirzīšanas adreses, tāpēc vēlāk to nevar mainīt, nepārreģistrējot adresi.
Kā pievienot Dorvis pakalpojumu kā OpenID Connect identitātes sniedzēju
Reģistrējiet novirzīšanas adresi Dorvis portālā
Dorvis portālā izveidojiet integrāciju ar novirzīšanas adresi
https://KEYCLOAK_HOST/realms/REALM/broker/dorvis/endpoint(aizstājiet serveri, realm un aizstājvārdu). Keycloak šo pašu vērtību rāda sniedzēja lapā laukā Redirect URI. Nokopējiet Dorvis izsniegto client ID un client secret.Izveidojiet sniedzēju
Administrēšanas konsolē atveriet Identity providers un izvēlieties OpenID Connect v1.0. Laukā Alias ierakstiet
dorvis, laukā Display name – tekstu, ko redzēs lietotāji, piemēram, "Smart-ID, eParaksts vai banka".Importējiet Dorvis metadatus
Atstājiet ieslēgtu Use discovery endpoint un laukā Discovery endpoint ielīmējiet
https://dorvis.eu/oidc/.well-known/openid-configuration. Keycloak pats aizpilda autorizācijas, token, user info, izrakstīšanās, issuer un JWKS adreses.Iestatiet klienta autentifikāciju
Laukā Client authentication izvēlieties Client secret sent in the request body (Dorvis pieņem arī HTTP Basic), tad ievadiet Client ID un Client Secret no Dorvis portāla. Noslēpumu Keycloak var nolasīt arī no savas drošās glabātuves (vault), nevis glabāt realm konfigurācijā.
Pārbaudiet papildu iestatījumus
Sadaļā Advanced laukā Scopes ierakstiet
openid profile, atstājiet ieslēgtus Validate Signatures un Use JWKS URL un izvēlieties Sync mode (skatīt tabulu zemāk). Saglabājiet.Pievienojiet kartētājus un notestējiet
Cilnē Mappers pievienojiet zemāk aprakstītos atribūtu kartētājus, tad pieslēdzieties realm konta konsolē ar Dorvis pogu, izmantojot testa identitāti.
Ieteicamie Keycloak iestatījumi Dorvis pakalpojumam
| Keycloak lauks | Vērtība | Kāpēc |
|---|---|---|
| Discovery endpoint | https://dorvis.eu/oidc/.well-known/openid-configuration | Importē visas adreses un parakstu atslēgas |
| Issuer | https://dorvis.eu/oidc | Keycloak pret to pārbauda iss vērtību |
| Client authentication | Client secret sent in the request body | Standarta konfidenciāls klients; noslēpums paliek serverī |
| Scopes | openid profile | profile atgriež given_name, family_name un person_code |
| Validate Signatures / Use JWKS URL | Ieslēgts / ieslēgts | Keycloak pārbauda ID token ar Dorvis atslēgām, kuras Dorvis atjauno automātiski |
| Sync mode | Force | Keycloak pārņem vārda izmaiņas katrā pieslēgšanās reizē; izvēlieties Import, ja lietotāji vārdu drīkst labot Keycloak |
| Trust Email | Izslēgts | Dorvis neatgriež e-pasta adresi |
| First login flow override | first broker login (noklusējums) vai pielāgota plūsma | Nosaka, kā Keycloak izveido un sasaista jaunus lietotājus |
| Forwarded query parameters | acr_values (tikai variantam B zemāk) | Nodod Dorvis pakalpojumam lietotnes izvēlēto eID rīku |
Kā kartēt given_name, family_name un person_code uz lietotāja atribūtiem
Katrai vērtībai pievienojiet Attribute Importer kartētāju: Claim given_name → User Attribute Name firstName un family_name → lastName. Personas kodam – Claim person_code → User Attribute Name person_code.
Kopš Keycloak 24 deklaratīvais lietotāja profils ir vienmēr aktīvs, un nepārvaldītie atribūti pēc noklusējuma ir atslēgti. Tāpēc vispirms aprakstiet person_code sadaļā Realm settings → User profile. Lietotājiem to atstājiet tikai lasāmu un rādiet tikai administratoriem, ja vien lietotnēm tas nav nepieciešams token.
Pievienojiet arī Username Template Importer ar veidni ${ALIAS}.${CLAIM.sub}, lai lietotājvārdos nebūtu personas koda. Ja person_code jānodod lietotnei, pievienojiet tās Keycloak klientam "User Attribute" protokola kartētāju – tikai tiem klientiem, kuriem tas tiešām nepieciešams (par VDAR).
Kā izvēlēties eID rīku: acr_values Keycloak vidē
Bez acr_values Dorvis rāda savu izvēlni ar visiem integrācijā ieslēgtajiem eID rīkiem. Tas ir vienkāršākais variants: viens Keycloak sniedzējs, viena poga.
Variants A: atsevišķs sniedzējs katram eID rīkam (ja nepieciešamas atsevišķas pogas). Izveidojiet sniedzēju katram eID rīkam, piemēram, ar aizstājvārdiem dorvis-smartid un dorvis-eparaksts. Adreses ievadiet manuāli ar izslēgtu Use discovery endpoint un laukā Authorization URL pievienojiet acr_values parametru, piemēram, https://dorvis.eu/oidc/oauth2/auth?acr_values=idp:smartid. Keycloak veido novirzīšanu no šīs adreses un saglabā esošos vaicājuma parametrus. Katram aizstājvārdam Dorvis integrācijā nepieciešama sava novirzīšanas adrese.
Variants B: eID rīku izvēlas lietotne. Vienam sniedzējam laukā Forwarded query parameters ierakstiet acr_values. Tad Keycloak nodod Dorvis pakalpojumam vērtību no lietotnes autorizācijas pieprasījuma. Kopš Keycloak 26.4.2 tas jānorāda skaidri. Keycloak pats izmanto acr_values arī pastiprinātai autentifikācijai (step-up), tāpēc pirms ieviešanas produkcijas vidē pārbaudiet šo variantu ar sava realm ACR un LoA kartējumu.
Vērtības: idp:smartid, idp:eparaksts-mobile, idp:eparaksts, idp:swedbank, idp:seb, idp:citadele, idp:luminor vai idp:edim (Digimaks). Vienā pieprasījumā Dorvis ņem vērā vienu vērtību.
Piemērs: atsevišķi Keycloak sniedzēji Smart-ID un eParaksts pieslēgšanai
Katra sniedzēja Authorization URL norāda vienu eID rīku. Lietotnes var izlaist Keycloak pieslēgšanās lapu ar kc_idp_hint.
# Sniedzējs "dorvis-smartid"
Authorization URL: https://dorvis.eu/oidc/oauth2/auth?acr_values=idp:smartid
Token URL: https://dorvis.eu/oidc/oauth2/token
User Info URL: https://dorvis.eu/oidc/userinfo
Issuer: https://dorvis.eu/oidc
JWKS URL: https://dorvis.eu/oidc/.well-known/jwks.json
# Sniedzējs "dorvis-eparaksts"
Authorization URL: https://dorvis.eu/oidc/oauth2/auth?acr_values=idp:eparaksts-mobile
# Lietotnes saite uzreiz uz Smart-ID
https://KEYCLOAK_HOST/realms/REALM/protocol/openid-connect/auth
?client_id=mana-lietotne&response_type=code&scope=openid
&redirect_uri=https://lietotne.example.lv/callback
&kc_idp_hint=dorvis-smartidPirmā pieslēgšanās un Keycloak pieslēgšanās lapas izlaišana
Kad lietotājs pirmo reizi pieslēdzas ar Dorvis, Keycloak izpilda first broker login plūsmu. Tās solis Review Profile prasa trūkstošos obligātos datus, un noklusējuma lietotāja profilā e-pasts ir obligāts, bet Dorvis to nesūta. Ļaujiet lietotājiem e-pastu ievadīt šajā solī vai padariet email neobligātu sadaļā Realm settings → User profile, ja lietotnei tas nav nepieciešams.
Neizmantojiet automātisku kontu sasaisti pēc e-pasta. Esošus kontus sasaistiet pēc person_code pielāgotā plūsmā vai savā reģistrācijas procesā.
Ja Dorvis jābūt vienīgajam pieslēgšanās veidam, atveriet Authentication → browser plūsmu, rindā Identity Provider Redirector noklikšķiniet uz zobrata ikonas un laukā Default Identity Provider norādiet dorvis. Lietotnes to var mainīt katrā pieprasījumā ar kc_idp_hint.
Neatradāt atbildi?
Rakstiet mums, atbildēs Dorvis izstrādātājs.






