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.
- Varmista, että organisaatiollanne on selvyys kaikista asiointipoluista, joilla haluatte asiakkaanne voivan hyödyntää Suomi.fi-valtuuksia. Kirjaa kaikki nämä puolesta-asioinnin käyttötapaukset ja asiointipolut käyttölupahakemukseen tarkasti.
- Suunnittele, millä rooleilla haluat sallia puolesta asioinnin asiointipalvelussasi (esimerkiksi huoltaja, toimitusjohtaja tai yhdistyksen puheenjohtaja).
- Suunnittele, millä valtuuksilla haluat sallia puolesta asioinnin asiointipalvelussasi. Löydät tällä hetkellä tuotantokäytössä olevat valtuusasiat osoitteesta: https://www.suomi.fi/valtuudet/valtuusasiatAvautuu uuteen ikkunaan..
- Selvitä ja määrittele organisaatiosi asiantuntijoiden kanssa, mitkä seikat estävät puolesta asioinnin palvelussanne (esimerkiksi turvakielto, huostaanotto tai liiketoimintakielto).
- Päätä, kuka on vastuussa asiointipalvelunne sääntömoottorista.
- Päätä tuotantojulkaisun ajankohta, eli milloin puolesta-asiointi voi alkaa palvelussanne.
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.
Muista lukea läpi myös Suomi.fi-valtuuksien käyttöehdot.
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).
Valitse valtuusasiat, joita palvelussanne on tarkoitus hyödyntää. Tarkistakaa ensin, onko tapaukseenne sopiva valtuusasia jo olemassa.Avautuu uuteen ikkunaan. Jos ei ole, voitte määritellä tarpeidenne mukaan uusia valtuusasioita. Tutustu valtuusasioiden määrittelyohjeeseen.
- 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..
Muista toimittaa katselmointitiedot hyvissä ajoin!
- Jos käytät liityntäpalvelinrajapintaa, asenna tuotantoliityntäpalvelin. Ilmoita Digi- ja väestötietovirastolle "Member Class", "Member Code" ja "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.