LISA 1 – eIDAS autentimismehhanismiga liitumise võimalused ja nende peamised erisused
Enamikele avaliku sektori asutustele peaks olema kõige lihtsam võimalus RIA-s loodud
eesti.ee autentimisteenuse kasutuselevõtt. Selle variandi kasutusele võtmine on kõige
lihtsam, sest see piirdub peamiselt OpenID Connect protokolli kasutusele võtmist senises
autentimisprotseduuris.
Teatud erijuhtudel võib aga kaaluda alternatiivseid autentimislahenduse realisatsioone. Neid
tasub kaaluda kui:
a) autentimiste arv on väga suur (sajad päringud sekundis) – (vt valik 2)
b) autentimisprotsessi läbiviimise käigus teostatakse lisategevusi - (vt valik 3 ja 4)
Iga asutuse jaoks on eIDAS autentimismehhanismiga liitumiseks neli erinevat võimalust (vt
ka joonis 1):
Valik 1. Liituda RIA-s loodud eesti.ee autentimisteenusega
Valik 2. Paigaldada oma infrastruktuurile eesti.ee autentimisteenus ja kasutada eIDAS
autentimismehhanismiga liitumiseks RIA-s paigaldatud eIDAS Connector sõlme.
Valik 3. Luua ise autentimisteenus ja kasutada eIDAS autentimismehhanismiga liitumiseks
RIA-s paigaldatud eIDAS Connector sõlme. Selle variandi kasutusele võtmiseks tuleb luua
autentimisteenuse tarkvara, paigaldada see oma infrastruktuurile ja häälestada see
ühendumiseks RIA-s asuva eIDAS Connector serveriga. Oma infosüsteemi tuleb luua
võimekus ühenduda uue autentimisteenusega kasutades selleks mõnda turvaprotokolli.
Selline lahendus realiseerib suhtluse RIA-s asuva eIDAS Connector serveriga kasutades SAML
ver. 2.0 protokolli ja rakendustega suhtlemiseks kasutatakse OpenID Connect ver. 1.0
protokolli.
Valik 4. Luua kogu autentimislahendus ise – paigaldada eIDAS Connector server, luua sellega
suhtlemiseks (SAML ver. 2.0 protokolliga) oma autentimisteenuse ja kasutades loodud
lahenduse ja rakenduste vaheliseks suhtlemiseks mistahes turvalist protokolli. Sellise
lahenduse korral tuleb arvestada seda, et eIDAS Connector serveri omanik peab vahetama
turvasertifikaadid kõikide Euroopa Liidu liikmesriikide eIDAS Service serverite omanikega.
eIDAS Service servereid on iga Euroopa liidu liikmesriigi kohta üks.
Joonis 1. eIDAS autentimismehhanismiga liitumise võimalused.
eIDAS autentimismehhanismiga liitumisega kaasnevad tööd sõltuvalt valikust on loetletud
tabelis 1.
eIDAS autentimismehhanismiga liitumise Valik 1 Valik 2 Valik 3 Valik 4
tegevused
Eesti.ee autentimisteenusega liitumine
rakenduse administraatori juures + − − −
Eesti.ee autentimisteenuse poole pöördumise
liidese implementeerimine oma infosüsteemis + − −
Autentimislahenduse tarkvara loomine
− − + +/−
Autentimislahenduse paigaldamine oma
infrastuktuurile − + + +
eIDAS Connector serveri teenusega liitumine
rakenduse administraatori juures − + + −
Autentimislahenduse häälestamine
ühendumiseks RIA-s asuva eIDAS Connector
serveriga − + + −
eIDAS Connector serveri paigaldamine oma
infrastruktuurile − − − +
Turvasertifikaatide vahetamine kõikide Euroopa
Liidu liikmesriikide eIDAS Service serveri
haldajatega ja sertifikaatide hilisem haldamine − − − +
Eesti.ee autentimisteenusega liidestumise
(OpenID Connect ver. 1.0) ja
autentimisprotsessi toimimise testimine + − − −
eIDAS Connector serveriga liidese (SAML ver.
2.0) ja autentimisprotsessi toimimise testimine − + + +
RIA-st aktsepti saamine autentimislahenduse
kasutamiseks + + + −
Tabel 1. eIDAS autentimismehhanismiga liitumise erisuste maatriks.
LISA 3 – eesti.ee autentimisteenuse liidese struktuur (OpenID Connect ver. 1.0 vahendusel
edastatavad andmed)
1.1. Redirect tegemine autentimisteenusesse:
Location: autentimisteenuse login lehe aadress
Parameetrid:
response_type=code
&scope=openid profile
&client_id=<autentimist küsiva infosüsteemi ID>
&state=<autentimist küsiva infosüsteemi kasutajasessiooni ID>
&redirect_uri=<aadress, kuhu kasutaja pärast autentimist tagasi suunata>
1.2. Redirect vastus autentimist küsinud infosüsteemi:
Location: <väärtus redirect_uri'st>
Parameetrid:
code=<autentimise identifikaator>
&state=<seostav ID, eelmisest päringust>
2.1. ID tokeni hankimine (autentimist küsiva IS ja autentimisteenuse vahel):
POST autentimisteenuse token endpoint'i
Parameetrid:
grant_type=authorization_code
&code=<autentimise identifikaator eelmisest sammust>
&redirect_uri=<sama aadress nagu 1. päringus>
2.2. ID tokeni vastus (JSON)
id_token: JWT (Json Web Token)
access_token: <OAuth2 access token>
token_type: "Bearer" <OAuth2 token type>
expires_in: <kehtivus, sekundites>
id_token JWT-s sisalduv info (payload osa):
iss: <token'i väljaandja, autentimisteenus>
sub: <autenditud kasutaja ID, kas isikukood või eIDAS ID>
aud: <autentimist küsinud süsteemi client_id>
exp: <token'i aegumisaeg>
iat: <token'i väljaandmisaeg>
auth_time: <kasutaja autentimise aeg>
acr: <autentimistase, vastavalt eIDAS tasemetele>
amr: <autentimisvahend>
3.1. Kasutajainfo (UserInfo) päring
GET päring autentimisteenuse UserInfo endpoint'i
Parameetrid:
Authorization: "Bearer <acces_token väärtus>"
3.2. Kasutajainfo (UserInfo) päringu vastus (JSON)
tagastab OpenID Connect spetsifikatsioonile vastavalt eIDAS kohustuslikud väljad:
sub: <kasutaja ID>
name: <nimi>
given_name: <eesnimi>
family_name: <perekonnanimi>
birthdate: <sünniaeg>
Eesti.ee autentimisteenuse liitumisega seotud küsimustes palume pöörduda RIA kasutajatoe
aadressil
[email protected].
LISA 2 – eIDAS autentimismehhanism ja sellega seotud muudatused infosüsteemides
I. eIDAS autentimismehhanismi kasutusele võtmine
eIDAS lahendus koosneb nelja tüüpi komponentidest:
1. igas riigis üks eIDAS Service server, mis vahendab teiste riikide eIDAS Connector
serveritest saabunud autentimissoove selle riigi autentimislahendustele, selle sama
riigi kodanike autentimiseks teise riigi infosüsteemis.
2. Igas riigis üks või mitu eIDAS Connector serverit, mille poole pöörduvad, selle riigi
rakendused, et autentida teiste riikide kodanikke mõne teise riigi
autentimislahenduses; server vahendab autentimispäringu vastava riigi eIDAS
Service serverile.
3. autentimist vajavad infosüsteemid, mis vajavad autentimist teise Euroopa Liidu
riikide autentimislahendustest ja milleks nad pöörduvad oma riigi eIDAS Connector
serveri poole, mis omakorda küsib autentimist vajaliku riigi eIDAS Service serverilt.
4. Euroopa Liidu erinevate riikide autentimislahendused, milledesse tehakse päringuid
vastava riigi eIDAS Service serveritest selleks, et teostada autentimistoiminguid.
Kõik Eesti avalikud e-teenused (riigi infosüsteemis ja KOV infosüsteemides), mis pakuvad
teenuseid isikutele, kes kasutavad seal enda autentimiseks Eesti Vabariigi poolt tunnustatud
eID-d, peavad pärast 18. septembrit 2018. a. hakkama sisse laskma ka Euroopa Liidu teiste
liikmesriikide poolt aktsepteeritud eID-de kasutajaid. Selle riigisiseseks ühetaoliseks
toimimiseks on RIA loonud eesti.ee juurde autentimisteenuse (edaspidi: eesti.ee
autentimisteenus), mis võimaldab autentimist nii Eesti Vabariigi poolt aktsepteeritud eID-
dega kui ka teiste Euroopa Liidu liikmesriikide poolt aktsepteeritud eID-dega pöördudes
selleks eIDAS infrastruktuuri poole. Selleks on RIA-s paigaldatud eIDAS sõlm, mis sisaldab nii
eIDAS Service kui ka eIDAS Connector serverit.
eIDAS Service sõlmes on realiseeritud ühendus Eestis kasutatavate autentimislahendustega.
Seda serverit kasutavad läbi eIDAS infrastruktuuri teiste riikide avalikke teenuseid pakkuvad
infosüsteemid selleks, et sinna saaks autentida Eesti eID-d omavad isikud.
eIDAS Connector sõlme poole pöördutakse eesti.ee autentimisteenusest selleks, et küsida
teise riigi kodaniku autentimist selle riigi eIDAS Service sõlme käest.
Eesti poolse autentimise lahenduse komponentskeem on esitatud joonisel 1.
Joonisel 1 kirjeldatud komponentide tähendused on järgmised:
„Rakendus 1 … Rakendus 2“ – avalikku teenust pakkuvad infosüsteemid, mis vajavad eIDAS
autentimismehhanismi ja mis on saavad seda läbi eesti.ee autentimisteenuse.
„eesti.ee autentimisteenus“ – eesti.ee autentimisteenus koos kõige vajalikuga selle
toimimiseks.
„Autentimismoodul“ – autentimisteenuse osa, mis realiseerib autentimisteenuse
funktsionaalsuse; suhtleb autentimisteenust kasutavate rakendustega kasutades OpenID
Connect ver. 1.0 protokolli. eIDAS infrastruktuuriga suhtlemiseks kasutab SAML ver. 2.0
protokolli.
„eIDAS Node“ – eIDAS sõlm (server), mis sisaldab kas eIDAS Service-t ja eIDAS Connector-it
või ühte nendest; ühe riigi kohta on üks eIDAS Service ning üks või mitu eIDAS Connector.
„Connector“ – eIDAS infrastruktuuri komponent (eIDAS Connector), mis vahendab Eesti
avalikke teenuseid pakkuvate infosüsteemide päringuid teiste riikide eIDAS Service
serveritele. Eestis on üks eIDAS Connector ja eIDAS Service installeeritud RIA-s. Komponent
eIDAS Service ei kajastu sellel joonisel, kuna ta seostub ainult Eesti eID-d omavate isikute
autentimisega teiste riikide infosüsteemides, mida käesolev dokument ei kirjelda.
„Middleware plug-in 1 … Middleware plug-in 2“ – On riike, kes kasutavad autentimisteenuse
pakkumiseks middleware lahendusi. Iga selline riik peab teiste riikide eIDAS Connector
sõlmede jaoks tarnima middleware puginad; serverisse kapseldatud tehniline komponent,
mis ei mõjuta eesti.ee autentimisteenuse toimimist.
„Teise riigi eIDAS Service sõlm“ – Teise riigi eIDAS infrastruktuuri sõlm, mille poole
pöördutakse autentimise teostamiseks.
Joonis 1. Rakenduse seostamine eesti.ee autentimisteenusega.
II. Kasutajate autoriseerimine ja teenustele juurdepääsu piiramine
Autentimisteenuse kasutusele võtmine on eIDAS määruse rakendamise esimene samm.
Lisaks autentimisskeemi muudatusele tuleb infosüsteemis teha veel järgmisi tegevusi:
1. Autenditud kasutajate jagamine õiguste tasemetesse ja nende tasemete
kirjeldamine autoriseerimissüsteemis:
Grupp Autentimisvahend Õiguste tase Liigitamise alus
Eesti kodanik EE eID kodanik eID
Eesti resident EE eID resident eID ja
(elamisluba, rahvastikuregister
mittekodanik) (vastus „on
elamisluba“ või „on
mittekodanik“)
e-resident EE eID mitte-resident eID
EL eIDAS resident eIDAS,
kodanik/resident, rahvastikuregister
kes on ühtlasi EE (vastus „on EE
resident resident“)
EL kodanik/resident eIDAS mitte-resident eIDAS,
rahvastikuregister
(vastus „ei ole EE
resident“)
2. Teenuste inventuuri tegemine ja otsustamine, milliseid teenuseid saab pakkuda
milliste tasemete kasutajatele. Iga teenuse juures peavad olema määratud kõik need
kasutajate tasemed, kelledele antud teenust pakkuda saab. Seda sama tuleb teha ka
kõigi tulevikus loodavate teenustega.
3. Teenustele juurdepääsu piiramine sõltuvalt autoriseerinud kasutaja tasemest. Kui
teenuse poole pöördub isik, kes kuulub tasemele, mida konkreetse teenuse puhul ei
ole kirjeldatud, siis lükatakse teenuse poole pöördumise soov tagasi.
III. Muudatused infosüsteemi funktsioonides ja andmebaasides
Eesti infosüsteemis kasutatakse isikute unikaalse identifikaatorina 11-kohalist isikukoodi.
eIDAS infrastruktuuri kaudu autentimisel saabub token’i sees eIDAS identifikaator. Selle
pikkus on meile teadmata. Nendel juhtudel, kus riigis on kasutusel isikukood, langeb eIDAS
identifikaator sellega kokku.
Kui riigis isikukood puudub peab eIDAS infrastruktuur (antud juhul vastava riigi
autentimislahendus) genereerima isikule eIDAS identifikaatori, mis on unikaalne selles riigis
ja „pikema aja jooksul muutumatu“ st on võimalik, et mõnedes riikides isikute eIDAS
identifikaator võib muutuda. Meid see ei mõjuta, kuna on otsustatud, et erineva eIDAS
identifikaatoriga isikud on erinevad isikud. Kahte erinevat identiteeti võib liita ainult
biomeetrilise võrdluse alusel.
eIDAS autentimismehhanismi kaudu Eesti infosüsteemis autentinud ja teenust saanud
isikutel tuleb isikukoodi asemel kasutada eIDAS identifikaatorit, millele on lisatud prefiksina
riigi kahekohaline kood (ISO-2)
Andmebaasides tuleb üle kontrollida isikukoodi välja pikkus ja muuta seda vajadusel selliselt,
et sinna mahuks sisse pikem väärtus kui 11 kohta (sinna peab mahtuma ka eIDAS
identifikaator, mille pikkus on riikide kaupa teadmata, kuid tõenäoliselt 11-st erinev). Lisaks
sellele tuleb üle vaadata tulenevate tarkvaramuudatuste tegemine.
Isikukoodi välja soovituslik pikkus on 64 sümbolit.