Saat parhaat ohjeet tilanteeseesi, kun vastaat ensin kysymyksiin oppaan aloitussivulla.
Muistilista
Seuraa näitä vaiheita, kun organisaatiosi haluaa ottaa käyttöön Suomi.fi-palveluväylässä tarjottavan rajapintapalvelun.
Selvitä organisaatiosi lähtötilanne
Selvitä ensin, hyödyntääkö organisaatiosi Palveluväylää jo jossakin toisessa palvelussa. Jos olette liittyneet Palveluväylään jo aiemmin, ota selvää
- onko organisaatiosi liittynyt itse vai jonkin teknisen toimittajan välityksellä
- voidaanko aiempaa liityntää Palveluväylään hyödyntää uusiin toteutuksiin.
Suunnittele ja resursoi käyttöönottoprojekti
- Tutustu VTJ-muutosrajapintaan ja eri tietotuotteisiin.
- Tutustu Suomi.fi-palveluväylän mahdollisuuksiin ja velvollisuuksiin.
- Kartoita tarvittava osaaminen ja mahdollinen tekninen toimittaja.
- Aikatauluta käyttöönottoprosessi ja sovi yhteyshenkilöistä.
Suunnittele ja resursoi käyttöönottoprojekti
- Tutustu Suomi.fi-palveluväylän mahdollisuuksiin ja velvollisuuksiin.
- Suunnittele, miten organisaatiosi haluaa tulevaisuudessa käyttää Palveluväylää.
- Tutustu tarjolla oleviin palveluihin LiityntäkatalogissaAvautuu uuteen ikkunaan..
- Kartoita tarvittava osaaminen ja mahdollinen tekninen toimittaja.
- Aikatauluta käyttöönottoprosessi ja sovi yhteyshenkilöistä.
Jos aiotte tarjota Palveluväylässä palveluita muille, suunnittele omien palveluidenne käyttäjätuki ja luvitus. Varaudu myös kuvailemaan organisaatiosi ja palvelusi Liityntäkatalogiin.
Hae VTJ-muutosrajapinnan tietolupaa
- Tutustu ensin hakemusohjeisiin VTJ-muutosrajapinnan verkkosivuilla.Avautuu uuteen ikkunaan.
- Hae sitten tietolupaa Digi- ja väestötietoviraston verkkoasioinnissaAvautuu uuteen ikkunaan.. Määrittele hakemuksessa, mitä väestötietoja tarvitsette ja minkä lainkohdan perusteella.
- Jos organisaatiosi on kunta tai hyvinvointialue, liitä hakemus organisaatiosi kattolupaan.
Huomaa, että tietoluvan myöntäminen on käyttöönottavan organisaation ja DVV:n välinen juridinen prosessi. Tekninen toimittaja ei voi täyttää hakemusta organisaation puolesta. Hakemuksen täyttämiseen saat apua osoitteesta muutostietopalvelu@dvv.fi.
Valmistele Palveluväylän tekninen käyttöönotto
- Perehdy Palveluväylän liityntäpalvelinratkaisuihin ja valitse sopivin.
- Jos toteutatte oman liityntäpalvelimen, asenna ja määrittele alustapalvelin.
Hae käyttölupaa Palveluväylän testiympäristöön
Lähetä käyttölupahakemus testiympäristöön Suomi.fi-palveluhallinnassa.Avautuu uuteen ikkunaan. Hakemuksen tekee hallinnollinen yhteyshenkilö.
Jos ulkoinen tekninen toimittaja on rekisteröitynyt Suomi.fi-palveluhallinnassa välitoimijaksi, se voi myös hakea Palveluväylän käyttölupaa organisaatiosi puolesta. Käyttölupahakemuksen kuitenkin allekirjoittaa aina varsinaisen asiakasorganisaation edustaja.
Liity testiympäristöön ja testaa yhteydet
Kun käyttölupahakemus on hyväksytty, voitte liittyä testiympäristöön:
- Avaa palomuurit.
- Asenna liityntäpalvelinohjelmisto.
- Määrittele liityntäpalvelin.
- Lisää alijärjestelmä liityntäpalvelimelle.
- Liitä asiakasjärjestelmä liityntäpalvelimelle.
- Lisää mahdolliset palvelusi liityntäpalvelimelle.
- Ota sovitinpalvelu tarvittaessa käyttöösi.
Testaa sitten yhteys Palveluväylään:
- Testaa viestiketjun toimivuus.
- Testaa viestinvälitystä metapalveluiden avulla.
- Korjaa testeissä huomatut virheet.
Lisää Palveluväylän testiympäristön liityntäpalvelimelle uusi testialijärjestelmä
Kun organisaatiollasi on jo valmiiksi olemassa oleva liityntäpalvelintoteutus, tee Palveluväylän testiympäristössä seuraavat asiat:
- Lisää testiliityntäpalvelimelle uusi alijärjestelmä.
- Lisää asiakasjärjestelmäsi testiliityntäpalvelimelle.
- Ota sovitinpalvelu tarvittaessa käyttöösi.
Testaa sitten yhteys Palveluväylään:
- Testaa viestiketjun toimivuus.
- Testaa viestinvälitystä metapalveluiden avulla.
- Korjaa testeissä huomatut virheet.
Testaa VTJ-muutosrajapintaa testiympäristössä
- Hae testialijärjestelmälle käyttölupa VTJ-muutosrajapintaan (PDF)Avautuu uuteen ikkunaan.. Lähetä hakemus osoitteeseen muutostietopalvelu@dvv.fi.
- Testaa VTJ-muutosrajapinnan hiekkalaatikkoa Palveluväylän testiympäristössä.
Jos aiot tarjota palveluita muille, kuvaile organisaatiosi ja palvelusi Testiliityntäkatalogiin
Kuvaile organisaatiosi sekä tarjoamiesi palveluiden tiedot TestiliityntäkatalogiinAvautuu uuteen ikkunaan. suomeksi, ruotsiksi ja englanniksi. Varmista, että alijärjestelmäsi näkyy oikein Testiliityntäkatalogissa.
Hae käyttölupaa Palveluväylän tuotantoympäristöön
Lähetä käyttölupahakemus tuotantoympäristöön Suomi.fi-palveluhallinnassa.Avautuu uuteen ikkunaan. Hakemuksen tekee hallinnollinen yhteyshenkilö.
Myös tekninen toimittaja voi täyttää hakemuksen, jos se on rekisteröitynyt Palveluhallinnassa välitoimijaksi. Käyttölupahakemuksen kuitenkin allekirjoittaa aina varsinaisen asiakasorganisaation edustaja.
Lisää Palveluväylän tuotantoympäristön liityntäpalvelimelle uusi alijärjestelmä
Kun organisaatiollasi on jo valmiiksi olemassa oleva liityntäpalvelintoteutus, tee Palveluväylän tuotantoympäristössä seuraavat asiat:
- Lisää liityntäpalvelimelle uusi alijärjestelmä.
- Lisää asiakasjärjestelmäsi liityntäpalvelimelle.
- Ota sovitinpalvelu tarvittaessa käyttöösi.
Siirry tuotantoympäristöön
Kun käyttölupahakemus on hyväksytty, voitte liittyä tuotantoympäristöön. Tekniset vaiheet ovat samat kuin testiympäristöön liittyessä.
- Avaa palomuurit.
- Asenna liityntäpalvelinohjelmisto.
- Määrittele liityntäpalvelin.
- Lisää alijärjestelmä.
- Liitä asiakasjärjestelmä liityntäpalvelimelle.
- Lisää mahdolliset palvelusi liityntäpalvelimelle.
- Ota sovitinpalvelu tarvittaessa käyttöösi.
Sovi palveluiden käyttöönotosta niitä tarjoavien organisaatioiden kanssa
Palveluväylässä tarjottujen palveluiden käyttöönotosta täytyy sopia erikseen palvelua tarjoavan organisaation kanssa. Käyttöönottoprosessit, maksut sekä vaadittavat sopimukset riippuvat palvelua tarjoavasta organisaatiosta.
Tutustu muiden tarjoamiin palveluihin ja niiden käyttöönottoon LiityntäkatalogissaAvautuu uuteen ikkunaan..
Jos aiot tarjota palveluita muille, kuvaile organisaatiosi ja palvelusi Liityntäkatalogiin
Kuvaile organisaatiosi sekä tarjoamiesi palveluiden tiedot LiityntäkatalogiinAvautuu uuteen ikkunaan. suomeksi, ruotsiksi ja englanniksi. Varmista, että alijärjestelmäsi näkyy oikein Liityntäkatalogissa.
Hae alijärjestelmälle käyttölupa VTJ-muutosrajapintaan
Lähetä lopuksi alijärjestelmän käyttölupahakemus VTJ-muutosrajapintaanAvautuu uuteen ikkunaan. osoitteeseen muutostietopalvelu@dvv.fi.
Hakemuksen tekee hallinnollinen yhteyshenkilö. Kysy tarvittaessa apua tekniseltä yhteyshenkilöltä.
Varmista, että organisaatiollasi on VTJ-muutosrajapinnan tietolupa
Saatte tunnukset ja ohjeet rajapinnan käyttöön, kun DVV on myöntänyt tietoluvan ja tietotuotteet on määritelty. Varmista, että olet vastannut mahdollisiin täydennyspyyntöihin.
Suunnittele Palveluväylän hallinnollinen ylläpito
Huolehdi käytön aikana, että
- pidät organisaatiosi yhteystiedot ajan tasalla
- huolehdit ylläpidon resursoinnista
- tuet palveluidesi asiakkaita
- ylläpidät kuvauksia Liityntäkatalogissa.
Suunnittele Palveluväylän tekninen ylläpito
Huolehdi, että
- uusit varmenteet vuoden välein
- valvot liityntäpalvelimiasi
- huolehdit levytilan riittävyydestä
- asennat versiopäivitykset
- kahdennat liityntäpalvelimesi tarvittaessa
- huolehdit tietoturvasta.
Mistä saan tukea käyttöönoton eri vaiheissa?
VTJ-muutosrajapinta
muutostietopalvelu@dvv.fi
- VTJ-muutosrajapinnan tietolupa ja lainsäädäntö
- Alijärjestelmien käyttöluvat VTJ-muutosrajapintaan
- VTJ-muutosrajapinnan toiminta ja käyttö
Palveluväylän yleisneuvonta
palveluvayla-kayttoonotot@dvv.fi
- Yleinen neuvonta Palveluväylään liittymisestä
- Palveluväylän käyttöönoton esivalmistelut
- Palveluväylän lainsäädännölliset ja hallinnolliset asiat
Palveluväylän tekninen käyttöönottojen tuki
palveluvayla@palveluvayla.fi
- Teknisten ratkaisujen suunnittelu
- Palveluväylään liittymisen tekniset vaiheet
- Vikatilanteet
Mistä saan tukea käyttöönoton eri vaiheissa?
Palveluväylän yleisneuvonta
palveluvayla-kayttoonotot@dvv.fi
- Yleinen neuvonta Palveluväylään liittymisestä
- Palveluväylän käyttöönoton esivalmistelut
- Palveluväylän lainsäädännölliset ja hallinnolliset asiat
Palveluväylän tekninen käyttöönottojen tuki
palveluvayla@palveluvayla.fi
- Teknisten ratkaisujen suunnittelu
- Palveluväylään liittymisen tekniset vaiheet
- Vikatilanteet