Trīs soļi līdz pirmajai pieslēgšanās reizei
- 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.
- Pievienojiet OIDC klientu. Izmantojiet Authorization Code plūsmu un discovery adresi no šīs lapas.
- 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.
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:edimDokumentā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_valuesnosaka, 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 profileID 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
errorun 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.






