3. Liity testiympäristöön

Kuva: Liity testiympäristöön -vaihe

Näytä kuva suurempana

Testiympäristöön liittyminen koostuu käyttölupahakemuksen lähettämisestä ja teknisestä liittymisprosessista, jonka organisaatiosi voi halutessaan ulkoistaa valitsemalleen teknisten ratkaisujen tarjoajalle. Lisäksi organisaation ja palveluiden kuvaukset lisätään Liityntäkatalogiin.

Organisaatiosi tulee liittyä Palveluväylän testiympäristöön ennen kuin voit siirtyä tuotantoympäristöön.

Tässä osiossa kuvataan lyhyesti testiympäristöön liittymisen vaiheet 1 ja 9, joista hallinnollinen henkilö on vastuussa.

• Vaiheet 2-8 ovat teknisen vastuuhenkilön vastuulla ja kuvattu tarkemmin teknisen käyttöönottoprosessin yhteydessä.

1. Lähetä käyttölupahakemus testiympäristöön.
2. Avaa palomuurit aiemmin saamiesi ohjeiden mukaan.
3. Asenna liityntäpalvelinohjelmisto. Liityntäpalvelimen asennuksen ohjeistus riippuu palvelimesi käyttöjärjestelmästä. Tämän jälkeen alustapalvelimesta tulee liityntäpalvelin, jolla yhdistät tietojärjestelmäsi Palveluväylään.
4. Määrittele liityntäpalvelin. Määrittelyn voi tehdä ohjelmallisesti tai manuaalisesti.
5. Lisää liityntäpalvelimelle alijärjestelmä. Alijärjestelmä toimii rajapintana Palveluväylään tiedon hakemista ja jakamista varten.
6. Liitä asiakasjärjestelmä liityntäpalvelimelle. Näin tieto siirtyy tietojärjestelmistäsi Palveluväylälle ja toisin päin.
7. Jos tarjoat palveluita muille organisaatioille Palveluväylässä, lisää palvelusi liityntäpalvelimelle. Palvelut lisätään jollekin aiemmin lisätylle alijärjestelmälle.
8. Jos tarjoat palveluita muille organisaatioille Palveluväylässä, ota sovitinpalvelu tarvittaessa käyttöön. Tarvitset sovitinpalvelun, jos tarjoat Palveluväylän kautta SOAP-palveluita, joita ei ole räätälöity Palveluväylän vaatimusten mukaisiksi.
9. Kuvaile organisaatiosi sekä mahdolliset palvelusi Testiliityntäkatalogiin.

1. Lähetä käyttölupahakemus testiympäristöön 

Suomi.fi-palveluväylän käyttö edellyttää erillisen käyttöluvan hakemista. Käyttölupaa tulee hakea sekä testi- että tuotantoympäristöön erikseen.

Varmista ennen hakemuksen lähettämistä, että tarvittavat tekniset perustiedot ovat käytettävissä.

• Tarkemmat ohjeet tarvittavista tiedoista sekä hakemuksen täyttämisestä löydät artikkelista Käyttölupahakemuksen täyttäminen Palveluväylään - Suomi.fi-palveluväylä - Suomi.fi kehittäjille.

Kun käyttölupahakemuksesi on hyväksytty, organisaatiosi tekninen yhteyshenkilö saa sähköpostitse asennusohjeet testiympäristöön liittymistä varten.

9. Kuvaile organisaatiosi sekä mahdolliset palvelusi Testiliityntäkatalogiin

Saat tunnukset Testiliityntäkatalogiin, kun käyttölupahakemus on hyväksytty, testiympäristön tekninen liittymisprosessi on valmis ja palvelusi löytyy Palveluväylän testiympäristöstä.

Kuvaile organisaatiosi sekä palveluidesi tiedot TestiliityntäkatalogiinAvautuu uuteen ikkunaan. vähintään suomeksi ja ruotsiksi. Varmista, että alijärjestelmäsi näkyy oikein Testiliityntäkatalogissa ja tutustu tarjolla oleviin palveluihin. Kun kuvaat palvelusi Liityntäkatalogiin huolellisesti, on muiden helpompi löytää palvelusi ja hyödyntää niitä.

Tutustu seuraaviin ohjeisiin:

• Organisaation tietojen kuvaaminen Liityntäkatalogiin - Suomi.fi-palveluväylä - Suomi.fi kehittäjille
• Alijärjestelmän ja palveluiden kuvaaminen Liityntäkatalogiin - Suomi.fi-palveluväylä - Suomi.fi kehittäjille
• Ohjeet ja tuki - LiityntäkatalogiAvautuu uuteen ikkunaan.

Katso myös esimerkki Suomi.fi-valtuudet-palvelun kuvauksestaAvautuu uuteen ikkunaan..

Muistutus varmenneprosessista

Palveluväylän käyttö edellyttää varmenteita. Tarkemmat ohjeet löytyvät artikkelista Varmenteiden hakeminen Palveluväylää varten (1.5.2026 alkaen) - Suomi.fi-palveluväylä - Suomi.fi kehittäjille

Siirry seuraavaan osioon