dokumendiregister.ee
OtsingAsutusedMCP
dokumendiregister.eeAsutusedEesti avalike dokumendiregistrite otsing · nimistu.ee andmetel
Otsing›Riigi Kaitseinvesteeringute Keskus
Sissetulev kiriAvalik

Kiri

Riigi Kaitseinvesteeringute Keskus · 13. aprill 2017
Viit
8-1/17/1104
Registreeritud
13. aprill 2017
Dokumendi liik
Sissetulev kiri
Adressaat
Riigi Infosüsteemi Amet
Saabumis/saatmisviis
E-post
Funktsioon
- -
Sari
- -
Toimik
- -

Failid

  • 📎20170413_RIA_eIDAS.asice1180 KB

Sisu (failidest)

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.
Allikas: Riigi Kaitseinvesteeringute Keskus dokumendiregister →