3. Liity testiympäristöön
Käytyäsi läpi tämän osion olet
- lähettänyt käyttölupahakemuksen Palveluväylän testiympäristöön
- teknisen liittymisprosessin jälkeen kuvaillut organisaatiosi sekä palvelusi Testiliityntäkatalogiin
Testiympäristöön liittyminen koostuu käyttölupahakemuksen lähettämisestä ja teknisestä liittymisprosessista, jonka organisaatiosi voi halutessaan ulkoistaa valitsemalleen teknisten ratkaisujen tarjoajalle. Organisaatiosi tulee liittyä Palveluväylän testiympäristöön ennen kuin voit siirtyä tuotantoympäristöön.
Tässä osiossa ohjeistetaan 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ä.
- Lähetä käyttölupahakemus testiympäristöön.
- Avaa palomuurit aiemmin saamiesi ohjeiden mukaan.
- 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.
- Määrittele liityntäpalvelin. Määrittelyn voi tehdä ohjelmallisesti tai manuaalisesti.
- Lisää liityntäpalvelimelle alijärjestelmä. Alijärjestelmä toimii rajapintana Palveluväylään tiedon hakemista ja jakamista varten.
- Liitä asiakasjärjestelmä liityntäpalvelimelle. Näin tieto siirtyy tietojärjestelmistäsi Palveluväylälle ja toisin päin.
- Jos tarjoat palveluita muille organisaatioille Palveluväylässä, lisää palvelusi liityntäpalvelimelle. Palvelut lisätään jollekin aiemmin lisätylle alijärjestelmälle.
- 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.
- 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. Alta löydät ohjeet käyttöluvan hakemiseksi.
1. Tarkista ensin tekniseltä puolelta että seuraavat asiat ovat kunnossa:
- Liityntäpalvelin on nimetty oikein
- Liityntäpalvelimen alustapalvelimelle on asennettu käyttöjärjestelmä
2. Huolehdi, että sinulla on seuraavat tiedot käyttölupahakemusta varten:
- hallinnollisen ja teknisen vastuuhenkilön yhteystiedot: nimi, sähköpostiosoite (huomaa, että tämän tulisi olla jokin organisaation yleinen ja muuttumaton sähköpostiosoite)
- Palveluväylää käyttävän organisaation nimi ja Y-tunnus
- tiedon Palveluväylän käyttötarkoituksesta (palvelujen tarjoaja/hyödyntäjä)
- liityntäpalvelimen tiedot liityntäpalvelimesta vastaavalta henkilöltä: liityntäpalvelimen tyyppi (oma, jaettu tai ulkoistettu liityntäpalvelin), liityntäpalvelimen FQDN- nimi, julkinen IPv4-osoite
- oikeus hyväksyä Palveluväylän käyttöehdot
3. Rekisteröidy Palveluhallintaan, jos et ole ennen käyttänyt palvelua
- Rekisteröityvänä henkilönä sinulla tulee olla nimenkirjoitusoikeus organisaatiossasi. Lue lisää Palveluhallinnan ohjeista.
4. Lähetä sähköinen käyttölupahakemus Digi- ja väestötietovirastolleAvautuu uuteen ikkunaan.. Tutustu myös ohjeisiin käyttölupahakemuksen täyttämisestä.
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
Kuvaile lopuksi 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. Saat tunnukset Testiliityntäkatalogiin, kun testiympäristön tekninen liittymisprosessi on valmis ja palvelusi löytyy Palveluväylän testiympäristöstä. Lue lisää Liityntäkatalogin ympäristöistä ja tutustu Liityntäkatalogin ohjeisiinAvautuu uuteen ikkunaan..
Kerro organisaation kuvauksessa lyhyesti seuraavat yleistiedot organisaatiostasi:
- Mikä organisaatio on kyseessä
- Mitä organisaatio tekee
Tutustu ohjeeseen organisaation tietojen kuvaamisesta.
Jos organisaatiosi tarjoaa palveluita kerro palvelun kuvauksessa vähintään seuraavat tiedot:
- Mitä tietoja palvelun kautta voi saada käyttöönsä
- Mitä edellytyksiä ja rajoituksia palvelun käytössä on
- Miten palvelun saa käyttöönsä: käyttöönottoprosessi ja käyttöluvat
Palvelun kuvauksessa voit hyödyntää ohjeita palvelun kuvaamiseen sekä valmista kysymyslistaa, jonka sisältämiin kysymyksiin vastaamalla saat luotua kattavan palvelukuvauksen. Katso myös esimerkki Suomi.fi-valtuudet-palvelun kuvauksestaAvautuu uuteen ikkunaan..
Kun kuvaat palvelusi Liityntäkatalogiin huolellisesti, on muiden helpompi löytää palvelusi ja hyödyntää niitä. Älä kirjoita kuvausta liian teknisellä kielellä, vaan pyri yleistajuiseen ilmaisuun. Kirjoita kuvaus ytimekkäästi, mutta muista kertoa kaikki oleellinen. Huomaa, että hyvin kirjoitetut kuvaukset on mahdollista kopioida myöhemmin tuotantoympäristöön.
Huomioitavaa varmenneprosessista
Palveluväylän varmenteet haetaan nykyisin Digi‑ ja väestötietoviraston (DVV) verkkoasioinnissa. Organisaatio vastaa varmenneprosessista ja siitä, että verkkoasioinnissa on käytössä asiakastili ja tilille on kutsuttu varmenneprosessin hoitamiseksi tarvittavat käyttäjät.
Varmennehakemuksen voi tehdä tekninen tai hallinnollinen yhteyshenkilö. Hallinnollisen henkilön vastuulla on huolehtia, että teknisillä yhteyshenkilöillä on tarvittavat oikeudet varmenneprosessin hoitamiseen.
Lue tarkemmat ohjeet: Varmenteiden hakeminen Palveluväylää varten (1.5.2026 alkaen) - Suomi.fi-palveluväylä - Suomi.fi kehittäjille