Suomi.fi-tunnistus
Päivitetty viimeksi: 23.6.2025
Suomi.fi-tunnistus on Digi- ja väestötietoviraston (DVV) tarjoama palvelu, joka mahdollistaa käyttäjien tunnistamisen turvallisesti ja luotettavasti Wilmassa ja muissa julkishallinnon sähköisissä asiointipalveluissa.
Suomi.fi-tunnistus on tarjolla kaikille Wilman käyttäjätyypeille (huoltajat, opettajat, opiskelijat yms.). DVV ei kuitenkaan välttämättä tarjoa palvelua kaikkien asiakkaidemme käyttöön, sillä palvelua ei ole tarkoitettu kaupalliseen toimintaan.
Suomi.fi-tunnistus ei korvaa Wilman avainkoodeja. Jos avainkoodeja ei haluta enää luoda, täytyy hankkia myös Suomi.fi-valtuudet-palvelu.
Palvelun hyödyt
- Vahva tunnistautuminen vähentää väärinkäytösten riskiä ja suojaa käyttäjien tietoja.
- Palvelu mahdollistaa kirjautumisen useilla eri tunnistusvälineillä, kuten pankkitunnuksilla, mobiilivarmenteella tai varmennekortilla.
- Palvelu on käytössä laajasti suomalaisissa julkishallinnon palveluissa, mikä tekee siitä tutun ja luotettavan vaihtoehdon käyttäjille.

Palvelun käyttöönotto kestää kokonaisuudessaan 8-12 viikkoa.
Palvelun käyttöä edellyttävä hakuprosessi on ohjeistettu ohjeessa Suomi.fi-palvelut ja hakuprosessi.
Lisätietoa palvelusta:

Valmistelut
Ota esille seuraavat kentät:
Primuksen kenttä | Rekisteri |
---|---|
Suomi.fi-tunnistus tehty, klo | Wilman käyttäjätunnukset |
Suomi.fi-tunnistus tehty, pvm | Wilman käyttäjätunnukset |
Suomi.fi-tunnistustapahtuman ID | Wilman käyttäjätunnukset |
Suomi.fi-tunnistus käytössä | Koulun tiedot |
Suomi.fi-tunnistus testitilassa | Koulun tiedot |
Suomi.fi-asiointipalvelun tunnus | Koulun tiedot |
Estä kaikki toiminnot ilman vahvaa tunnistautumista | Koulun tiedot |
Huoltajilta ilman vahvaa tunnistusta estetyt toiminnot | Koulun tiedot |
Käyttöönotto
- Rasti ennen palvelun testaamista Koulun tiedot -rekisteristä kentät Suomi.fi-tunnistus käytössä ja Suomi.fi-tunnistus testitilassa.
- Täytä Suomi.fi-asiointipalvelun tunnus -kenttään DVV:lle toimitettavassa metadatassa ilmoitettava EntityID-tieto.
- Testaa palvelun toimintaa alla olevien ohjeiden mukaan. Kun testaus on onnistuneesti suoritettu ja käyttölupa myönnetty, ota Suomi.fi-tunnistus käyttöön tuotantoympäristössä poistamalla rasti Suomi.fi-tunnistus testitilassa -kentästä.

- Varmista, että Suomi.fi-tunnistus käytössä -kenttä on rastittuna. Sen pitää olla rastittuna jo testausvaiheessa.
- Testiympäristövaiheessa ei saa testata tunnistautumista oikeilla Wilma-tunnuksilla, vaan testauksessa on käytettävä testitunnusta. Testauksessakin käyttäjätunnuskortille tallentuu tietoja, joita ei voi jälkikäteen muuttaa.
- Suorita tarvittavat testit varmistaaksesi, että tunnistus toimii oikein. Käytä tunnistuksen testauksessa DVV:n tarjoamia testitunnuksia, jotka löydät täältä: Testiympäristön tunnistusvälineet.

Tunnistautuminen Wilmassa
Suomi.fi-tunnistusta ei voi merkitä tehdyksi käsin Primukseen, vaan tunnistus on tehtävä Wilmassa.
Tunnistus tehdään tunnuksen luonnin tai roolin lisäyksen yhteydessä connect-sivulla tai Wilmaan kirjautumisen jälkeen Käyttäjätilin asetukset -sivulla. Jos käytössä on vanhantyyppinen Wilma-tunnus ja Wilman käyttö on estetty ilman tunnistautumista, laita Wilman osoitteen perään /connect, niin pääset ensin muuttamaan Wilma-tunnuksen uudentyyppiseksi ja tekemään tunnistuksen.
Tiedot Primuksessa
Kun käyttäjä on tehnyt vahvan tunistuksen, Wilman käyttäjätunnukset -rekisteriin tallentuu automaattisesti seuraavat tiedot käyttäjän kortille:
- DVV:ltä tulleet tiedot tallentuvat kenttiin Etunimet, Sukunimi ja Kutsumanimi. Näitä tietoja ei voi käsin muuttaa tämän jälkeen (tämä koskee myös testitilassa tehtyä tunnistusta).
-
Tieto tunnistuksen ajankohdasta sekä tunnistustapahtuman yksilöllinen ID tallentuvat kenttiin Suomi.fi-tunnistus tehty, klo, Suomi.fi-tunnistus tehty, pvm ja Suomi.fi-tunnistustapahtuman ID.

Wilman käyttäjätunnukset -rekisterissä on funktiot Suomi.fi-tunnistautuminen ja Suomi.fi-testitunnistautuminen, joiden kautta voi näyttää tiedon tunnistautumisesta. Voit esimerkiksi tehdä haun Suomi.fi-tunnistautuminen()=Ei, jolloin näet rekisterikortit, joilla tunnistautumista ei ole tehty.
Funktion voi lisätä esim. infokenttään, jolloin kortilla näkyy tieto tunnistuksesta, tai sen voi lisätä luettelotulosteeseen, jolla saa tulostettua listan käyttäjätunnuksista, joilla tunnistus on tehty. Funkio lisätään infokenttään valitsemalla Wilman käyttäjätunnukset -rekisterissä Ylläpito / Kenttäeditori, avaamalla oikeasta reunasta Infokentät-välilehden ja valitsemalla ikkunan alaosasta Uusi info. Valitse kentäksi Suomi.fi-tunnistus tehty, klikkaa OK ja anna infokentän nimeksi esim. Suomi.fi-tunnistus tehty. Tämän jälkeen rekisterikorteilla näkyy tieto, onko tunnistusta tehty vai ei.

Wilman käytön voi estää käyttäjätyypeittäin, jos käyttäjä ei ole tehnyt tunnistusta. Rasti Koulun tiedot -rekisterin Estä kaikki toiminnot ilman vahvaa tunnistautumista -kentästä kaikki käyttäjätyypit, joilta Wilman käyttö halutaan tässä tilanteessa estää.
Huoltajalta voidaan erikseen estää oikeus pedagogisiin asiakirjoihin tai muistioihin, jos huoltaja ei ole tunnistautunut vahvasti.

Wilman käyttäjätunnukset -rekisterissä voi poistaa kortilta käyttäjän tekemän Suomi.fi-tunnistuksen valitsemalla Lisätoiminnot / Poista vahva tunnistautuminen. Tunnistuksen poistonkaan jälkeen ei voi muokata kenttiä Etunimi, Sukunimi ja Kutsumanimi, jotka täyttyivät automaattisesti tunnistuksen yhteydessä Wilman käyttäjätunnukset -rekisteriin. Kun tunnistustiedon poistaa, sitä ei voi palauttaa Rekisteriin tehdyt muutokset -toiminnon kautta.
Jos esimerkiksi Wilma-käyttäjän nimi muuttuu, täytyy tunnistus poistaa rekisterikortilta. Tämän jälkeenkään henkilön tietoja ei voi muokata rekisterissä, mutta henkilö voi nyt itse avata Wilmassa Käyttäjätilin asetukset -sivulta Vahva tunnistautuminen -välilehden ja sieltä tehdä vahvan tunnistuksen uudelleen Tunnistaudu-painikkeella. Tunnistuksen jälkeen nimi päivittyy myös Primukseen oikeaksi.

- Tunnistuksesta tallentuu aina tieto lokiin (tapahtuman tekijä, ajankohta ja tunniste).
- Vahvasti tunnistettuun käyttäjätunnukseen ei voi tehdä muutoksia tiedonsiirroilla.
- Kun käyttäjä kirjautuu ulos Wilmasta Suomi.fi-tunnistuksen istunnon ollessa voimassa, kirjataan käyttäjä samalla ulos kaikista muistakin palveluista, joissa on voimassa Suomi.fi-tunnistuksen istunto.