Tarkennus Suomi.fi-tunnistuksen OIDC-rajapinnan julkaisuaikatauluun

Suomi.fi-tunnistus ottaa käyttöön OpenID Connect -protokollaa tukevan rajapinnan SAML 2.0-standardin sijaan. Muutoksessa korvataan nykyinen SAML-rajapinta uudella OIDC-rajapinnalla. Uuden rajapinnan käyttöönotto vaatii asiointipalveluilta toimenpiteitä.  Nykyinen Suomi.fi-tunnistuksen SAML-rajapinta tulee poistumaan siirtymäajan jälkeen. Lue lisää aiemmasta uutisesta: https://kehittajille.suomi.fi/ajankohtaista/suomi-fi-tunnistus-ottaa-kayttoon-openid-connect-rajapinnan-muutos-vaatii-toimenpiteita-asiointipalveluilta.

OIDC-rajapinnan käyttöönoton aikataulu 

OIDC-rajapinnan aikataulut

• Testiympäristö julkaistaan 3.12.2026. Ilmoitamme erikseen, kun rajapinta on julkaistu asiakkaiden testaamista varten.
• Tuotantoympäristö julkaistaan 28.1.2027. Ilmoitamme erikseen, kun rajapinta on julkaistu.
• Siirtymäaika päättyy 1.6.2028. Tämän jälkeen tunnistautuminen ei toimi SAML-rajapinnan kautta.  

Testiympäristön ja tuotantoympäristön käyttöönottoa ei ole pakko tehdä samaan aikaan, kun Suomi.fi-tunnistus julkaisee OIDC-rajapinnat. Asiointipalvelut voivat tehdä siirtymisen omien aikataulujensa mukaan, rajapintamuutoksen siirtymäajan huomioiden.  Asiointipalveluiden vastuulla on testata muutos ennen tuotantoon siirtymistä. 

Asiointipalveluiden tulee siirtyä käyttämään OIDC-rajapintaa 1.6.2028 mennessä. Suomi.fi-tunnistuksen nykyinen SAML-rajapinta säilyy siirtymäajan tuettuna rajapintana. Siirtymän aikataulutus ja suunnittelu kannattaa aloittaa organisaatiossasi heti, jotta asiointipalvelusi siirtymä saadaan toteutettua siirtymäajan aikana.  Nykyinen SAML-rajapinta poistuu käytöstä Suomi.fi-tunnistuksessa 1.6.2028 jälkeen. Tämän jälkeen tunnistautuminen ei toimi SAML-rajapinnan kautta.  

Suomi.fi-tunnistuksen varmennekäytänteisiin muutoksia

Tiedotimme aiemmin Suomi.fi-tunnistuksen varmennekäytänteiden muutoksista. Lue aiempi tiedote täältä: https://kehittajille.suomi.fi/ajankohtaista/suomi-fi-tunnistuksen-varmennekaytanteisiin-muutoksia-vaatii-toimia-asiointipalveluilta.

Asiointipalveluille annetaan vuosi lisäaikaa SAML-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ö lähettää osoitteeseen tunnistus-kayttoonotot@dvv.fi. Asiointipalveluiden ei ole mahdollista itse poistaa ympäristöjä.

Tarjoamme tukea OICD-rajapinnan käyttöönotossa 

Järjestämme infotilaisuuden uudesta OIDC-rajapinnasta.  Lähetämme tarkemmat ohjeet infotilaisuuteen ilmoittautumisesta sähköpostitse lähiviikkoina. Julkaisemme ohjeet OIDC-rajapinnan käyttöönottoon sekä annamme tukea rajapinnan käyttöönotossa.