Påminnelse: REST-gränssnittet tas i för Suomi.fi-meddelanden

REST-gränssnittet tas i bruk för Suomi.fi-meddelanden. Via det nya gränssnittet är det möjligt att anropa alla de funktioner som tidigare har varit egenskaper hos olika gränssnitt till Suomi.fi-meddelanden.

I och med REST-gränssnittet behöver organisationer som använder sig av Suomi.fi-meddelanden inte längre jämföra olika gränssnitt och deras tillhörande egenskaper – alla egenskaper finns nu i ett och samma gränssnitt. Tjänstens funktioner har också utvecklats: nya funktioner har introducerats och befintliga har uppdaterats för att bättre motsvara användarnas behov.

Myndigheten för digitalisering och befolkningsdata har fastställt en tidsplan för när de gränssnitt som tidigare varit i bruk stegvis fasas ut. REST-gränssnittet påverkar inte de gamla gränssnitten, de fungerar tills vidare parallellt med det nya gränssnittet. Alla nya ibruktaganden av Suomi.fi-meddelanden görs dock redan nu endast via REST-gränssnittet.

Tidsplan för övergången till REST-gränssnittet:

Från och med 1.1.2025: Nya anslutningar görs inte längre via gamla gränssnitt, exempelvis öppnas inga nya e-postanslutningar längre.

Från och med 1.1.2026: Gamla anslutningar kompletteras inte längre med nya tjänster (gäller särskilt programlösningar som tillhandahålls av ICT-tjänsteleverantörer)

1.1.2027: Gamla gränssnitt stängs. Alla organisationer som använder Suomi.fi-meddelanden ska ha övergått till att använda det nya REST-gränssnittet.

Vad innebär övergången för organisationer som redan använder Suomi.fi-meddelanden?

Övergången förutsätter att organisationer som använder Suomi.fi-meddelanden via gränssnitten WS, SFTP eller SMTP vidtar åtgärder.

Vilka åtgärderna som ska vidtas beror på

• vilket gränssnitt som används,
• vad gränssnittet har använts för och
• hur gränssnittet har implementerats.

Vi har publicerat ett blogginlägg till stöd för organisationer som använder Suomi.fi-meddelanden och till mellanaktörer som har integrerat meddelandetjänsten i de programvaror de erbjuder. I bloggen förklarar vi vad övergången innebär för de organisationer som använder tjänsten och vad det är bra att beakta i samband med övergången till REST.

Sammanfattning:

Vad innebär övergången för organisationer som använder gränssnittet WS eller SFTP?

• Ta reda på om er organisation använder gränssnittet WS eller SFTP.
• Kontakta er ICT-expert eller programleverantör och ta reda på om gränssnittet REST stöds av det önskade systemet eller från och med när det kommer att stödjas? Ta också reda på vilka funktioner som kommer att stödjas i fortsättningen.
• Gör i god tid upp en tidsplan för övergången.
• Gå igenom de nya funktioner som REST-gränssnittet erbjuder och planera om er kundprocess. Se också till att kommunikationen är god och att er kundtjänstpersonal får utbildning.
• Det är inte nödvändigt att ansöka om användningstillstånd om Suomi.fi-meddelanden även i fortsättningen används i samma tjänster som tidigare.
• Fundera på om er organisation har andra tjänster som också kan ha nytta av att ta i bruk Suomi.fi-meddelanden.

Vad innebär övergången för organisationer som använder gränssnittet SMTP?

Om er organisation har använt gränssnittet SMTP (= e-postanslutning) innebär övergången att Suomi.fi-meddelanden i fortsättningen inte längre erbjuder någon e-postintegration. Suomi.fi-meddelanden har inte heller något användargränssnitt till tjänsten för kundorganisationer.

• Kontrollera för vilka ändamål gränssnittet SMTP hittills har använts.
• Överväg hur ni i fortsättningen ersätter funktionen.

På sidan Färdigprogram och ibruktagande (på finska) av meddelanden finns utöver anvisningar om Suomi.fi-meddelanden en lista över de ärendehanteringssystem och andra standardprogram som Myndigheten för digitalisering och befolkningsdata känner till och som till exempel erbjuder integration i Suomi.fi-meddelanden. På sidan finns också tips på hur kraven för Suomi.fi-meddelanden kan beaktas i samband med konkurrensutsättning av system.

Anvisningar för övergången till gränssnittet REST

Övergången från de gamla gränssnitten (WS, SFTP) för suomi.fi-meddelanden till det nya REST-gränssnittet sker till stor del enligt samma mönster som när gränssnittet REST tas i bruk. Det finns emellertid några skillnader.

1. Lämna in serviceuppgiftsblanketten och IP-adresserna

Ange på serviceuppgiftsblanketten vilket system det handlar om. Observera att om ni använder Suomi.fi-meddelanden via en färdig programvara som tillhandahålls av en ICT-leverantör kan leverantören redan ha gjort IP-portarna tillgängliga. Kontakta den egna programleverantören (som är mellanaktör till Suomi.fi-meddelanden) för att försäkra er om hur det ligger till. När serviceuppgiftsblanketten har fyllts i och returnerats gör Myndigheten för digitalisering och befolkningsdata IP-portarna tillgängliga. 

2. Myndigheten för digitalisering och befolkningsdata skickar er användaruppgifterna 

Ni får organisationens systemkod (systemId), servicekod (serviceId) och testpersonbeteckningar per e-post. 

Per krypterad e-post skickas: 

• Ett tillfälligt lösenord för testmiljön som ska bytas ut före ibruktagandet.
• Ett tillfälligt lösenord för produktionsmiljön som ska bytas ut före ibruktagandet.

Mer information om byte av lösenord finns i anvisningarna om tekniskt ibruktagande. 

3. Genomför ändringarna

Beakta i synnerhet de nya anvisningarna och funktionerna. Bekanta er noggrant med tjänstebeskrivningen och stegen i det administrativa ibruktagandet. 

4. Testa anslutningen 

Genomför en testning av anslutningen enligt testningsanvisningarna.

5. Returnera checklistan för ibruktagande

Säkerställ att ni inom organisationen har beaktat alla väsentliga faktorer genom att fylla i checklistan för ibruktagande. 

Observera att checklistan fylls i i tillämpliga delar vid övergången till REST. Exempelvis behöver punkten "Processändringar och kommunikation" inte fyllas i om övergången till REST endast är en teknisk ändring.

Skicka den ifyllda checklistan till Myndigheten för digitalisering och befolkningsdata och meddela vilket datumet ni planerar att övergå till produktion. Notifikationen skickas till adressen viestit-kayttoonotot@dvv.fi. Som ämne för e-postmeddelandet anges ”Övergång till REST: Användningen i produktion inleds”.

När Myndigheten för digitalisering och befolkningsdata har kontrollerat den checklista som organisationen fyllt i skickar vi er koderna till produktionsmiljön, efter vilket ni kan börja använda Suomi.fi-meddelanden i produktion. 

6. Ta i bruk gränssnittet REST

Kom överens med Myndigheten för digitalisering och befolkningsdata om när det gamla gränssnittet avslutas:  viestit-kayttoonotot@dvv.fi.

7. Upprätthåll anslutningen

Er organisation ska också sörja för underhållet av anslutningen under hela dess livscykel. Bekanta er med det administrativa och det tekniska underhållet på sidan Underhåll.

Kontaktuppgifter

Stöd för ibruktagande

viestit-kayttoonotot@dvv.fi