Muistutus: Suomi.fi-viesteissä siirrytään REST-rajapintaan

Suomi.fi-viestien käytössä siirrytään REST-rajapintaan. Tämän uuden rajapinnan kautta on mahdollista saada käyttöön toiminnallisuuksia, jotka ovat olleet aiemmin Suomi.fi-viesteissä eri rajapintojen ominaisuuksina.

REST-rajapinnan myötä Suomi.fi-viestejä käyttävien organisaatioiden ei enää tarvitse vertailla eri rajapintoja ja niiden ominaisuuksia – kaikki ominaisuudet ovat nyt saatavilla yhden rajapinnan kautta. Samalla on kehitetty palvelun toiminnallisuuksia: mukaan on tullut uusia ominaisuuksia ja olemassa olevia on päivitetty vastaamaan paremmin käyttäjien tarpeita.

Digi- ja väestötietovirasto on määritellyt aikataulun, jolla vanhoista liitynnöistä tullaan luopumaan vaiheittain. REST-rajapinta ei vaikuta vanhoihin rajapintoihin, vaan ne toimivat uuden rajapinnan rinnalla toistaiseksi. Kaikki uudet Suomi.fi-viestien käyttöönotot tehdään kuitenkin jo nyt vain REST-rajapinnan kautta.

Siirtymäaikataulu REST-rajapintaan:

1.1.2025 alkaen: Uusia liityntöjä ei tehdä enää vanhoihin rajapintoihin, esim. uusia sähköpostiliityntöjä ei enää avata.

1.1.2026 alkaen: Vanhoihin liityntöihin ei enää lisätä palveluja (koskee erityisesti ICT-palvelutuottajien tarjoamia ohjelmistoratkaisuja)

1.1.2027: Vanhat rajapinnat suljetaan. Jokaisen Suomi.fi-viestejä käyttävän organisaation pitää olla siirtynyt käyttämään uutta REST-rajapintaa.

Mitä siirtymä tarkoittaa Suomi.fi-viestejä jo käyttäville organisaatioille?

Siirtymä edellyttää toimenpiteitä organisaatioilta, jotka käyttävät Suomi.fi-viestejä WS-, SFTP- tai SMTP-rajapintojen kautta.

Tehtävät toimenpiteet riippuvat siitä,

• mikä rajapinta on käytössä,
• mihin rajapintaa on käytetty ja
• miten rajapinta on toteutettu.

Olemme julkaisseet blogikirjoituksen Suomi.fi-viestejä käyttävien organisaatioiden ja Viestit-palvelun tarjoamiinsa ohjelmistoihin integroineiden välitoimijoiden tueksi.  Blogissa avaamme, mitä REST-siirtymä tarkoittaa eri rajapintojen käyttäjille ja mitä REST-siirtymän yhteydessä on hyvä ottaa huomioon.

Tiivistettynä:

Mitä siirtymä tarkoittaa WS- ja SFTP-rajapintoja käyttäville organisaatioille?

• Selvittäkää, onko organisaationne käytössä WS- tai SFTP-rajapinta.
• Ottakaa yhteyttä ICT-asiantuntijaan tai omaan ohjelmistotoimittajaanne ja selvittäkää,  onko haluttuun järjestelmään suunnitteilla REST-tuki ja millä aikataululla? Selvittäkää myös, mitä toiminnallisuuksia aiotaan tukea jatkossa.
• Aikatauluttakaa siirtymä hyvissä ajoin.
• Käykää läpi REST-rajapinnan tarjoamat uudet toiminnallisuudet ja suunnitelkaa asiakasprosessinne uusiksi. Huolehtikaa myös hyvästä viestinnästä ja kouluttakaa asiakaspalvelijanne.
• Jos Suomi.fi-viestejä käytetään jatkossa samoissa palveluissa kuin aikaisemmin käyttölupaa ei tarvitse hakea.
• Pohtikaa, onko organisaatiossanne muita palveluita, jotka voisivat myös hyötyä Suomi.fi-viestien käyttöönotosta.

Mitä siirtymä tarkoittaa SMTP-rajapintaa käyttäville organisaatioille?

Jos organisaatiollanne on ollut käytössä SMTP-rajapinta (=sähköpostiliityntä), Suomi.fi-viestit ei jatkossa enää tarjoa sähköposti-integraatiota. Suomi.fi-viesteillä ei myöskään ole asiakasorganisaatiolle suunnattua käyttöliittymää palveluun.

• Käykää läpi, mihin SMTP-rajapintaa on tähän mennessä käytetty.
• Arvioikaa, mitä jatkossa haluatte toiminnallisuuden tilalle.
• Ilmoittakaa Digi- ja väestötietovirastolle, kun sähköpostiliitynnän saa organisaationne osalta sulkea (viestit-kayttoonotot@dvv.fi). SMTP-rajapinta suljetaan kokonaan 1.1.2027.

Suomi.fi-viestien ohjeisiin sivulle Valmisohjelmistot ja Viestien käyttöönotto on koottu Digi- ja väestötietoviraston tiedossa olevia asianhallintajärjestelmiä ja muita valmisohjelmistoja, jotka esimerkiksi tarjoavat integraation Suomi.fi-viesteihin. Sivulla on myös vinkkejä Suomi.fi-viestien vaatimuksien huomioimiseksi järjestelmäkilpailutusten yhteydessä.

Ohjeistus REST-rajapintaan siirtymiselle

Suomi.fi-viestien vanhoista rajapinnoista (WS, SFTP) siirtyminen uuteen REST-rajapintaan tapahtuu pitkälti samojen ohjeiden pohjalta kuin uusi REST-käyttöönotto. Muutamia eroja kuitenkin on.

1. Toimittakaa palvelutietolomake ja IP-osoitteet 

Ilmoittakaa palvelutietolomakkeella, mistä järjestelmästä on kyse. Huomatkaa, että jos käytätte Suomi.fi-viestejä jonkin ICT-toimittajan tarjoaman valmisohjelmiston kautta, toimittaja on jo saattanut tehdä IP-avaukset valmiiksi. Asia kannattaa tarkistaa omalta ohjelmistotoimittajalta (joka toimii ns. Suomi.fi-viestien välitoimijana). Kun palvelutietolomake on täytetty ja palautettu, Digi- ja väestötietovirasto tekee IP-avaukset. 

2. Digi- ja väestötietovirasto toimittaa teille tarvittavat tunnukset 

Saatte sähköpostilla organisaatiollenne järjestelmätunnuksen (systemId), palvelutunnuksen (serviceId) sekä testihetut 

Saatte salatulla sähköpostilla: 

• testiympäristön väliaikaisen salasanan, joka tulee vaihtaa ennen käytön aloittamista.
• testauksen jälkeen tuotantoympäristön väliaikaisen salasanan, joka tulee vaihtaa ennen käytön aloittamista.  

Tarkemmat ohjeet salasanan vaihtamiseksi löydätte teknisen käyttöönoton ohjeista.  

3. Toteuttakaa muutokset  

Huomioikaa erityisesti uudet käyttöohjeet ja toiminnallisuudet. Tutustukaa huolellisesti palvelukuvaukseen sekä hallinnollisen käyttöönoton vaiheisiin. 

4. Testatkaa liityntä  

Toteuttakaa liitynnän testaaminen testausohjeiden mukaan. 

5. Palauttakaa käyttöönottojen tarkistuslista

Varmistakaa, että olette organisaatiossa ottaneet huomioon kaikki oleelliset seikat täyttämällä Käyttöönoton tarkistuslistan. 

Huomioittehan, että REST-siirroissa tarkistuslista täytetään soveltuvin osin. Esimerkiksi kohtaa "Prosessimuutokset ja viestintä" ei tarvitse täyttää, jos REST-siirtymä on vain tekninen muutos.

Toimittakaa täyttämänne tarkistuslista Digi- ja väestötietovirastoon ja ilmoittakaa päivämäärä, jolloin aiotte siirtyä tuotantokäyttöön. Ilmoitus tehdään osoitteeseen viestit-kayttoonotot@dvv.fi. Asettakaa sähköpostiviestin aiheeksi "REST-siirto: Tuotantokäytön aloitus".

Kun Digi- ja väestötietovirasto on tarkistanut organisaation täyttämän tarkistuslistan, toimitamme teille tuotantoympäristön tunnukset, jolloin voitte aloittaa Suomi.fi-viestien tuotantokäytön. 

6. Siirtykää käyttämään REST-rajapintaa

Sopikaa vanhan rajapinnan sulkemisen ajankohta yhdessä Digi- ja väestötietoviraston kanssa:  viestit-kayttoonotot@dvv.fi

7. Ylläpitäkää liityntää

Organisaationne tulee myös huolehtia liitynnän ylläpidosta koko sen elinkaaren ajan. Tutustukaa hallinnollisen ja teknisen ylläpidon ohjeisiin Ylläpito -sivulla.

Lisätietoja:

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

viestit-kayttoonotot@dvv.fi