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

Muutoksia Suomi.fi-viestien REST-rajapintaan: TLS 1.3 -suositus ja IP-osoitteiden rajaus

UutinenSuomi.fi-viestit

Julkaistu 27.5.2026

Muutokset koskevat Suomi.fi‑viestien REST‑rajapintaa. Varmistattehan, että organisaationne järjestelmäintegraatio on ajan tasalla, jos käytätte REST‑rajapintaa.

Jos käytössänne oleva integraatio ei vielä hyödynnä REST‑rajapintaa, siirtykää siihen mahdollisimman pian. Vanhat rajapinnat (WS-, SFTP- ja SMTP‑rajapinnat) suljetaan 1.1.2027.

TLS 1.3 -protokollan käyttöä suositellaan

Digi- ja väestötietovirasto (DVV) suosittelee TLS 1.3 -protokollan käyttöä Suomi.fi-viestien REST-rajapinnassa. DVV tulee myöhemmin lopettamaan TLS 1.2 -protokollan tuen kokonaan.

REST-rajapinnan kutsuminen on jatkossa mahdollista vain järjestelmälle luvitetuista IP-osoitteista

DVV tulee kesäkuun aikana tiukentamaan IP-osoitteiden käyttöä Suomi.fi-viestien REST-rajapinnassa. Jatkossa rajapintaa voi käyttää vain kyseiselle järjestelmälle luvitetuista IP-osoitteista. Muutos koskee testi- ja tuotantoympäristöjä.

Järjestelmällä tarkoitetaan tässä yhteydessä Suomi.fi-viestien konfiguraation käsitettä, joka yksilöidään järjestelmätunnuksella (systemId). Järjestelmätunnus on samalla Suomi.fi-viestien REST-rajapinnan käyttäjätunnus.


Lisätietoja:

Suomi.fi-viestien organisaatioiden käyttöönottojen tuki

viestit-kayttoonotot@dvv.fi

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