Andmejälgija / Data Tracker

⚠️ Teavitus: uus protokoll (v3) on tulekul

Selles repositooriumis kirjeldatud kasutusteabe esitamise protokoll (v2) on Andmejälgija praegu kasutusel olev protokoll. See jääb esialgu tööle, kuid on plaanis asendada uue protokolliga (v3), mille spetsifikatsioon on saadaval siin:

• dumonitor-openapi-v3.yaml (findUsage v3 teenuse kirjeldus)
• X-tee Andmejälgija laiendus REST-protokollile ja SOAP-protokollile

Üleminek on seotud avaliku teabe seaduse muutmise ja sellega seonduvalt teiste seaduste muutmise seaduse eelnõuga, mis loob Andmejälgijaga liidestumise kohustuse. Eelnõu on hetkel menetluses ega ole veel vastu võetud; sellega saab tutvuda eelnõude infosüsteemis.

Soovitus: kui alustate uut liidestumist või planeerite arendusressursse, arvestage juba v3 protokolliga, et vältida topelttööd. Uue protokolli olulisim muudatus: Andmejälgijasse edastab andmesubjektiga seotud päringu logikirjed andmekogu vastutav töötleja, kes andmeid päris.

Küsimuste korral pöörduge: klient@ria.ee

Soovid Andmejälgijaga liidestuda? Vaata liidestumise protsessi.

Andmejälgija üldine kirjeldus

Andmejälgija on inimesele suunatud teenus eesti.ee-s, mille eesmärgiks on tagada isikuandmete töötluse läbipaistvus avalikus sektoris. Andmejälgija toetub iga andmekogu võimekusele enda sees toimuvat andmetöötlust logide kujul talletada, et seda hiljem inimesele ehk andmesubjektile eesti.ee-s oleva teenuse kaudu kuvada.

Arhitektuurselt on tegemist täielikult hajusa süsteemiga, st inimesele kuvatav info pärineb otse Andmejälgija teenuse realiseerinud andmekogust. Eesti.ee teeb kasutaja soovil päringu igasse Andmejälgija teenusesse ning kuvab päringuvastuse ilma salvestamata välja.

Liidestumise protsess

Asutustele, kes soovivad riigiportaali andmejälgijaga liidestuda. Sammud 1 kuni 4 ja 6 teeb liidestuv asutus, sammud 5 ja 7 RIA. Taotluse (2) ja lepingu (6) võib käivitada kohe, paralleelselt arendusega.

1. Teenuse arendus: Arendada oma X-tee alamsüsteemi findUsage teenus vastavalt kasutusteabe esitamise protokollile. Eelduseks on, et andmekogu logib isikuandmete töötlust; mida logida, kirjeldab Rakendusjuhend.
2. Liitumistaotlus: Asutuse allkirjaõiguslikul isikul täita ja allkirjastada andmejälgija liitumistaotlus ning saata see aadressile klient@ria.ee või edastada DHX kaudu.
3. Ligipääsude avamine: Anda X-tee turvaserveris findUsage teenusele ligipääs järgmistele RIA alamsüsteemidele:
   • ee-dev/GOV/70006317/datatracker
   • ee-test/GOV/70006317/datatracker
   • EE/GOV/70006317/datatracker
   • Märkus: Toodangu ligipääsu võib avada pärast lepingu sõlmimist, kuid enne päringu toodangusse minekut.
4. Testandmed: Luua oma testkeskkonna andmekogusse kasutusteabe kirjed (logikirjed) RIA testisiku isikukoodile 60001019906, nii et findUsage teenus ee-test X-teel need tagastab. Muu testisiku kasutamine lepitakse eelnevalt RIA-ga kokku.
5. Testimine: RIA teeb ee-test X-teel teenusele päringu ja kontrollib, et vastus vastab protokollile. Seejärel lisab RIA teenuse riigiportaali stage-keskkonda, kus asutus saab tulemust ise vaadata, logides sisse testisikuna. Stage-keskkonda pääseb ainult lubatud IP-aadressidelt, seega saadab asutus RIA-le IP-aadressid, millelt kontrollitakse.
6. Leping: Sõlmida RIA-ga andmetöötlusleping. Leping saata aadressile klient@ria.ee täidetult, aga allkirjastamata. Lepingu võib käivitada kohe koos liitumistaotlusega (punkt 2).
7. Toodang: Kui teenus on testitud, leping sõlmitud ja toodangu X-tee ligipääs (punkt 3) avatud, lisab RIA teenuse riigiportaali Andmejälgijasse ja see muutub eesti.ee-s inimestele nähtavaks.

Andmejälgijas kajastuv info

Andmejälgija peab inimesele kuvama infot nii andmekogus lokaalselt toimuvast andmetöötlusest (ametnike-töötajate tegevused isikuandmetega) kui ka ülevaadet sellest, kui andmeid on edastatud mõnele kolmandale osapoolele (üle X-tee teisele riigiasutusele, ettevõttele jm).

Soovituslik on Andmejälgija funktsionaalsuse peale mõelda juba infosüsteemi projekteerides, arvestades vajadusega süsteemis toimuv andmetöötlus tulevikus inimeste jaoks läbipaistvaks ja arusaadavaks muuta.

Andmejälgija funktsionaalsuse loomine infosüsteemile või andmekogule

Oluline on esmalt luua andmekogus toimuvat andmetöötlust kajastav logi.

Andmetöötlusfaktid (logid) tuleb teha publitseeritavaks X-teel. Selleks on kasutusel standardiseeritud teenus findUsage, mis võimaldab kuvada logi eesti.ee sektsioonis Andmejälgija. X-tee turvaserveris tuleb registreerida asutuse alamsüsteemi pakutav teenus (findUsage), mis väljastab andmejälgija kasutusteabe esitamise protokollile vastavalt logid. X-teel avatava teenuse findUsage spetsifikatsioon on dokumendis "Kasutusteabe esitamise protokoll". Liidestus tuleb teha REST päringu põhjal.

X-tee turvaserveris on vaja ning teenus teha kättesaadavaks riigiportaalile, LIVE keskkonna tunnus EE/GOV/70006317/datatracker. Testkeskkonna tunnus EE-TEST/GOV/70006317/datatracker ja arenduskeskkonna tunnus on EE-DEV/GOV/70006317/datatracker.

Andmejälgida teenuse kasutusele võtmisega seotud juriidilise infoga saad tutvuda dokumendis "Rakendusjuhend".

Andmetöötluslepingu sõlmimine RIA ning andmejälgijat kasutava asutuse vahel

Leping sõlmitakse RIA ja andmejälgija teenust pakkuva asutuse vahel.

• Andmejälgijaga liitumislepingu vormi fail on "Andmejälgija liitumislepingu põhi".

Taotlus andmejälgija teenuse avamiseks riigiportaalis eesti.ee

Andmekogu omav asutus esitab eesti.ee-le taotluse teenuse avamiseks. Vajalik info:

• Teenuse nimi riigiportaalis (eesti, inglise ja vene keeles); kuvatakse kasutajale dropdown menüüs.

• X-tee alamsüsteemi nimetus, mille vahendusel andmejälgija teenust pakutakse.

• Teenuse sisulise omaniku kontaktandmed (nimi, ametikoht, e-post, asutus). Kontaktisik, kellega võetakse ühendust teenuse osutamist puudutavate üldiste küsimuste korral.

• Teenuse andmekogu spetsiifiline kirjeldus riigiportaalis avaldamiseks (eesti, inglise ja venekeelne variant). Kirjeldus andmekogu inimmõistetavast eesmärgist ning üldine kirjeldus selles toimuvast andmetöötlusest.

• Andmejälgijaga liitumistatoluse vormi fail on "Andmejälgija liitumistaotluse põhi".

Kontakt ja täpsem info

Liidestumisega seotud küsimuste puhul palume võtta ühendust Riigi Infosüsteemi Ameti kasutajatoega klient@ria.ee.