Suomi.fi-tunnistuksen varmennekäytänteisiin muutoksia

TLS-varmenteiden voimassaoloajat tulevat lyhenemään lähivuosina vaiheittain, vuoden 2026 maaliskuussa 200 päivään ja muutaman vuoden päästä 47 päivään. TLS-varmenteiden voimassaoloaikojen lyheneminen tuo muutoksia Suomi.fi-tunnistuksen varmenneohjeisiin.  Uudet varmennekäytänteet ovat tulleet voimaan joulukuussa 2025. Lue aiempi tiedote aiheesta täältä: https://kehittajille.suomi.fi/ajankohtaista/suomi-fi-tunnistuksen-varmennekaytanteisiin-muutoksia-vaatii-toimia-asiointipalveluilta.

Suomi.fi-tunnistuksen varmennekäytänteet muuttuvat

Suomi.fi-tunnistuksen varmennekäytänteiden muutokset koskevat SAML-varmennetyyppiä sekä varmenteiden voimassaoloaikaa. 

Asiointipalvelun metadatatiedostossa olevan SAML-varmennetyypin on oltava palvelinvarmenteen sijaan järjestelmäallekirjoitusvarmenne. Järjestelmäallekirjoitusvarmenteita myöntää Digi- ja väestötietovirasto. Lisätietoa DVV:n varmenteiden tilauksesta löydät osoitteesta https://dvv.fi/miten-tilaan-palveluvarmenteenAvautuu uuteen ikkunaan.. TLS-varmenteiden käytön jatkaminen tulee lisäämään asiointipalveluiden ylläpitotyön määrää varmenteiden voimassaolon lyhenemisen takia. Tämän vuoksi suositus on ottaa käyttöön DVV:n myöntämä järjestelmäallekirjoitusvarmenne, joka on voimassa 2 vuotta. 

Suomi.fi-tunnistuksen varmenneohjeet löytyvät osoitteesta https://kehittajille.suomi.fi/palvelut/tunnistus/tekninen-kayttoonotto/metatiedot/asiointipalvelun-metadatatiedoston-muodostaminen. 

Vaikutus testiympäristöön

Testiympäristössä voi käyttää itse allekirjoitettuja varmenteita. Testiympäristön varmenteiden voimassaolo saa olla enintään 2 vuotta. 

Aikataulu

Uudet varmennekäytänteet ovat tulleet voimaan joulukuussa 2025. Lue aiempi tiedote aiheesta täältä: https://kehittajille.suomi.fi/ajankohtaista/suomi-fi-tunnistuksen-varmennekaytanteisiin-muutoksia-vaatii-toimia-asiointipalveluilta.

Tällä hetkellä varmenteiden voimassaoloaikaa ei tarkasteta, mutta vuoden 2028 alusta varmenteiden voimassaoloaika tullaan tarkistamaan tuotantoympäristössä sekä testiympäristössä. 

Asiointipalveluille annetaan vuosi lisäaikaa varmenteiden voimassaoloajan tarkistamiseen. Vanhentuneiden varmenteiden voimassaoloaika aletaan tarkistamaan 1.1.2028 alkaen. Lisäajalla mahdollistetaan asiointipalveluiden OIDC-rajapinnan käyttöönotto ennen kuin TLS-varmenteiden voimassaoloaikaa aletaan tarkistamaan. 

Jos asiointipalveluilla on vanhentuneita ja poistettavia ympäristöjä, tulee poistopyyntö laittaa osoitteeseen tunnistus-kayttoonotot@dvv.fi. Asiointipalveluiden ei ole mahdollista itse poistaa Palveluhallinnasta ympäristöjä.

Toimenpiteet asiointipalveluille

Tarkista palvelusi SAML-varmenteen voimassaoloaika. Kysy tarvittaessa lisätietoa järjestelmätoimittajaltasi. 

Jos varmenne on vanhentunut, päivitä uusi varmenne ohjeiden mukaan.  Jos varmenne on voimassa, huomioi seuraavaan varmennepäivityksen yhteydessä varmenneohjeet.

Lisätietoa

Lue TLS-varmenteiden lyhenemisestä lisää: https://www.digicert.com/blog/tls-certificate-lifetimes-will-officially-reduce-to-47-daysAvautuu uuteen ikkunaan..