Dōrvis

Pieslēgties

Keycloak Smart-ID un eParaksts pieslēgšanās ar Dorvis

Keycloak Smart-ID, eParaksts un Latvijas banku pieslēgšanos pievieno, reģistrējot Dorvis pakalpojumu Keycloak realm kā "OpenID Connect v1.0" identitātes sniedzēju. Keycloak darbojas kā starpnieks: tas saglabā pārbaudīto vārdu, uzvārdu un personas kodu lietotāja atribūtos, un lietotnes turpina sazināties tikai ar Keycloak.

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

  1. 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.

  2. 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".

  3. 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.

  4. 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ā.

  5. 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.

  6. 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 lauksVērtībaKāpēc
Discovery endpointhttps://dorvis.eu/oidc/.well-known/openid-configurationImportē visas adreses un parakstu atslēgas
Issuerhttps://dorvis.eu/oidcKeycloak pret to pārbauda iss vērtību
Client authenticationClient secret sent in the request bodyStandarta konfidenciāls klients; noslēpums paliek serverī
Scopesopenid profileprofile atgriež given_name, family_name un person_code
Validate Signatures / Use JWKS URLIeslēgts / ieslēgtsKeycloak pārbauda ID token ar Dorvis atslēgām, kuras Dorvis atjauno automātiski
Sync modeForceKeycloak 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 EmailIzslēgtsDorvis neatgriež e-pasta adresi
First login flow overridefirst broker login (noklusējums) vai pielāgota plūsmaNosaka, kā Keycloak izveido un sasaista jaunus lietotājus
Forwarded query parametersacr_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-smartid

Pirmā 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.

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ā.