Käyttölupahakemuksen täyttäminen Palveluväylään

Organisaatiosi pitää täyttää ja lähettää käyttölupahakemus ennen kuin organisaatiosi voi liittyä Palveluväylään. Sinun täytyy hakea käyttölupaa erikseen sekä testi- että tuotantoympäristöihin.

Huomioi seuraavat asiat ennen kuin lähetät Palveluväylän käyttölupahakemuksen:

1. Liityntäpalvelin on nimetty Palveluväylän ohjeiden mukaisesti ja FQDN-nimi löytyy julkisesta nimipalvelusta. Lue lisää liityntäpalvelimen nimeämisestä.
2. Liityntäpalvelimelta löytyy RHEL 8 tai Ubuntu 24.04LTS -käyttöjärjestelmä tai kontitetun liityntäpalvelimen tapauksessa jokin Linux-alusta, jolle on asennettu Docker.

Tarvitset liityntäpalvelimen nimen (FQDN-nimi) ja IPv4-osoitteen käyttölupahakemusta varten. Saat nämä tiedot liityntäpalvelimesta vastaavalta henkilöltä. Huomioi, että et voi tehdä käyttölupahakemusta ennen kuin organisaatiollasi on käytössään alusta, johon liityntäpalvelinohjelmisto myöhemmin asennetaan.

Näin täytät käyttölupahakemuksen

Aloita hakemalla käyttölupaa testiympäristöön. Hae käyttölupaa tuotantoympäristöön, kun olet valmis siirtämään palvelusi tuotantoon.

Tarvitset lomaketta 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) sekä organisaation nimi ja Y-tunnus, mikäli eri kuin käyttölupaa hakeva organisaatio
• liityntäpalvelimen tiedot liityntäpalvelimesta vastaavalta henkilöltä
• oikeuden hyväksyä Palveluväylän käyttöehdot

1. Valitse seuraava linkki: Täytä käyttölupahakemusAvautuu uuteen ikkunaan..
2. Rekisteröidy Palveluhallinnan käyttäjäksi, jos et ole tehnyt sitä aiemmin. Aloita rekisteröityminen tunnistautumalla vahvasti. Tarvitset rekisteröitymistä varten Y-tunnuksen. Lisätietoa rekisteröitymisestä löydät Palveluhallinnan ohjeista. Rekisteröitymisen voi tehdä kuka tahansa organisaatiostasi.
3. Täytä käyttölupahakemus valitsemaasi ympäristöön. Osa tiedoista on esitäytetty Palveluhallinnan asiakastilin tietojen perusteella. Tarkista tiedot ja muokkaa niitä tarvittaessa.

Lomake on jaettu neljään osioon. Merkitse osiot valmiiksi valitsemalla Merkitse valmiiksi. Tarvittaessa voit kutsua muita henkilöitä täyttämään käyttölupahakemusta, esimerkiksi teknisen yhteyshenkilön täydentämään liityntäpalvelimen tiedot.

Kun kaikki osiot on merkitty valmiiksi, valitse Lähetä hakemus. Alla olevasta listasta saat apua lomakkeen täyttämiseen.

• Valitse ensin haetko lupaa testiympäristöön (FI-TEST) vai tuotantoon (FI). Käyttölupahakemus on samanlainen kummallekin ympäristölle. Hae ensin lupaa testiympäristöön.

Kuva: Ympäristön tyypiksi voi valita joko testi- tai tuotantoympäristön

Näytä kuva suurempana

• Palvelun käyttötarkoitus: Jos organisaatiosi tarjoaa tietoja Palveluväylän kautta, valitse Palveluntarjoaja. Jos taas tarkoituksena on ainoastaan hyödyntää muiden tarjoamia tietoja, valitse Tietojen hakeminen. Jos organisaatiosi toimii sekä palveluntarjoajana että tietojen hyödyntäjänä, valitse Palveluntarjoaja. Rooli ei ole sitova, vaan voit muuttaa sitä myöhemmin ilman erillistä ilmoitusta.

Kuva: Palvelun käyttötarkoitukseksi voi valita joko Palveluntarjoaja tai Tietojen hakeminen.

Näytä kuva suurempana

• Liityntäpalvelimen tiedot: Valitse liityn ulkoisen osapuolen liityntäpalvelimelle, jos liityt toisen organisaation jo olemassa olevalle liityntäpalvelimelle tai ulkoisen palveluntarjoajan tarjoamalle liityntäpalvelimelle.

Kuva: Liityntäpalvelimen tiedoiksi voi valita 'Pystytän uuden liityntäpalvelimen', 'Käytän omaa olemassa olevaa liityntäpalvelinta' tai 'Liityn ulkoisen osapuolen liityntäpalvelimelle'.

Näytä kuva suurempana

• FQDN-nimi:  Alustapalvelimesi nimi, josta tulee liityntäpalvelimesi nimi. Palvelimen FQDN-nimen (Fully qualified domain name) tulee olla julkisessa verkkotunnusten nimipalvelussa (Whois-palvelu) ennen Palveluväylään liittymistä. Nimen tulee sisältää organisaatiosi nimi tai virallinen lyhenne ja sen tulee olla kirjoitettu kokonaan pienillä kirjaimilla. Lue lisää liityntäpalvelimen nimeämisestä.

Kuva: Käyttölupahakemukseen täytyy täyttää palvelimen FQDN ja sen IPv4. Osoitteita voi lisätä useampia.

Näytä kuva suurempana

• Julkinen IPv4-osoite: Alustapalvelimen julkinen IP-osoite. IP-osoitteen täytyy olla staattinen eli se ei saa muuttua. Huom. Jos saapuvalle ja lähtevälle liikenteelle on eri IP-osoitteet, ilmoita molemmat kohdassa Julkinen IPv4-osoite.
• Liityntäkatalogin pääkäyttäjän tiedot: Liityntäkatalogin pääkäyttäjä on vastuussa Palveluväylään liitettyjen palveluiden kuvaamisesta LiityntäkatalogiinAvautuu uuteen ikkunaan..
• Hyväksy ehdot: Kun kaikki muut osiot on merkitty valmiiksi, hyväksy Suomi.fi-palveluiden käyttölupa sekä Palveluväylän käyttöehdot (käyttöehdot pdf-tiedostona alla). Huomaa, että sinulla täytyy olla oikeudet käyttöehtojen hyväksymiseen organisaatiossasi. Pyydä tarvittaessa toista henkilöä hyväksymään ehdot.

Palveluväylän käyttöehdot (PDF, 383,71 kt)Avautuu uuteen ikkunaan.

Käyttölupahakemuksen käsittelyssä kuluu yleensä muutama päivä. Kun hakemus on käsitelty, saat palveluvayla@palveluvayla.fiAvautuu uuteen ikkunaan.-osoitteesta asennusohjeet testiympäristöön liittymistä varten. Jos lomakkeessa on virheitä tai ongelmia, Palveluväylän ylläpito voi pyytää sinua tekemään muutoksia liityntäpalvelimeen.

Kutsu muita henkilöitä täyttämään käyttölupahakemus

Voit kutsua muiden organisaatioiden jäseniä täyttämään käyttölupahakemustasi sähköpostikutsulla. Tämä mahdollistaa esimerkiksi sen, että tekninen toimija täydentää liityntäpalvelimen tiedot. Tarvitset pääkäyttäjän oikeudet, jotta voit kutsua muita henkilöitä organisaatiosi jäseneksi.

1. Varmista, että organisaation jäsen on rekisteröitynyt Suomi.fi-palveluhallintaan. Pyydä tarvittaessa kutsuttavaa henkilöä rekisteröitymään.
2. Kutsu haluamasi käyttäjä oman organisaatiosi jäseneksi seuraamalla Palveluhallinnan ohjeita.
3. Kun kutsumasi henkilö on rekisteröitynyt Palveluhallinnan käyttäjäksi, anna hänelle oikeudet Suomi.fi-palveluväylään. Lue lisää käyttäjähallinnasta Palveluhallinnan ohjeista.