X-tee märkmed loengust: erinevus redaktsioonide vahel

Allikas: Lambda
Mine navigeerimisribale Mine otsikasti
Uus lehekülg: '<pre> x-tee ------ mida ta teeb? - põhimõtted: - P2P: asutused suhtlevad apide kaudu omavahel, mingit keskust pole kust data läbi jookseks - API-de autentim...'
 
 
(ei näidata sama kasutaja 24 vahepealset redaktsiooni)
1. rida: 1. rida:
<pre>
x-tee
------


mida ta teeb?


- põhimõtted:
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 [https://www.ria.ee/ Riigi Infosüsteemide Ametis] RIA-s, mis monitoorib toimuvat, kogub statistikat ja annab asutustele õigusi osaleda või mitte


  - P2P:
Ü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:
    asutused suhtlevad apide kaudu
* uurima, kas on juba olemas mõni X-tee API nende andmete saamiseks: kui jah, küsib endale ligipääsu APIle ja kasutab seda
    omavahel, mingit keskust pole
* kui ei, siis käivitab projekti, et Y teeks sellise X-tee API ja siis X hakkab seda kasutama.
kust data läbi jookseks
 
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 <B>API-de autentimine</b>:
** 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
  - API-de autentimine:
* on olemas spec, et kuidas konkreetselt teha SOAP apisid et datat küsida ja saata: 
    kokkulepe ja keskne süsteem
**  SOAPi ja REST-i põhine (mõlemid sobivad), mõned spetsiaalsed kohustuslikud väljad headeris
    sertidega majandamiseks ehk
**  mismoodi datat tegelikult kodeerid, on suuresti igaühe oma teha
tuvastamiseks, et kas saatja/
 
saaja on ikka see asutus,
Teiseks, tarkvara:
kes ta ütleb ennast olevat
 
    Seda majandamist teeb x-tee
* on olemas tarkvaratükk nimega x-tee turvaserver (ehitatud algusest peale [http://cyber.ee AS Cybernetica] poolt)
keskus.
** 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
- on olemas spec, et kuidas
 
  konkreetselt teha SOAP apisid
* mida turvaserver veel teeb?
  et datat küsida ja saata
** 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
  - SOAP
 
  - kohustuslikud väljad headeris
* mis on x-tee lisaväärtus versus harilik https?
 
** peamine lisaväärtus on korrektne ja kontrollitud autentimine, ehk sertidega majandamine.
  - mismoodi datat tegelikult
** tähelepanek: turvaserverit ei ole väga lihtne konfida
    kodeerid, on suuresti igaühe
 
oma teha
== 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.


- tarkvaratükk nimega
== Statistika ja kasutus ==
  x-tee turvaserver
 
  reeglina pannakse eraldi linuxi
  purki
 
  kogu liiklus nii küsijalt kui
  saajalt läheb läbi nende oma
  x-tee turvaserver
 
  optsioon:
  - oma masinasse (võib virtual olla)
  - kasutad mingit turvaserveri
    hostingut


  mida turvaserver veel teeb?
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).
  - logib enda kõhtu liikluse
* Andres Küti kuueminutist videot [https://www.youtube.com/watch?v=WDk4Ik41IDs X-tee põhipointidest]
    metainfot ja osa liikluse
<!--
sisu, ca ühe kuu jagu
* ja sirvi kiirelt läbi [https://blog.ria.ee/sissejuhatus-x-teesse-osa-1/ pikem kolmeosaline ülevaade] X-teest Anto Veldrelt.
-->
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?


  Lisaväärtus on korrektne ja
== Promo ja äri ==
  kontrollitud autentimine, ehk
  sertidega majandamine.
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].
- tähelepanek: turvaserverit
* 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]
  ei ole väga lihtne konfida
* 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.
- ajalugu:
** [https://planetway.com/en/ Planetway]: Jaapanisse müügi tiim.
** Erinevad soomega seotud harud, mh väike [https://www.roksnet.com/ Roksnet]


  - kui x-tee algas, siis tegid
== Ajalugu ==
    softi kaks firmat:
Cybernetica
Assert ....      Fujitsu
        .... Aktors
  - algul oli x-tee xml-rpc-ga
    siis oli paralleelselt juures
soap
  - lõpuks ainult soap
 
  - regulaarselt iga paari aasta
    tagant (ca 4-5 a) uued versioonid
Uusim x-tee versioon
  - väiksed kasulikud headeri
    muutused
  - selle asemel et öelda
    organisatsiooni id,
    on nüüd ka alamorganisatsiooni
    id
  - hakati nõudma riistvaralist
    turvat, st eriseadet arvuti
    küljes sertidega kindlamaks
    majandamiseks


  - uuemale üleminek venis
* 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.
    planeeritust 1.5 a hiljemaks
* kui x-tee algas, siis tegid softi kaks firmat: Cybernetica  ja Assert (viimane muutis nime Mandatoriks ja pooldus Fujitsu Services Eestiks ja Aktorsiks)
    ja praegu on käimas mõlemid
* lisaks tasub alguse kohta vaadata [[Media:Ahto_xtartu.ppt|Ahto Kalja detailset ülevaadet X-tee projekti tekkest aastast 2004]]
    paralleelselt
* 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
</pre>
<!--
* Uusim x-tee versioon
** väiksed kasulikud headeri muutused
** selle asemel et öelda organisatsiooni id, on nüüd ka alamorganisatsiooni id
** 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
-->

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