X-tee märkmed loengust: erinevus redaktsioonide vahel
Mine navigeerimisribale
Mine otsikasti
Resümee puudub |
|||
| (ei näidata sama kasutaja 10 vahepealset redaktsiooni) | |||
| 1. rida: | 1. rida: | ||
X-tee on eesti riigiasutuste infosüsteemide omavahelise suhtlemise põhisüsteem. Ta on korraga | |||
X-tee on eesti riigiasutuste infosüsteemide omavahelise suhtlemise põhisüsteem. X-tee on API-süsteem asutus-asutus IT süsteemide otsesuhtluseks (P2P), kus kõik kasutavad samu põhimõtteid ja on olemas väike keskne kontrolli/turvamissüsteem. Ta on korraga | |||
* protokoll, ehk sõnumite formaat, mida peab järgima | * protokoll, ehk sõnumite formaat, mida peab järgima | ||
* mõned tarkvaratükid, mida X-tee apide tegemieks tuleb kasutada (peatükk on nn turvaserver, mis tuleb installeerida, konfida, ja mille kaudu apit välja kutsuda ja vastata) | * mõned tarkvaratükid, mida X-tee apide tegemieks tuleb kasutada (peatükk on nn turvaserver, mis tuleb installeerida, konfida, ja mille kaudu apit välja kutsuda ja vastata) | ||
| 10. rida: | 11. rida: | ||
Ehk, kõikvõimalikud muud andmevahetusskeemid (REST liidesed, andmete dumpi upload, mälupulgaga kopeerimine jne jne) on tungivalt mittesoovitavad. | Ehk, kõikvõimalikud muud andmevahetusskeemid (REST liidesed, andmete dumpi upload, mälupulgaga kopeerimine jne jne) on tungivalt mittesoovitavad. | ||
== Mida X-tee teeb ja mis seal sees on? == | == Mida X-tee teeb ja mis seal sees on? == | ||
| 21. rida: | 21. rida: | ||
* on olemas spec, et kuidas konkreetselt teha SOAP apisid et datat küsida ja saata: | * on olemas spec, et kuidas konkreetselt teha SOAP apisid et datat küsida ja saata: | ||
** SOAPi põhine, mõned spetsiaalsed kohustuslikud väljad headeris | ** SOAPi ja REST-i põhine (mõlemid sobivad), mõned spetsiaalsed kohustuslikud väljad headeris | ||
** mismoodi datat tegelikult kodeerid, on suuresti igaühe oma teha | ** mismoodi datat tegelikult kodeerid, on suuresti igaühe oma teha | ||
| 38. rida: | 38. rida: | ||
** peamine lisaväärtus on korrektne ja kontrollitud autentimine, ehk sertidega majandamine. | ** peamine lisaväärtus on korrektne ja kontrollitud autentimine, ehk sertidega majandamine. | ||
** tähelepanek: turvaserverit ei ole väga lihtne konfida | ** tähelepanek: turvaserverit ei ole väga lihtne konfida | ||
== Olulist arendusest == | |||
* [https://x-road.global/ Current x-road] [https://github.com/nordic-institute/X-Road on github] with [https://docs.x-road.global/ docs] developed by [https://www.niis.org/ NIIS]. | |||
* [https://cyber.ee/solutions/interoperability Current Cybernetica activities on the direction] | |||
* [https://en.wikipedia.org/wiki/Gaia-X Gaia-X] and [https://gaia-x.eu/ current activities] | |||
* [https://en.wikipedia.org/wiki/Dataspace dataspaces] and [https://digital-strategy.ec.europa.eu/en/policies/data-spaces eu strategy docs] | |||
== Tehnilised detailid == | == Tehnilised detailid == | ||
| 43. rida: | 51. rida: | ||
Järgmisena vaata läbi (mõõduka süvenemisega) tehnilisemat infot: | Järgmisena vaata läbi (mõõduka süvenemisega) tehnilisemat infot: | ||
* Ansperi ja Willemsoni korralik lühike artikkel [https://research.cyber.ee/~janwil/publ/xroadares07final.pdf X-tee sisulise tehnilise ülevaatega] | * Ansperi ja Willemsoni korralik lühike artikkel [https://research.cyber.ee/~janwil/publ/xroadares07final.pdf X-tee sisulise tehnilise ülevaatega] | ||
<!-- | |||
* [https://www.x-tee.ee/docs/live/xroad/pr-mess_x-road_message_protocol.html x-tee protokolli spec]: seejuures vaata <b>süvenemisega</b> näiteid peatükist [https://www.x-tee.ee/docs/live/xroad/pr-mess_x-road_message_protocol.html#annex-e-example-messages "Annex E Example Messages"]: põhiosa näites on header (seda protokoll spetsifitseeribki), edasiantav data ise on tilluke jupp lõpus Body tagi sees. | * [https://www.x-tee.ee/docs/live/xroad/pr-mess_x-road_message_protocol.html x-tee protokolli spec]: seejuures vaata <b>süvenemisega</b> näiteid peatükist [https://www.x-tee.ee/docs/live/xroad/pr-mess_x-road_message_protocol.html#annex-e-example-messages "Annex E Example Messages"]: põhiosa näites on header (seda protokoll spetsifitseeribki), edasiantav data ise on tilluke jupp lõpus Body tagi sees. | ||
--> | |||
* [https://docs.x-road.global/ praeguse süsteemi doc] eeskätt [https://docs.x-road.global/Protocols/pr-rest_x-road_message_protocol_for_rest.html REST doc] ja [https://docs.x-road.global/Protocols/pr-mess_x-road_message_protocol.html SOAP doc] | |||
<!-- | |||
* sirvi [https://cyber.ee/products/secure-data-exchange/materials/uxp-technical-whitepaper-2018.pdf UXP technical whitepaper] ehk kommertsversiooni tehnilisem ülevaade koos organisatsiooni/korralduse soovituste/põhimõtetega | * sirvi [https://cyber.ee/products/secure-data-exchange/materials/uxp-technical-whitepaper-2018.pdf UXP technical whitepaper] ehk kommertsversiooni tehnilisem ülevaade koos organisatsiooni/korralduse soovituste/põhimõtetega | ||
* vaata lühidalt (tunnetuse jaoks) juhuslikke juppe [http://x-road.ee/docs/est/turvaserveri_kasutusjuhend_14.04_lts.pdf X-road security server manual (detailed)] | * vaata lühidalt (tunnetuse jaoks) juhuslikke juppe [http://x-road.ee/docs/est/turvaserveri_kasutusjuhend_14.04_lts.pdf X-road security server manual (detailed)] | ||
* Kaks screencasti UXP keskserveri konfimisest [https://vimeo.com/321936653 1] ja [https://vimeo.com/321936768 2] | |||
--> | |||
* [https://x-road.global/development-roadmap Roadmap]: mis on plaanis praegu ja lähiaastatel. | |||
== Statistika ja kasutus == | == Statistika ja kasutus == | ||
| 52. rida: | 68. rida: | ||
* vaata [https://www.ria.ee/et/riigi-infosusteem/andmevahetuskiht-x-tee.html riigi ametlikku X-tee lühiülevaadet] sh kindlasti [https://www.x-tee.ee/factsheets/EE/ kasutusstatistika] ja [https://logs.x-tee.ee/visualizer/EE/ fancyd kasutus-seosed] (mõlemid viimased on versioon 6 jaoks, samas on ka vanem versioon kasutusel). | * vaata [https://www.ria.ee/et/riigi-infosusteem/andmevahetuskiht-x-tee.html riigi ametlikku X-tee lühiülevaadet] sh kindlasti [https://www.x-tee.ee/factsheets/EE/ kasutusstatistika] ja [https://logs.x-tee.ee/visualizer/EE/ fancyd kasutus-seosed] (mõlemid viimased on versioon 6 jaoks, samas on ka vanem versioon kasutusel). | ||
* Andres Küti kuueminutist videot [https://www.youtube.com/watch?v=WDk4Ik41IDs X-tee põhipointidest] | * Andres Küti kuueminutist videot [https://www.youtube.com/watch?v=WDk4Ik41IDs X-tee põhipointidest] | ||
<!-- | |||
* ja sirvi kiirelt läbi [https://blog.ria.ee/sissejuhatus-x-teesse-osa-1/ pikem kolmeosaline ülevaade] X-teest Anto Veldrelt. | * ja sirvi kiirelt läbi [https://blog.ria.ee/sissejuhatus-x-teesse-osa-1/ pikem kolmeosaline ülevaade] X-teest Anto Veldrelt. | ||
--> | |||
== Promo ja äri == | == Promo ja äri == | ||
| 69. rida: | 87. rida: | ||
* kui x-tee algas, siis tegid softi kaks firmat: Cybernetica ja Assert (viimane muutis nime Mandatoriks ja pooldus Fujitsu Services Eestiks ja Aktorsiks) | * kui x-tee algas, siis tegid softi kaks firmat: Cybernetica ja Assert (viimane muutis nime Mandatoriks ja pooldus Fujitsu Services Eestiks ja Aktorsiks) | ||
* lisaks tasub alguse kohta vaadata [[Media:Ahto_xtartu.ppt|Ahto Kalja detailset ülevaadet X-tee projekti tekkest aastast 2004]] | * lisaks tasub alguse kohta vaadata [[Media:Ahto_xtartu.ppt|Ahto Kalja detailset ülevaadet X-tee projekti tekkest aastast 2004]] | ||
* algul oli x-tee xml-rpc-ga, siis oli paralleelselt juurde soap, | * algul oli x-tee xml-rpc-ga, siis oli paralleelselt juurde soap, siis jäi ainult soap, siis lisati rest: hetkel nii soap kui rest. | ||
* regulaarselt iga paari aasta tagant (ca 4-5 a) lastakse välja uued versioonid protokollist ja turvaserverist | * regulaarselt iga paari aasta tagant (ca 4-5 a) lastakse välja uued versioonid protokollist ja turvaserverist | ||
<!-- | |||
* Uusim x-tee versioon | * Uusim x-tee versioon | ||
** väiksed kasulikud headeri muutused | ** väiksed kasulikud headeri muutused | ||
| 76. rida: | 95. rida: | ||
** hakati nõudma riistvaralist turvat, st eriseadet arvuti küljes sertidega kindlamaks majandamiseks | ** hakati nõudma riistvaralist turvat, st eriseadet arvuti küljes sertidega kindlamaks majandamiseks | ||
** uuemale üleminek venis mitu aastat pikemaks ja praegugi on käimas mõlemid paralleelselt | ** uuemale üleminek venis mitu aastat pikemaks ja praegugi on käimas mõlemid paralleelselt | ||
--> | |||
Viimane redaktsioon: 20. aprill 2026, kell 08:36
X-tee on eesti riigiasutuste infosüsteemide omavahelise suhtlemise põhisüsteem. X-tee on API-süsteem asutus-asutus IT süsteemide otsesuhtluseks (P2P), kus kõik kasutavad samu põhimõtteid ja on olemas väike keskne kontrolli/turvamissüsteem. Ta on korraga
- protokoll, ehk sõnumite formaat, mida peab järgima
- mõned tarkvaratükid, mida X-tee apide tegemieks tuleb kasutada (peatükk on nn turvaserver, mis tuleb installeerida, konfida, ja mille kaudu apit välja kutsuda ja vastata)
- x-tee keskus Riigi Infosüsteemide Ametis RIA-s, mis monitoorib toimuvat, kogub statistikat ja annab asutustele õigusi osaleda või mitte
Üldpõhimõttena tahab RIA, et: kui riigiasutuse X miski infosüsteem Xi tahab andmeid mõne teise riigiasutuse Y miskist infosüsteemist Yi, siis reeglina peab X:
- uurima, kas on juba olemas mõni X-tee API nende andmete saamiseks: kui jah, küsib endale ligipääsu APIle ja kasutab seda
- kui ei, siis käivitab projekti, et Y teeks sellise X-tee API ja siis X hakkab seda kasutama.
Ehk, kõikvõimalikud muud andmevahetusskeemid (REST liidesed, andmete dumpi upload, mälupulgaga kopeerimine jne jne) on tungivalt mittesoovitavad.
Mida X-tee teeb ja mis seal sees on?
Esiteks, P2P suhtlus:
- P2P suhtlus asutuste infosüsteemide vahel: asutused suhtlevad apide kaudu omavahel, mingit keskust pole, kust data läbi jookseks. Peamine asi seal on API-de autentimine:
- korraga kokkulepe ja keskne süsteem sertidega majandamiseks ehk tuvastamiseks, et kas saatja saaja on ikka see asutus,kes ta ütleb ennast olevat
- seda majandamist teeb x-tee keskus RIA-s
- on olemas spec, et kuidas konkreetselt teha SOAP apisid et datat küsida ja saata:
- SOAPi ja REST-i põhine (mõlemid sobivad), mõned spetsiaalsed kohustuslikud väljad headeris
- mismoodi datat tegelikult kodeerid, on suuresti igaühe oma teha
Teiseks, tarkvara:
- on olemas tarkvaratükk nimega x-tee turvaserver (ehitatud algusest peale AS Cybernetica poolt)
- tüüpiliselt pannakse eraldi linuxi purki
- kogu liiklus nii küsijalt kui saajalt läheb läbi nende oma x-tee turvaserveri
- optsioonid: kas paned oma masinasse (võib virtual olla) või kasutad mingit turvaserveri hostingut
- mida turvaserver veel teeb?
- logib enda kõhtu liikluse metainfot ja osa liikluse sisu, ca ühe kuu jagu: seda detailinfot ei saadeta kuhugile
- nö basic metainfo, et kellega on ühendust võetud ja mis ajal, selle saadab turvaserver keskusesse, st keskuses on piiratud logi: logis on näha osapooled ja aeg ja api calli nimi
- mis on x-tee lisaväärtus versus harilik https?
- peamine lisaväärtus on korrektne ja kontrollitud autentimine, ehk sertidega majandamine.
- tähelepanek: turvaserverit ei ole väga lihtne konfida
Olulist arendusest
- Current x-road on github with docs developed by NIIS.
- Current Cybernetica activities on the direction
- Gaia-X and current activities
- dataspaces and eu strategy docs
Tehnilised detailid
Järgmisena vaata läbi (mõõduka süvenemisega) tehnilisemat infot:
- Ansperi ja Willemsoni korralik lühike artikkel X-tee sisulise tehnilise ülevaatega
- praeguse süsteemi doc eeskätt REST doc ja SOAP doc
- Roadmap: mis on plaanis praegu ja lähiaastatel.
Statistika ja kasutus
Tutvu lühidalt nende materjalidega:
- vaata riigi ametlikku X-tee lühiülevaadet sh kindlasti kasutusstatistika ja fancyd kasutus-seosed (mõlemid viimased on versioon 6 jaoks, samas on ka vanem versioon kasutusel).
- Andres Küti kuueminutist videot X-tee põhipointidest
Promo ja äri
X-tee promo välisriikidesse teevad paljud poliitikud
- Ametlik (vabavaralise) X-tee arendamine toimub viimastel aastatel koos soomlastega organisatsiooni "Nordic Institute for Interoperability solutions" (NIIS) poolt, nende sait on https://x-road.global ja nende hallatav/arendatav vabavaraline X-tee githubis (vaata veidi ka detailsemat videot kogu asja ülespanemisest). Vaata head NIIS videot asjast ja organisatsioonist. Vana mitte-maintainitav ainult-eesti repo leaid siit.
- Seoste tekitamine riikide vahel (a la mitme eri X-tee ühendamine, nagu Eesti ja Soome vahel veidi toimub) on keeruline: Willemson ja Freudenthal Cyberist on selle kohta kirjutanud artikli Challenges of Federating National Data Access Infrastructures
- Peale põhitegija Cybernetica oma kommertsiaalse UXP-variandiga (juhtfiguurid Ansper ja Freudenthal) on veel hulk huvigruppe/firmasid, kes tegelevad X-tee kommertsiaalsete konsultatsioonide, abi, promomise, arenduse jne jne tegevustega välismaale. Vaata kaarti, kus peal valik erinevas staadiumis/erineva edukusega projekte X-tee rakendamise kohta (sellel kaardil ei ole kõiki kommerts-juurutusi):
- E-government academy for-profit konsultatsioonimeeskond: e-valitsemise konsultatsioonid välismaal, ei anna ise tehnilist konsultatsiooni.
- Planetway: Jaapanisse müügi tiim.
- Erinevad soomega seotud harud, mh väike Roksnet
Ajalugu
- Esialgne idee, näitepiloot ja selle promomine riigis oli neljast inimesest tiimi poolt: Vello Kadarpik, Tanel Tammet, Hannu Krosing, Ain Järv. Vaata ka juttu ja videot esiajaloost riigipoolsete käivitamisfiguuride poolt.
- kui x-tee algas, siis tegid softi kaks firmat: Cybernetica ja Assert (viimane muutis nime Mandatoriks ja pooldus Fujitsu Services Eestiks ja Aktorsiks)
- lisaks tasub alguse kohta vaadata Ahto Kalja detailset ülevaadet X-tee projekti tekkest aastast 2004
- algul oli x-tee xml-rpc-ga, siis oli paralleelselt juurde soap, siis jäi ainult soap, siis lisati rest: hetkel nii soap kui rest.
- regulaarselt iga paari aasta tagant (ca 4-5 a) lastakse välja uued versioonid protokollist ja turvaserverist