Dōrvis

Pieslēgties

OpenID Connect integrācija ar visām Latvijas e-identitātēm

Dorvis ir standarta OpenID Connect pakalpojums. Ja platformai ir OIDC bibliotēka, integrācijai parasti pietiek ar konfigurāciju.

Trīs soļi līdz pirmajai pieslēgšanās reizei

  1. Izveidojiet integrāciju. Kad Dorvis komanda ir izveidojusi kontu, pašapkalpošanās portālā norādiet redirect URI un saņemiet client_id un client_secret. Testa rekvizītus var pieprasīt bez līguma.
  2. Pievienojiet OIDC klientu. Izmantojiet Authorization Code plūsmu un discovery adresi no šīs lapas.
  3. Izvēlieties eID rīku. Ar parametru acr_values var uzreiz atvērt konkrētu eID rīku, piemēram, idp:smartid.

OpenID Connect

Portāla serveris novirza lietotāju uz Dorvis pieslēgšanās lapu, saņem kodu un apmaina to pret ID tokenu. Ar pakalpojumu sniedzējiem Dorvis sazinās pats.

Settings
issuer        https://dorvis.eu/oidc
discovery     https://dorvis.eu/oidc/.well-known/openid-configuration
flow          authorization_code
scope         openid profile
acr_values    idp:smartid | idp:eparaksts-mobile | idp:eparaksts | idp:eparaksts-scan | idp:eid | idp:swedbank | idp:seb | idp:citadele | idp:luminor | idp:edim

Dokumentācija

Integrācija no pirmās pieslēgšanās līdz ieviešanai produkcijā ir aprakstīta soli pa solim. Visos piemēros izmantota viena un tā pati Dorvis integrācija.

Sākums

  • Ātrais startsKontu pašapkalpošanās portālā izveido Dorvis komanda pēc pieteikuma. Kad konts ir, pirmā pieslēgšanās ar Digimaku aizņem apmēram 15 minūtes. Digimaks ir pieejams bezmaksas plānā.

Integrācija

  • Pieslēgšanās plūsmaDorvis 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.
  • GalapunktiVisas adreses ir publicētas discovery dokumentā. Ja bibliotēka to atbalsta, pietiek norādīt issuer adresi, un pārējās adreses tā nolasīs pati.
  • eID rīki un acr_valuesParametrs acr_values nosaka, kuru eID rīku atvērt uzreiz. Bez tā lietotājs redz Dorvis izvēles lapu ar visiem integrācijā ieslēgtajiem eID rīkiem.
  • Lietotāja datiAr scope=openid profile ID tokenā ir pārbaudīti vārds, uzvārds un personas kods neatkarīgi no tā, ar kuru eID rīku lietotājs pieslēdzās.
  • IziešanaLai beigtu arī lietotāja Dorvis sesiju, novirziet viņu uz iziešanas galapunktu ar ID tokenu un atgriešanās adresi.

Kods

  • PiemēriKatrs piemērs izpilda to pašu plūsmu: novirza lietotāju uz Dorvis pieslēgšanās lapu, apmaina kodu un nolasa personas kodu. Izvēlieties programmēšanas valodu.

Darbība

  • KļūdasPar kļūdām Dorvis ziņo divās vietās: atgriešanās adresē ar parametru error un tokenu galapunkta atbildē.
  • DrošībaDorvis pārbauda identitāti, bet sesiju un datus lietotnē aizsargā pats e-pakalpojuma sniedzējs. Šie ieteikumi atbilst OpenID Connect un OAuth 2.0 labajai praksei.
  • Ieviešana produkcijāPārbaudiet šos punktus, pirms ieslēdzat Dorvis pieslēgšanos reāliem lietotājiem.

Integrācijas

Kas jāzina izstrādātājam

  • Discovery adrese. Visi galapunkti (authorization, token, jwks, userinfo) ir norādīti discovery dokumentā, tāpēc tie nav jāievada manuāli.
  • acr_values. Bez šī parametra lietotājs redz visus integrācijā ieslēgtos eID rīkus. Norādot vērtību, piemēram, idp:smartid, uzreiz atveras izvēlētais eID rīks.
  • Lietotāja dati. Ar scope profile integrācija saņem given_name, family_name un person_code.
  • Piemēri. Instrukcijās ir gatavi piemēri, ko var palaist lokāli ar saviem piekļuves rekvizītiem.

Piemēri: Node.js, Python, PHP, Java, C#/.NET, Go, WordPress – Piemēri.

Gatavi risinājumi

Dažiem uzdevumiem ir gatavi risinājumi, un integrācija nav jāizstrādā no jauna.

  • WordPress spraudnis – Dorvis Auth pievieno Dorvis pogu WordPress pieslēgšanās formai un sasaista esošos kontus.
  • Dokumentu parakstīšanas API – Dokumentus var parakstīt ar eParakstu, eID vai Smart-ID tieši no dokumentu vadības sistēmas.

Drošība un atbilstība

  • Atslēgas drošā glabātuvē. Klientu rekvizīti un pakalpojumu sniedzēju atslēgas glabājas atsevišķā drošā glabātuvē.
  • Audita žurnāls. Dorvis reģistrē katru pieslēgšanos, lai to varētu uzrādīt auditā.
  • Infrastruktūra Latvijā. Dorvis infrastruktūra atrodas Latvijā, un datu apstrāde atbilst GDPR.

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