Suomi.fi-valtuudet ja huoltajan tunnuksen luominen
Päivitetty viimeksi: 23.6.2025
Suomi.fi-valtuudet on Digi- ja väestötietoviraston (DVV) tarjoama palvelu, joka mahdollistaa henkilöiden ja organisaatioiden välisen sähköisen asiointivaltuuttamisen. Palvelun avulla huoltaja voi luoda itselleen Wilma-tunnuksen ja lisätä Wilmassa huoltajaroolin, vaikka hänellä ei olisi ennestään Wilma-tunnusta tai avainkoodia.
Palvelun hyödyt
- Huoltajille ei tarvitse luoda avainkoodeja, mikä nopeuttaa ja helpottaa Wilma-tunnusten luontia.
- Valtuudet perustuvat väestötietojärjestelmään, ja ne tarkistetaan automaattisesti palvelussa asioitaessa.

Palvelun käyttöönotto kestää kokonaisuudessaan 8-12 viikkoa.
Palvelun käyttöä edellyttävä hakuprosessi on ohjeistettu ohjeessa Suomi.fi-palvelut ja hakuprosessi.
DVV kysyy käyttöönoton yhteydessä paluuosoitetta, joka on muotoa https://asiakas.inschool.fi/connect/asiointivaltuudet. "Asiakas"-sana pitää korvata oman Wilma-ympäristönne mukaisella tiedolla.
Lisätietoa palvelusta:

Valmistelut
Ota esille seuraavat kentät:
Primuksen kenttä | Rekisteri |
---|---|
Suomi.fi-valtuudet käytössä | Koulun tiedot |
Suomi.fi-valtuuksien salasana | Koulun tiedot |
Suomi.fi-valtuuksien Web API client ID | Koulun tiedot |
Suomi.fi-valtuuksien API key | Koulun tiedot |
Salli huoltajaroolien lisäys Suomi.fi-valtuuksien kautta | Opiskelijalajit |
Käyttöönotto
- Täytä tarvittavat tiedot Koulun tiedot -rekisterin kenttiin. Salasanan ja API-tiedot saat DVV:ltä, kun käyttölupahakemus on hyväksytty.
- Rasti Opiskelijalajit-rekisteristä kenttä Salli huoltajaroolien lisäys Suomi.fi-valtuuksien kautta niille opiskelijalajeille, joille huoltajaroolien lisäys halutaan mahdollistaa.
Muut edellytykset toiminnon käytölle:
- Huoltaja on tehnyt vahvan tunnistuksen (eli myös Suomi.fi-tunnistuspalvelu on otettava käyttöön).
- Koululla on asiointivaltuuksien käyttöoikeus.
Palvelun toiminnan varmistaminen
Suomi.fi-valtuudet palvelua ei testata erillisillä testihenkilöillä, vaan toimivuus tulee varmentaa jonkun todellisen henkilön kautta:
- Kun käyttölupa on myönnetty ja toiminto on valmis otettavaksi käyttöön, varmista, että kentässä Suomi.fi-tunnistus testitilassa ei ole rastia.
- Tämän jälkeen voi kokeilla Wilmassa roolin lisäämistä huoltajatunnukseen Suomi.fi-valtuuksia käyttäen.

Roolin voi lisätä Wilmassa tunnuksen luonnin yhteydessä tai Käyttöoikeudet-sivun kautta klikkaamalla Lisää rooli -painiketta. Huoltajille löytyy tästä oma tarkempi ohje.
Käyttäjän on ensin valittava asiointikoulu. Huoltaja voi ohittaa tunnistautumisen (jos on tehnyt sen jo) ja jatkaa suoraan roolin lisäykseen. Huoltaja ei voi asiointivaltuuksien kautta lisätä huoltajaroolia, ennen kuin hän on tehnyt vahvan tunnistautumisen.
Rooli lisätään Suomi.fi-valtuuksien hakupainiketta klikkaamalla, jolloin huoltaja voi valita yhden huollettavansa kerrallaan liitettäväksi tunnukseensa.
Koulut, joilla on sama Suomi.fi-valtuuksien Web API client ID, näytetään yhtenä valintana taulukossa. Näiden koulujen osalta huoltajaroolit voidaan yhdistää kerralla.
Huoltajalle lisätään valtuutuksen jälkeen huoltajuus opiskelijakorttiin, jos se täyttää seuraavat ehdot:
- opiskelijakortin Koulu-kentän 1. rivin koululla on Suomi.fi-valtuudet-palvelu käytössä ja huoltajan valitseman koulun API-avain
- opiskelijan henkilötunnus täsmää Suomi.fi-valtuudet-palvelun tietoon
- opiskelijan opiskelijalaji sallii huoltajaroolin linkityksen Suomi.fi-valtuudet-palvelun kautta
- kyseisellä huoltajalla ei ole ennestään käyttäjätunnusta opiskelijakortin Huoltajien Wilma-tunnukset -kentässä.
Samalla kerralla voi lisätä sekä avainkoodilla että Suomi.fi-valtuudet-palvelun kautta huoltajarooleja.

Tietojen hausta jää talteen tieto, kuka tietoja on hakenut. Tiedot menevät lokitiedostoihin omalla tapahtumatunnisteella. Tiedoissa on mukana:
- kyselyn tekijä
- ajankohta
- tyyppi