X-tee märkmed loengust: erinevus redaktsioonide vahel

Allikas: Lambda
Mine navigeerimisribale Mine otsikasti
Resümee puudub
 
(ei näidata sama kasutaja 21 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)
* x-tee keskus RIA-s, mis monitoorib toimuvat, kogub statistikat ja annab asutustele õigusi osaleda või mitte
* x-tee keskus [https://www.ria.ee/ 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? ==
== Mida X-tee teeb ja mis seal sees on? ==
14. 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


Teiseks, tarkvara:
Teiseks, tarkvara:


* on olemas tarkvaratükk nimega x-tee turvaserver (ehitatud algusest peale Cybernetica poolt)
* on olemas tarkvaratükk nimega x-tee turvaserver (ehitatud algusest peale [http://cyber.ee AS Cybernetica] poolt)
** tüüpiliselt pannakse eraldi linuxi purki
** tüüpiliselt pannakse eraldi linuxi purki
** kogu liiklus nii küsijalt kui saajalt läheb läbi nende oma x-tee turvaserveri
** kogu liiklus nii küsijalt kui saajalt läheb läbi nende oma x-tee turvaserveri
31. 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 ==
 
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] 
<!--
* [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
* 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 ==
 
Tutvu lühidalt nende materjalidega:
* 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]
<!--
* ja sirvi kiirelt läbi [https://blog.ria.ee/sissejuhatus-x-teesse-osa-1/ pikem kolmeosaline ülevaade] X-teest Anto Veldrelt.
-->
 
== 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 [https://github.com/nordic-institute/X-Road vabavaraline X-tee githubis] (vaata veidi ka detailsemat [https://www.youtube.com/watch?v=RV-Dq69yFVE videot] kogu asja ülespanemisest). Vaata head NIIS [https://www.youtube.com/watch?v=YWWknjpZCLs videot] asjast ja organisatsioonist. Vana mitte-maintainitav ainult-eesti repo [https://github.com/ria-ee/X-Road 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 [https://link.springer.com/chapter/10.1007%2F978-3-319-69284-5_8 Challenges of Federating National Data Access Infrastructures]
* Peale põhitegija [https://cyber.ee Cybernetica] oma kommertsiaalse [https://cyber.ee/products/secure-data-exchange/ 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 [https://x-road.global/xroad-world-map kaarti], kus peal valik erinevas staadiumis/erineva edukusega projekte X-tee rakendamise kohta (sellel kaardil ei ole kõiki kommerts-juurutusi):
** [https://ega.ee/ E-government academy] for-profit konsultatsioonimeeskond: e-valitsemise konsultatsioonid välismaal, ei anna ise tehnilist konsultatsiooni.
** [https://planetway.com/en/ Planetway]: Jaapanisse müügi tiim.
** Erinevad soomega seotud harud, mh väike [https://www.roksnet.com/ Roksnet]
 
== Ajalugu ==
== Ajalugu ==


* Esialgne idee ja selle promomine riigis oli kolme inimese tiimi poolt: Vello Kadarpik, Tanel Tammet, Ain Järv.
* Esialgne idee, näitepiloot ja selle promomine riigis oli neljast inimesest tiimi poolt: Vello Kadarpik, Tanel Tammet, Hannu Krosing, Ain Järv. Vaata ka [https://x-road.global/xroad-history juttu ja videot esiajaloost] riigipoolsete käivitamisfiguuride poolt.
* kui x-tee algas, siis tegid softi kaks firmat: Cybernetica  ja Assert (viimane pooldus Fujitsu 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)
* algul oli x-tee xml-rpc-ga, siis oli paralleelselt juurde soap, lõpuks jäi ainult soap
* 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, 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
43. 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

Tehnilised detailid

Järgmisena vaata läbi (mõõduka süvenemisega) tehnilisemat infot:

  • Roadmap: mis on plaanis praegu ja lähiaastatel.

Statistika ja kasutus

Tutvu lühidalt nende materjalidega:

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