1. Tutustu ja suunnittele

Kuva: Tutustu ja suunnittele -vaihe

Näytä kuva suurempana

Tämän osion avulla pääset alkuun Suomi.fi-palveluväylän käyttöönotossa. Voit myös halutessasi ulkoistaa Palveluväylän käyttöönottoprosessin. Lue lisää käyttöönottoprosessin ulkoistamisesta.

Käyttöönoton kesto 

Palveluväylän käyttöönottoprosessissa kuluu yleensä noin 1–3 kuukautta, mutta prosessin kesto voi olla myös lyhyempi. Varsinainen asennusprosessi itsessään ei ole kovin pitkä, erityisesti jos prosessi on jo tuttu. Jos organisaatio liittyy Palveluväylään vain hyödyntäjänä tai jos organisaatiolla on jo olemassa Palveluväylään liitetty liityntäpalvelin, on käyttöönottoprosessi nopeampi. Palomuuriavauksiin ja varmenteiden myöntämiseen on hyvä varata muutamia viikkoja. 

Käyttöönoton suunnittelu 

Suunnittele käyttöönotto huolellisesti, jotta se onnistuu mahdollisimman sujuvasti. Muista, että organisaatiosi tarpeet ja resurssit vaikuttavat prosessiin, ja ne on hyvä huomioida jo suunnitteluvaiheessa. 

Käyttöönoton suunnittelu jakautuu hallinnolliseen sekä tekniseen suunnitteluun. Huomioi, että tästä huolimatta suunnittelu täytyy tehdä tiiviissä yhteistyössä kaikkien käyttöönottoprosessiin osallistuvien henkilöiden ja tahojen kanssa. 

Tutustu käyttöönoton teknisen suunnittelun vaiheisiin. 

Tässä osiossa ohjeistetaan seuraavat käyttöönoton suunnittelun vaiheet:

1. Tutustu mahdollisuuksiin ja velvollisuuksiin
2. Mieti Palveluväylän käyttötarvetta sekä organisaatiosi roolia Palveluväylässä: Palveluiden hyödyntäjä ja/tai Palveluiden tarjoaja
3. Sovi yhteyshenkilöistä
4. Resursoi ja aikatauluta
5. Suunnittele palvelullesi tarvittavat luvat ja sopimukset

1. Tutustu mahdollisuuksiin ja velvollisuuksiin 

Aloita käyttöönottoprosessi tutustumalla Palveluväylään ja sen tarjoamiin mahdollisuuksiin sekä velvollisuuksiin, jotka liittyvät Palveluväylän käyttöön. Alla on listattu muutamia hyödyllisiä sivuja, joihin kannattaa tutustua ennen käyttöönoton aloittamista. 

Palveluväylän mahdollisuudet

• Tutustu Palveluväylän palvelukuvaukseen sekä Palveluväylän esittelyvideoon (Youtube)Avautuu uuteen ikkunaan.
• Voit lukea asiakastarinoistamme, kuinka muut organisaatiot ovat hyötyneet Palveluväylän käyttöönottamisesta
• Tutustu Palveluväylän kautta tarjottaviin palveluihin LiityntäkatalogissaAvautuu uuteen ikkunaan.
• Tutustu Palveluväylän ja Liityntäkatalogin ympäristöihin
• Tutustu Palveluväylän sanastoon, tukimateriaaleihin ja usein kysyttyihin kysymyksiin

Palveluväylän velvollisuudet

• Palveluväylän käyttöönotto on liityvän organisaation tai mahdollisen välitoimijan vastuulla. Tutustu siis huolellisesti Palveluväylän tekniseen yleiskuvaukseen sekä käyttöönoton teknisiin ja hallinnollisiin ohjeisiin
• Palveluväylän käyttö edellyttää aina käyttöluvan hakemista. Myös Palveluväylän kautta tarjolla olevien palveluiden käyttöönotto voi edellyttää erilaisten lupien hakemista. Lisätietoja palvelukohtaisista lupakäytännöistä antaa kutakin palvelua tarjoava organisaatio.
• Palveluväylän käyttö edellyttää omien tietojen, liityntäpalvelimen ja mahdollisten palveluiden ylläpitoa. Myös ylläpito on Palveluväylää käyttävän organisaation tai välitoimijan vastuulla.
• Lisää Palveluväylän käyttöön liittyvistä velvoitteista voi lukea Palveluväylän käyttöehdoistaPalveluväylän käyttöehdot (PDF, 383,71 kt)Avautuu uuteen ikkunaan..

2. Mieti Palveluväylän käyttötarvetta sekä organisaatiosi roolia Palveluväylässä 

Palveluväylän kautta voit saada käyttöösi muiden organisaatioiden palveluita, sekä tarjota omia palveluitasi. Ennen kuin organisaatiosi liittyy Palveluväylään, mieti, mihin organisaatiosi aikoo käyttää Palveluväylää. Aikooko organisaatiosi: 

• Tarjota palveluita muiden hyödynnettäväksi (provider)? 
• Hyödyntää muiden tarjoamia palveluita (consumer)? 
• Vai molempia? 

Valinta ei ole sitova, mutta tätä kysytään käyttölupahakemuksessa, joten jonkinlainen käsitys on hyvä olla. Organisaatiosi ei tarvitse ilmoittaa erikseen, jos rooli muuttuu myöhemmin.

Palveluiden hyödyntäjä

Palveluiden käyttöönotto perustuu organisaatioiden välisiin erillisiin sopimuksiin ja saattaa vaatia esimerkiksi erilaisten lupien hakemista. Jos aiot hyödyntää muiden organisaatioiden Palveluväylän kautta tarjoamia palveluita:

• Tutustu palveluihin LiityntäkatalogissaAvautuu uuteen ikkunaan. ja kartoita organisaatiotasi kiinnostavat palvelut
• Ota yhteyttä palvelun ylläpitäjään ja sovi käyttöönotosta
• Huomaathan, että yksittäisen palvelun käyttölupaa ei voi hakea Liityntäkatalogissa ennen kuin organisaatiollasi on toimiva alijärjestelmä
• Lue lisää sivulta Ota Suomi.fi-palveluväylän kautta tarjottava palvelu käyttöön.

Palveluiden tarjoaja

Palveluväylässä tarjottavien palveluiden tulee noudattaa Palveluväylässä käytettävää tiedonsiirtoprotokollaa. Palveluntarjoajan tulee myös tarjota tarvittavat tiedot palvelustaan ja sen käyttöönotosta. Jos aiot tarjota palveluitasi Palveluväylässä:

• Suunnittele palveluidesi tekninen lähtökohta yhdessä teknisestä käyttöönotosta vastaavan kanssa: SOAP vai REST? Lue lisää palveluiden teknisestä toteutuksesta teknisen käyttöönoton ohjeista.
• Suunnittele palveluidesi käyttöönottoprosessit, lupaprosessit ja käyttäjätuki. Lisätietoja löydät myöhemmin tästä osiosta.
• Suunnittele myös Liityntäkatalogiin lisättävät palvelukuvaukset. Lue ohjeet palvelukuvauksen kirjoittamiseen.

3. Sovi yhteyshenkilöistä

Sovi käyttöönoton yhteyshenkilöistä oman organisaation sisällä yhdessä käyttöönoton teknisestä puolesta vastaavan kanssa jo ennen Suomi.fi-palveluväylän varsinaista käyttöönottoa. Hallinnollinen ja tekninen yhteyshenkilö voivat olla sama henkilö. Nimeä organisaatiostasi: 

• Hallinnollinen yhteyshenkilö 
• Hallinnollinen varayhteyshenkilö 
• Tekninen yhteyshenkilö 
• Tekninen varayhteyshenkilö. 

Hallinnolliset yhteyshenkilöt voivat olla esimerkiksi projekti-, hanke- tai tietohallintopäälliköitä. Hallinnollisella yhteyshenkilöllä olisi hyvä olla nimenkirjoitusoikeus organisaatiossa. Hallinnollinen yhteyshenkilö vastaa yleensä esimerkiksi käyttöönottoprosessin yleisestä koordinoinnista, käyttölupahakemuksista ja resursoinnista. 

Tekniset yhteyshenkilöt voivat olla esimerkiksi sellaisia henkilöitä, jotka ovat vastuussa organisaatiosi tietojärjestelmien ylläpidosta. Tekninen yhteyshenkilö vastaa esimerkiksi liityntäpalvelimen asennus-, konfigurointi- ja ylläpitotehtävistä. 

Ilmoitettujen yhteyshenkilöiden rooli

Huomioi, että tarvitset yhteyshenkilöiden ja varayhteyshenkilöiden nimet ja yhteystiedot Palveluväylän käyttölupahakemusta varten.

Järjestelmän muutospyynnöt (esim. alijärjestelmien lisääminen, palomuurien porttiavaukset) on tehtävä Palveluväylän käyttölupahakemuksessa ilmoitettujen yhteyshenkilöiden välityksellä. Muutospyyntöjen tekemisen voi siirtää kolmannelle osapuolelle ja vastaavan yhteyshenkilön tulee ilmoittaa tästä Palveluväylän ylläpidolle. 

4.Resursoi ja aikatauluta 

Sovi käyttöönoton aikaisesta budjetista ja laadi tarvittavat hankintasopimukset esimerkiksi palvelimien ja henkilöresurssien osalta. Suunnittele Palveluväylään liittymisen aikataulu sekä testi- että tuotantoympäristön osalta.

Huomioi resursoinnissa seuraavat asiat: 

• Palveluväylään liittyminen ja käyttöön tarvittavat varmenteet ovat maksuttomia. 
• Organisaatiosi vastaa itse esimerkiksi liityntäpalvelimen pystyttämisestä syntyvistä kustannuksista tai sen ostamisesta ulkopuoliselta palvelutarjoajalta. 
• Liityntäpalvelimen ylläpito vaatii myös resursseja. Lue lisää ylläpidosta.

Käyttöönoton kustannuksia voi arvioida käyttämällä Nordic Institute for Interoperability Solutionsin laskuria (Excel-tiedosto, englanniksi)Avautuu uuteen ikkunaan.. Laskuri on kehitetty arvioimaan X-Road -ohjelmiston yleisiä kustannuksia, joten kaikkia laskurin kohtia ei voi soveltaa suoraan Palveluväylään. Esimerkiksi varmenteet ovat Palveluväylässä maksuttomia. Laskurista saa kuitenkin suuntaa kustannusten arvioimiseen. Huomioi myös, että Palveluväylän kustannukset kattavat vain pienen osan kaikista järjestelmien yhdistämisen kustannuksista. 

Huomioi aikataulutuksessa seuraavat asiat:

• Varmenteiden vanheneminen johtaa palveluiden toiminnan keskeytymiseen. Varmenteet vanhenevat vuoden välein, joten niiden uusiminen tulee tehdä hyvissä ajoin ennen niiden vanhenemista. Lue lisää varmenteiden uusimisesta.
• Käyttöönotossa kuluu yleensä noin 1–3 kuukautta.
• Ota huomioon, että organisaatiosi rooli Palveluväylässä vaikuttaa aikatauluun; palvelun hyödyntäjänä käyttöönottoprosessi on hieman lyhyempi
• Huomioi myös, että ison tietojärjestelmän tai palvelun liittäminen Palveluväylään vaatii suunnitteluineen, sovitustöineen ja testauksineen usein enemmän aikaa. 

5.Suunnittele palvelullesi tarvittavat luvat ja sopimukset

Jos tarjoat palveluita Palveluväylän kautta, määrittele, mitä lupia palveluidesi käyttöönotto vaatii sekä suunnittele palvelusi tukimalli. Palvelua tarjoavan organisaation on itse määriteltävä tarjoamiensa palveluiden mahdolliset luvitukset ja sopimukset. Seuraavat asiat kannattaa kuitenkin ottaa huomioon lupien ja sopimusten suunnittelussa:

Lupaprosessi palveluiden käyttöönottoa varten:

• Mitä lupia palvelun käyttöönotto varten tulee hakea?
• Missä lupaa voi hakea?
• Miten luvat käsitellään? Kauanko käsittelyssä kestää?

Palvelun käyttäjätuki ja palvelutasosopimus (SLA):

Suunnittele palveluille tukimalli, josta käy ilmi vähintään seuraavat asiat:

• Miten palvelu on saatavilla?
• Kuka on vastuussa järjestelmässä ilmaantuvien ongelmien ratkaisemisesta?
• Miten käyttäjätuki järjestetään? Lisää käyttäjätuen yhteystiedot Liityntäkatalogissa olevaan palvelukuvaukseen.

 Määrittele myös

• kuinka nopeasti ongelmatilanteisiin reagoidaan,
• kuinka nopeasti ongelmatilanteet ratkaistaan ja
• mitkä ovat vaatimustasojen alittumisesta aiheutuvat seuraamukset tai korvaukset.

Siirry seuraavaan osioon