5. Siirry tuotantoympäristöön

Kuva: Siirry tuotantoympäristöön -vaihe

Näytä kuva suurempana

Tuotantoympäristöön liitytään samalla tavalla kuin testiympäristöön. Tuotantoympäristöön siirtyminen koostuu käyttölupahakemuksen lähettämisestä ja teknisestä liittymisprosessista, jonka organisaatiosi voi halutessaan ulkoistaa valitsemalleen teknisten ratkaisujen tarjoajalle.  

Tuotantoympäristöön voi siirtyä, kun: 

1. Organisaatio on liittynyt onnistuneesti Palveluväylän testiympäristöön ja 
2. tekninen puoli on testannut, että palvelut toimivat testiympäristössä ongelmitta sekä
3. olet lähettänyt käyttölupahakemuksen tuotantoympäristöön.

Vahvista viimeistään tässä vaiheessa mahdollisesti vielä auki olevat sopimukset, kuten tuotantoympäristön palvelimien vuokraus-, asennus-, konfigurointipalvelu- ja ylläpitopalvelusopimukset.

Tässä osiossa ohjeistetaan tuotantoympäristöön liittymisen vaiheet. Hallinnollisen henkilön vastuulle kuuluvat vaiheet 2 ja 10, muut vaiheet kuuluvat tekniseen liittymisprosessiin: 

1. Valmistele liityntäpalvelimen käyttöönotto 
2. Lähetä käyttölupahakemus tuotantoympäristöön. Lue ohje alta.
3. Avaa palomuurit aiemmin saamiesi ohjeiden mukaan.
4. 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.
5. Määrittele liityntäpalvelin. Määrittelyn voi tehdä ohjelmallisesti tai manuaalisesti.
6. Lisää liityntäpalvelimelle alijärjestelmä. Alijärjestelmä toimii rajapintana Palveluväylään tiedon hakemista ja jakamista varten.
7. Liitä asiakasjärjestelmä liityntäpalvelimelle. Näin tieto siirtyy tietojärjestelmistäsi Palveluväylälle ja toisin päin.
8. Jos tarjoat palveluita muille organisaatioille Palveluväylässä, lisää palvelusi liityntäpalvelimelle. Palvelut lisätään jollekin aiemmin lisätylle alijärjestelmälle.
9. 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.
10. Kuvaile organisaatiosi sekä mahdolliset palvelusi Liityntäkatalogiin. Lue ohje alta.

2. Lähetä käyttölupahakemus tuotantoympä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.

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 tuotantoympäristöön liittymistä varten.

10. Kuvaile organisaatiosi sekä mahdolliset palvelusi Liityntäkatalogiin 

Kuvaile lopuksi organisaatiosi sekä palveluidesi tiedot LiityntäkatalogiinAvautuu uuteen ikkunaan. vähintään suomeksi ja ruotsiksi. Varmista, että alijärjestelmäsi näkyy oikein Liityntäkatalogissa ja tutustu tarjolla oleviin palveluihin. Saat tunnukset Liityntäkatalogiin, kun tuotantoympäristön tekninen liittymisprosessi on valmis ja palvelusi löytyy Palveluväylän tuotantoympäristöstä. Lue lisää Liityntäkatalogin ympäristöistä ja tutustu Liityntäkatalogin ohjeisiin.

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. 

Voit nyt aloittaa Palveluväylän tuotantokäytön. 

Muista myös huolehtia liityntäpalvelimesi ja tietojesi ylläpidosta. 

Huomioitavaa varmenneprosessista tuotantoympäristössä

Palveluväylän varmenteet haetaan Digi‑ ja väestötietoviraston (DVV) verkkoasioinnissa myös tuotantoympäristöä varten. Organisaatio vastaa siitä, että verkkoasioinnissa on käytössä ajan tasalla oleva asiakastili ja että varmenneprosessin hoitamiseen tarvittavat käyttäjät on kutsuttu tilille.

Vaikka varmennehakemuksen voi tehdä tekninen tai hallinnollinen yhteyshenkilö, hallinnollisen henkilön vastuulla on varmistaa, että teknisillä yhteyshenkilöillä on tarvittavat oikeudet varmenteiden hakemiseen ja uusimiseen koko tuotantokäytön ajan.