Suomi.fi-valtuuksien rajapintapalveluiden käyttöönotto
Voit liittää Suomi.fi-valtuuksien rajapintapalvelut osaksi asiointipalveluanne alla lueteltujen kahdeksan vaiheen mukaisesti.
Käyttöönoton työmäärä riippuu siitä, kuinka laajoja muutoksia teette. Varatkaa riittävästi resursseja ja aikaa rajapintapalvelun testaamista ja tuotantoon vientiä varten.
Tutustu Valtuudet-palvelun aineistoon huolellisesti ja suunnittele puolesta-asioinnin käyttötapauksia sekä rajapintapalvelun käyttöönottoa.
Asiointipalvelussanne pitää olla käytössä vahvan tunnistamisen tunnistuspalvelu, jotta voitte hyödyntää Valtuudet-palvelua. Voitte ottaa käyttöön esimerkiksi Suomi.fi-tunnistuksen.
Jos organisaatiosi ei ole ennen asioinut Palveluhallinnassa, rekisteröi organisaation tiedot. Jos organisaatiolla on jo Palveluhallinnan asiakastili, pyydä organisaatiosi edustajaa lähettämään sinulle kutsu Palveluhallintaan. Sinut lisätään automaattisesti osaksi oman organisaatiosi tiliä. Tämän jälkeen voit kirjautua Palveluhallintaan.
Suomi.fi-valtuuksien käyttöehdot v1.3 (PDF, 233,71 kt)Avautuu uuteen ikkunaan.
Suunnittele käyttöönoton tarkempi aikataulu ja muut yksityiskohdat yhdessä Digi- ja väestötietoviraston kanssa. Tutustu tarkemmin seuraaviin materiaaleihin:
Valitse, mitä liityntätapaa aiot käyttää:
- Liityntäpalvelinrajapinta eli Suomi.fi-palveluväylä (yrityksen puolesta asiointiin)
- Web API -rajapinta (henkilön ja yrityksen puolesta asiointiin).
Suunnittele myös sääntömoottorin eli hallintakäyttöliittymän (henkilö ja/tai yritys) konfigurointi:
- Sääntömoottori henkilön puolesta asioinnissa (Delegate, Authorization)
- Sääntömoottori yrityksen puolesta asioinnissa (OrganizationalRoles).
VALINNAINEN:
Valitse valtuusasiat, joita palvelussanne on tarkoitus hyödyntää. Voitte
- valita jo olemassa olevista valtuusasioista sopivatAvautuu uuteen ikkunaan. tai
- määritellä tarpeidenne mukaan uusia valtuusasioita.
Tutustu valtuusasioiden määrittelyohjeeseen.Avautuu uuteen ikkunaan.
- Jos käytät liityntäpalvelinrajapintaa, liity ensin Palveluväylään.Avautuu uuteen ikkunaan. Asenna sitten testiliityntäpalvelin. Toimita Digi- ja väestötietovirastolle tarvittavat tiedotAvautuu uuteen ikkunaan.: Member Class, Member Code ja Subsystem Code. Digi- ja väestötietovirasto perustaa organisaatiollesi testipalvelun ja toimittaa siihen liittymiseen tarvittavan aineiston.
- Jos käytät Web API -rajapintaa, Digi- ja väestötietovirasto perustaa organisaatiollesi testipalvelun hakemuksesi perusteella ja toimittaa siihen liittymiseen tarvittavan aineiston. Ilmoita Digi- ja väestötietovirastolle paluuosoite.Avautuu uuteen ikkunaan.
Käytä testaukseen Digi- ja väestötietoviraston toimittamaa testidataa. Raportoi Digi- ja väestötietovirastolle testauksen edistymisestä sekä mahdollisista virhetilanteista ja ongelmista. Tee tarvittavat muutokset tuotantoa varten.
Käyttöönottotiimin tarvitsemat tiedot:
- Ote tapahtumalokista. Lokituksesta tulee käydä ilmi, kuka asioi, kenen puolesta, missä asiassa ja milloin. Lue lisää lokitusvaatimuksista.
- Ruutukaappaukset toisen puolesta asioinnin asiointipolusta.
- AsiakasohjeistusAvautuu uuteen ikkunaan..
- Jos käytät liityntäpalvelinrajapintaa, asenna tuotantoliityntäpalvelin. Ilmoita Digi- ja väestötietovirastolle Member Class, Member Code, Subsystem Code.
- Jos käytät Web API -rajapintaa, ilmoita Digi- ja väestötietovirastolle paluuosoite.
Ilmoita Digi- ja väestötietovirastolle organisaatiosi yhteyshenkilön nimi ja henkilötunnus pääsyoikeuksien myöntämiseksi asiointipalvelun sääntömoottoria eli hallintakäyttöliittymää varten.
Aseta sääntömoottorin säännöt organisaatiosi suunnittelemalla tavalla.
Testaa tuotantoympäristön toimivuus aidolla datalla. Kouluta organisaatiosi henkilöstö uusiin toimintamalleihin.
Pidä valtuuksiin liittyvä ohjeistus ajan tasalla ja tee päivityksiä sääntömoottorille, mikäli palveluun tulee muutoksia.