Palvelukuvaus

Suomi.fi-palveluväylä tarjoaa tietoturvallisen tavan siirtää tietoa eri organisaatioiden tietojärjestelmien välillä. Palveluväylän kautta organisaatiot voivat hyödyntää toistensa tarjoamia palveluita ja tietovarantoja sekä tarjota omia palveluitaan muiden käyttöön. 

Mikä Palveluväylä on?

Palveluväylä on tekninen ratkaisu organisaatioiden väliseen tiedonsiirtoon. Sen avulla organisaatio voi tuoda tarvittavia tietoja muiden organisaatioiden järjestelmistä omiin järjestelmiinsä tietoturvallisesti. Näin tiedot ovat aina ajantasaisia ja saatavilla reaaliajassa. Esimerkiksi varhaiskasvatuksen järjestäjä voi hakea ajankohtaisia huoltajuustietoja tai vakuutusyhtiö edunvalvontatietoja suoraan Palveluväylän kautta.

Palveluväylässä tieto kulkee organisaatioiden välillä erillisten liityntäpalvelimien kautta. Jokainen Palveluväylään liittynyt organisaatio tarvitsee oman liityntäpalvelimen. Liityntäpalvelimen avulla organisaatio pääsee hyödyntämään Palveluväylään liitettyjä alijärjestelmiä. Alijärjestelmä on esimerkiksi Digi- ja väestötietoviraston (DVV) väestötietojärjestelmä, josta saa haettuja muun muassa henkilön perustietoja.

Palveluväylä pohjautuu X-Road-teknologiaan, joka on avoimen lähdekoodin ohjelmisto.  Tietoturvallisuus on rakennettu sisään X-Road-ohjelmistoon. Tämä tarkoittaa esimerkiksi sitä, että liityntäpalvelimien välillä liikkuva tieto salataan DVV:n myöntämillä varmenteilla, jolloin sitä voidaan siirtää turvallisesti julkisen internetin yli. 

Lue lisää X-Roadista (Nordic Institute for Interoperability Solutions, englanniksi)Avautuu uuteen ikkunaan..

Kenelle Palveluväylä on tarkoitettu?

Palvelu on tarkoitettu kaikille, jotka vaihtavat tietoa julkisen hallinnon kanssa. Palveluun voi rekisteröityä suomalaisen y-tunnuksen omaava organisaatio tai organisaatio, jolla ei Suomen lainsäädännön mukaisesti ole rekisteröitymisvelvollisuutta tai jolle ei muutoin anneta suomalaista y-tunnusta.

Organisaation rooli Palveluväylässä voi olla:

• Palveluntarjoaja, jolloin organisaatio tarjoaa palveluitaan käytettäväksi Palveluväylän kautta ja mahdollisesti myös hyödyntää toisten organisaatioiden palveluja.
• Hyödyntäjä, jolloin organisaatio ainoastaan hyödyntää muiden organisaatioiden tarjoamia palveluita Palveluväylän kautta.

Palveluväylän käyttöönotto

Palveluväylän käyttöönotto koostuu hallinnollisesta ja teknisestä käyttöönotosta. Palveluväylään liittyminen tulisi aloittaa suunnittelemalla, mitä palveluja organisaatio haluaa ottaa käyttöön. Palveluväylän kautta saatavat palvelut esitellään LiityntäkatalogissaAvautuu uuteen ikkunaan.. 

Palveluväylään liittyminen ja sen käyttö on maksutonta. Organisaatiot vastaavat itse liityntäpalvelimen ja tietojärjestelmien liittämisen kustannuksista. Organisaatio voi toteuttaa käyttöönoton itse tai ulkoistaa sen kokonaan tai osittain toiselle organisaatiolle.

Jokaisen Palveluväylän kautta tarjottavan palvelun käyttöönotosta täytyy sopia aina erikseen palvelua tarjoavan organisaation kanssa. Palveluiden käyttöönottoprosessit, maksut sekä vaadittavat sopimukset riippuvat palvelua tarjoavasta organisaatiosta. Esimerkiksi, jos organisaatio haluaa ottaa käyttöön VTJ-muutosrajapinnan, ei riitä, että organisaatio on ottanut käyttöön Palveluväylän. Sen lisäksi täytyy sopia VTJ-muutosrajapintapalvelun kanssa VTJ-muutosrajapinnan käytöstä erillisen prosessin mukaisesti.

Liityntäkatalogi

LiityntäkatalogiAvautuu uuteen ikkunaan. on Palveluväylän palveluhakemisto, joka esittelee kaikki Suomi.fi-palveluväylään liittyneet organisaatiot ja organisaatioiden palveluun liittämät alijärjestelmät. Liityntäkatalogista löytyy erikseen myös alijärjestelmät, jotka tarjoavat palveluja muille organisaatioilleAvautuu uuteen ikkunaan.. 

Liityntäkatalogi sisältää palveluita tarjoavien alijärjestelmien

• yleiset kuvaukset, kuten kuvauksen palvelun toiminnasta, ohjeet käyttöönottoon sekä yhteyshenkilöiden tiedot
• tekniset kuvaukset, kuten rajapintakuvaukset ja esimerkkisanomat.

Liityntäkatalogiin rekisteröidytään Palveluväylän käyttöönoton yhteydessä. 

Liityntäkatalogilla on myös testiympäristö, TestiliityntäkatalogiAvautuu uuteen ikkunaan., joka esittelee Palveluväylän testiympäristöön liittyneet organisaatiot ja niiden alijärjestelmät.

Palvelutasot

DVV pyrkii siihen, että palvelu on käytettävissä keskeytyksettä. Hetkellisiä käyttökatkoja voivat aiheuttaa suunnitellut huoltokatkot, ennalta arvaamattomat tekniset häiriöt tai muut Suomi.fi-palveluista riippumattomat häiriöt. Tiedossa olevista Palveluväylän käyttökatkoista tiedotetaan etukäteen Suomi.fi-sivustolla. Liityntäkatalogin käyttökatkoista tiedotetaan Liityntäkatalogin sivulla.

Palveluväylään voidaan liittää uusia asiakasorganisaatioita ja palveluita ilman, että siitä koituu haittaa aiemmin liittyneille asiakasorganisaatioille tai palveluille.

Palvelun käyttäjätuesta ja ylläpidosta vastaa palvelutuottaja (DVV). Palvelun käyttäjätuki on tavoitettavissa arkisin klo 8-16. Lisätietoja löydät palvelun tukisivuilta.

Palveluväylä ja Liityntäkatalogi tarjotaan suomeksi, ruotsiksi ja englanniksi. 

Palveluväylässä tarjottavien palveluiden osalta palvelutasot ovat kyseistä palvelua tarjoavan organisaation vastuulla. Lisätietoja voit kysyä yksittäisen palvelun tarjoajalta.

Käyttöesimerkki

Digi- ja väestötietoviraston väestötietojärjestelmä-alijärjestelmästäAvautuu uuteen ikkunaan. saa haettua nimitietoja Palveluväylän kautta. Jos toinen organisaatio haluaa hyödyntää väestötietojärjestelmän tietoja, organisaation täytyy ensin sopia Digi- ja väestötietoviraston kanssa väestötietojärjestelmän käyttöönotosta sekä huolehtia tarvittavista käyttöluvista ja sopimuksista. Tämän jälkeen organisaatio liittyy Palveluväylään, jotta organisaation tietojärjestelmät ja Digi- ja väestötietojärjestelmän tietojärjestelmät voivat vaihtaa tietoja keskenään tietoturvallisesti.