Palveluväylän ja Liityntäkatalogin ympäristöt
Suomi.fi-palveluväylässä on kolme eri ympäristöä: kehitysympäristö, testiympäristö ja tuotantoympäristö. Liityntäkatalogi esittelee tuotantoympäristöön liittyneet organisaatiot ja niiden tarjoamat palvelut ja Testiliityntäkatalogi testiympäristöön liittyneet organisaatiot ja niiden tarjoamat palvelut.
Palveluväylän ympäristöt
- Kehitysympäristö (FI-DEV): Voit kokeilla Palveluväylän toimintaa ilman velvoitteita liittyä testi- tai tuotantoympäristöön. Kehitysympäristöön voivat liittyä myös yksityishenkilöt.
- Testiympäristö (FI-TEST): Sinun on aina liityttävä testiympäristöön ennen tuotantoympäristöön liittymistä. Testiympäristö vastaa toiminnaltaan tuotantoympäristöä, joten voit testiympäristössä kokeilla Palveluväylän toimintaa ja siihen liittymistä.
- Tuotantoympäristö (FI): Tuotantoympäristö on Palveluväylän virallinen ympäristö. Sinun täytyy liittyä testiympäristöön ennen tuotantoympäristöön siirtymistä.
Liityntäkatalogin ympäristöt

Kuten Palveluväylän testiympäristö, on Testiliityntäkatalogikin tarkoitettu testaamiseen: voit esimerkiksi testata Liityntäkatalogin toimintaa ja lisätä palveluillesi kuvauksia.
- TestiliityntäkatalogiAvautuu uuteen ikkunaan.: Testiliityntäkatalogista löydät kaikki Palveluväylän testiympäristöön (FI-TEST) liittyneet organisaatiot ja voit tutustua tarjolla oleviin palveluihin. Testiliityntäkatalogi on Palveluväylän testiympäristön tavoin tarkoitettu testikäyttöön: voit esimerkiksi kokeilla Liityntäkatalogin toimintaa ja kuvausten lisäämistä. Saat tunnukset Testiliityntäkatalogiin, kun liityt Palveluväylän testiympäristöön.
- LiityntäkatalogiAvautuu uuteen ikkunaan.: Liityntäkatalogista löydät kaikki Palveluväylän tuotantoympäristöön (FI) liittyneet organisaatiot. Saat tunnukset Liityntäkatalogiin, kun liityt Palveluväylän tuotantoympäristöön.
Palveluväylän kehitysympäristölle (FI-DEV) ei ole olemassa Liityntäkatalogia. Sinne liittyneitä organisaatioita ja palveluita ei siis kuvata missään.
Palveluväylän ympäristöjen yksityiskohdat ja vertailu
Kehitysympäristö (FI-DEV)
Kehitysympäristö on vapaamuotoinen pilotointiympäristö, johon liittyminen ei vielä edellytä varsinaiseen testi- tai tuotantoympäristöön liittymistä. Kehitysympäristössä voi esimerkiksi kokeilla Palveluväylän ominaisuuksia, testata uusia versioita tai validoida oman kehitystyönsä ominaisuuksia.
Kehitysympäristön keskeisin ero testi- ja tuotantoympäristöön on se, että kehitysympäristöön voivat liittyä myös yksityishenkilöt. Testi- ja tuotantoympäristöön taas voivat liittyä ainoastaan suomalaiset ja ulkomaiset tunnistetut organisaatiot.
Kehitysympäristössä käytetään palvelua ylläpitävän operaattorin omia varmenteita, joiden hankkiminen onnistuu sähköpostitse ilman hakemus- ja paperiprosessia. Myös kehitysympäristön aikaleimapalvelua ylläpitää sama operaattori.
Lue ohje kehitysympäristöön liittymisestä.
Testiympäristö (FI-TEST)
Testiympäristö vastaa toiminnaltaan tuotantoympäristöä. Testiympäristöön liittyminen on ensimmäinen askel kohti tuotantoympäristöä. Testiympäristöön liittyminen tarkoittaa lähtökohtaisesti sitä, että organisaatio aikoo liittyä myös tuotantoympäristöön. Jos organisaatio ei aio liittyä tuotantoympäristöön, oikea paikka organisaatiolle on kehitysympäristö.
Testiympäristöön on aina liityttävä ennen tuotantoympäristöön siirtymistä. Suoraan tuotantoympäristöön liittyminen ei ole mahdollista. Organisaatio voi kuitenkin liittyä testi- ja tuotantoympäristöön samaan aikaan.
Testiympäristöön voivat liittyä suomalaiset ja ulkomaiset tunnistetut organisaatiot. Yksityishenkilöt eivät sen sijaan voi liittyä testiympäristöön.
Testiympäristössä käytetään Digi- ja väestötietoviraston erikseen Palveluväylää varten räätälöimiä varmenteita, joissa Digi- ja väestötietovirasto toimii varmentajana. Varmenteet haetaan sähköisellä käyttölupahakemuksella liittymisen yhteydessä. Testiympäristössä käytetään Digi- ja väestötietoviraston aikaleimapalvelua, joka käyttää Suomen virallista tarkkaa aikaa.
Tuotantoympäristö (FI)
Tuotantoympäristö on Palveluväylän virallinen ympäristö. Tuotantoympäristöön liittyminen edellyttää aina liittymistä ensin testiympäristöön. Suoraan tuotantoympäristöön liittyminen ei ole mahdollista. Organisaatio voi kuitenkin liittyä testi- ja tuotantoympäristöön samaan aikaan.
Tuotantoympäristöön voivat liittyä suomalaiset ja ulkomaiset tunnistetut organisaatiot.
Tuotantoympäristössä käytetään Digi- ja väestötietoviraston erikseen Palveluväylää varten räätälöimiä varmenteita, joissa Digi- ja väestötietovirasto toimii varmentajana. Varmenteet haetaan sähköisellä käyttölupahakemuksella liittymisen yhteydessä. Tuotantoympäristössä käytetään Digi- ja väestötietoviraston aikaleimapalvelua, joka käyttää Suomen virallista tarkkaa aikaa.
Voit myös testata Palveluväylän X-Road -ohjelmiston toimintaa tutustumisympäristössä X-Road -PlaygroundissaAvautuu uuteen ikkunaan. (englanniksi). X-Road -Playgroundin käyttäminen ei vaadi tunnuksia tai hakemuksia.
Yhteenvetotaulukko
FI-DEV | FI-TEST | FI | |
|---|---|---|---|
Liittyminen yksityishenkilöille | X | - | - |
Liittyminen suomalaisille ja ulkomaisille tunnistetuille organisaatioille | X | X | X |
Operaattorin varmenne käytössä | X | - | - |
Digi- ja väestötietoviraston varmenne käytössä | - | X | X |
Operaattorin aikaleimapalvelu | X | - | - |
Digi- ja väestötietoviraston aikaleimapalvelu | - | X | X |
Pilotointiin ja asioiden kokeiluun | X | - | - |
Toiminnan validointi ennen tuotantoon siirtymistä | - | X | - |
Virallinen tuotantoympäristö | - | - | X |
Liityntäkatalogi | - | X | X |
Taulukko 1. Yhteenveto Palveluväylän ympäristöistä.