Usein kysyttyä Palveluväylästä
Tälle sivulle on koottu vastauksia Palveluväylään liittyviin yleisluonteisiin usein kysyttyihin kysymyksiin.
Saat tukea lisäksi Palveluväylän yleiseltä ja teknisen tuelta.
Palveluväylän kautta saatavilla olevat tiedot on kuvattu alijärjestelmien alle LiityntäkatalogiinAvautuu uuteen ikkunaan.. Liityntäkatalogista löydät kaikki Palveluväylän kautta tarjolla olevat palvelut rajapintakuvauksineen sekä palveluiden tekniset lisätiedot ja ylläpitäjän yhteystiedot. Huomioi, että palvelun käytöstä täytyy ensin sopia palvelua tarjoavan organisaation kanssa. Palveluiden käyttöönoton prosessit ja vaadittavat sopimukset voivat vaihdella. Palveluväylä tarjoaa ainoastaan teknisen ratkaisun palveluiden käyttöön. Palveluntarjoajat ovat vastuussa palveluidensa kuvailemisesta Liityntäkatalogiin.
Palveluväylän tarkoituksena on auttaa palvelun tuottajia ja toteuttajia kehittämään tehokkaampia sähköisiä palveluita ja tukemaan tietojen uudelleenkäyttöä. Liityntäkatalogiin kuvataan sähköiset palvelut, joissa käsiteltävät tiedot ovat muiden tietojärjestelmien hyödynnettävissä.
Suomi.fi-palveluväylän testi- tai tuotantoympäristöön liittyminen ja ympäristöissä käytettävät varmenteet ovat liittyjälle maksuttomia.
Asiakasorganisaatio vastaa kuitenkin itse teknisistä muutoksista aiheutuvista kustannuksista, joita voi syntyä esimerkiksi liityntäpalvelimesta ja rajapintoihin tarvittavista muutostöistä.
Ei voi, vaan Suomi.fi-palveluväylää käyttöönottavan organisaation on aina liityttävä testiympäristöön ennen tuotantoympäristöön siirtymistä. Organisaatio voi kuitenkin liittyä testi- ja tuotantoympäristöön samaan aikaan.
Kun Palveluväylään liittymisen ja tarjottavien palveluiden on todettu toimivan oikein, Palveluväylän ylläpito antaa organisaatiolle luvan siirtyä tuotantoympäristöön.
Yhteyden muodostamiseen käytetään kohdeliityntäpalvelimen FQDN-nimeä.
Sovitinpalvelu on X-Roadin liityntäpalvelimen ja liitettävän tietojärjestelmän väliin sijoittuva komponentti, joka sovittaa liitettävän järjestelmän tarjoamat palvelut Palveluväylän X-Road-tiedonsiirtoprotokollan mukaiseen muotoon.
X-Roadin sovitinpalvelusta ja sen toteuttamisesta on kerrottu erillisessä tukiartikkelissa:
Suosittelemme käyttämään HTTPS-protokollaa aina. HTTP-protokollaa voi halutessaan käyttää kehitysympäristössä. HTTPS-protokollaa käyttämällä varmistat, että yhteys liityntäpalvelimen ja tietojärjestelmän välillä on suojattu.
HTTPS-protokollan käyttäminen organisaation tietojärjestelmän ja liityntäpalvelimen välillä on tärkeää, sillä Palveluväylän ohjelmistoon sisältyvä salaus kattaa vain liityntäpalvelimien välisen yhteyden. HTTPS-protokollan ja asiakasvarmenteiden käyttö on pakollista aina, kun useat eri organisaatiot käyttävät samaa liityntäpalvelinta.
Liityntäpalvelimen ja tietojärjestelmän välisen yhteyden salaus sekä yleinen tietoturvallisuus on asiakasorganisaation vastuulla. Jos kaikkia yhteyksiä ei salata, liitynnän tietoturva heikentyy huomattavasti.
Sanomien koolle ei ole olemassa rajoituksia. Suomi.fi-palveluväylä on kuitenkin ensisijaisesti suunniteltu reaaliaikaiseen tietojen vaihtoon massatiedonsiirtojen sijaan. Käytännössä erittäin suurikokoiset sanomat on siis parempi pilkkoa useampaan osaan.
Palveluväylän testi- ja tuotantoympäristöissä tuemme tällä hetkellä Ubuntu 20.04 LTS ja 22.04 LTS sekä RHEL 7 ja 8 Linux-distroja, kun käytät alustapalvelimeen pohjautuvaa liityntäpalvelinta. Jos käytät kontitettua liityntäpalvelinta, voit käyttää mitä vain Linux-jakelua.
Kehitysympäristön puolella myös muiden kuin virallisesti tuettujen distrojen (esim. CentOS) käyttö on mahdollista. Se tapahtuu kuitenkin aina organisaation omalla vastuulla. Palveluväylän ylläpito ei tarjoa tukea muiden kuin virallisesti tuettujen distrojen käytössä mahdollisesti ilmenevien ongelmatilanteiden selvittämiseen.