Suomi.fi kehittäjille
Siirry suoraan sisältöön.

Ylläpito

Kun organisaationne on liittynyt Suomi.fi-tunnistukseen, tulee teidän huolehtia asiointipalvelujen säännöllisestä ylläpidosta.

Ylläpidossa tulee huomioida seuraavat asiat.

Yhteystietojen ylläpito

Yhteystiedot annetaan asiointipalvelujen ympäristöjen metadatassa, ja niitä käytetään Suomi.fi-tunnistuksen tiedotteiden lähettämiseen.
Huolehtikaa, että yhteystiedot ovat ajantasalla, jotta saatte tiedotteet.

Yhteystietoja hallinnoidaan ympäristön metadatan kautta. Tunnistautukaa vahvasti Suomi.fi-palveluhallintaan, ladatkaa omalle koneelle nykyinen metadata, tehkää tarvittavat muutokset ja päivittäkää ympäristö. Tarkemmat ohjeet metadatan päivittämisestä löytyvät sivulta Hallintaliittymän käyttäminen.

Ympäristön avainten säännöllinen vaihto

Asiointipalvelun tulee vaihtaa ympäristöjen avaimet säännöllisesti hyvien tietoturvakäytäntöjensä mukaisesti.
OIDC-rajapinnassa vaihtokäytännöistä ja -väleistä päättää asiointipalvelu itse, mutta suosittelemme automatisoimaan asiointipalvelun avainten vaihdon.
Näin avainten säännöllinen vaihto voidaan toteuttaa tehokkaasti ja vähällä työmäärällä.

Asiointipalvelu voi vaihtaa OIDC-rajapinnan avaimet ilman metadatan päivittämistä, kunhan ympäristön metadatassa määritetty julkisten avainten osoite (jwks_uri) ei muutu. Tarkemmat ohjeet metadatan päivittämisestä löytyvät sivulta Asiointipalveluiden avainten vaihto OIDC-rajapinnassa.

Tietoturvasta huolehtiminen

Suomi.fi-tunnistuksen käyttö edellyttää hyvien tietoturvakäytäntöjen noudattamista.

Organisaationne vastuulla on varmistaa seuraavat asiat:
- asianmukainen huolehtiminen tietojärjestelmien tietoturvasta
- tietoturvapäivitysten seuraaminen ja tekeminen
- tietoturvapoikkeamien asianmukainen raportointi Digi- ja väestötietovirastolle
- ympäristön ja siihen liittyvien järjestelmien ylläpito, mukaan lukien käyttöoikeuksien, käyttäjätunnusten, varmuuskopioinnin ja häiriötilanteiden hallinta

Voitte lukea Suomi.fi-tunnistuksen tietoturvasta Tietoturva-sivulla.

Palvelun käytön seuraaminen

Voitte seurata organisaationne käyttötilastoja Suomi.fi-tunnistuksen raportista kirjautumalla Suomi.fi-palveluhallintaan. Raportit löytyvät oikean yläkulman valikosta kohdasta "Raportit".
Voitte tehdä rajauksia raportissa tarkasteltaviin tietoihin raportin yläosan suodattimilla. Raportin sivujen välillä edetään näkymän alareunasta löytyvien nuolien avulla.

Vanhojen ympäristöjen poisto

Ympäristöä ei voi poistaa itse Suomi.fi-palveluhallinnassa, vaan poistoa pitää pyytää Suomi.fi-tunnistuksen käyttöönoton tuelta.

Ennen poistoa tarkistakaa ympäristön tunnistautumismäärät seuraavasti:
1. Tunnistautukaa Suomi.fi-palveluhallintaan.
2. Avatkaa Suomi.fi-palveluiden raportit oikean yläkulman valikosta kohdasta "Raportit".
3. Avatkaa Suomi.fi-tunnistuksen raportti.
4. Tarkistakaa raportin sivulta 4, ettei ympäristöön tule enää onnistuneita tunnistautumisia.

Kun tunnistautumismäärät on tarkistettu, lähettäkää poistopyyntö käyttöönoton tukeen osoitteeseen tunnistus-kayttoonotot@dvv.fi.


Päivitetty: 19.11.2026

Oletko tyytyväinen tämän sivun sisältöön?