Suomi.fi-palveluväylän uusin ohjelmistoversio 7.4.2 otetaan käyttöön tuotannossa

Palveluväylän keskuspalvelinympäristö päivitetään uuteen 7.4.2 versioon tuotannon osalta 22.5.2024.

Päivitys tuo Palveluväylään merkittäviä muutoksia, joihin sinun on reagoitava. Muutoksista on kerrottu tarkemmin tässä tiedotteessa.

Pakotettu minimiversio

Versiosta 7.4.2 eteenpäin Palveluväylän liityntäpalvelimilta vaaditaan minimi X-road ohjelmistoversio tietoturvan varmistamiseksi. 7.4.2 päivityksen jälkeen keskuspalvelimet vaativat kaikissa ympäristöissä (kehitys-, testi- ja tuotanto-) liityntäpalvelimilta vähintään X-road-version 6.20.0. Jos organisaatiollasi on käytössä tätä vanhempi versio, on liityntäpalvelimesi päivitettävä vähintään 6.20.0-versioon ennen 22.5.2024. Ilman päivitystä yhteydet Palveluväylään ja sen palveluihin katkeavat 22.5.2024.

Jatkossa Palveluväylä tiukentaa minimiversiovaatimusta edelleen. Keskuspalvelinten siirtyessä versioon 7.5 (alustava aikataulu syksy 2024), on vaadittu minimiversio X-road 7.0.4.

Toimenpiteet palveluita hyödyntäville organisaatioille:

Huolehdi, että liityntäpalvelimesi käyttää vähintään sekä keskuspalvelimien (versio 6.20.0 22.5.2024 alkaen) että käyttämiesi palveluiden palveluntarjoajien määrittelemiä minimiversioita. Jokainen palveluntarjoaja määrittelee vaatimansa minimiversion itse.

Jos käytössäsi on versio, jota ei enää tueta, yhteydet Palveluväylään ja sen palveluihin katkeavat.

Voit tarkistaa liityntäpalvelimesi käyttämän X-road-version kirjautumalla käyttöliittymään selaimella. Versiotieto näkyy heti "Clients"-käyttöliittymän alaosassa. Versiotiedon voi myös tarkistaa komentorivin kautta alla olevilla komennoilla:

#RHEL 7/8 käyttöjärjestelmä
yum list xroad*

#Ubuntu 20.04LTS/22.04LTS käyttöjärjestelmä
apt list xroad*

Toimenpiteet palveluita tarjoaville organisaatioille:

Kun palveluntarjoajana päivität liityntäpalvelimesi X-road 7.4.x tai uudempaan versioon, määrittyy palveluntarjoajan liityntäpalvelimillesi uusi oletusasetus. Tällä oletusasetuksella edellytät palveluitasi hyödyntävien asiakkaidesi liityntäpalvelimilta vähintään X-road versiota 7.2. Jos palveluasi hyödyntävän asiakkaan liityntäpalvelin käyttää vanhempaa versiota kuin X-road 7.2.x, katkeaa liikenne täysin palveluntarjoajan ja -hyödyntäjän välillä.

Päivityksen jälkeen voit määritellä minimi X-road-version, jolla palveluitasi tarjoavalle liityntäpalvelimelle voidaan tehdä kutsuja.

Tarvittaessa voit myös määritellä alhaisemman minimiversion. Ilman toimenpiteitä liityntäpalvelimet, jotka käyttävät X-road 7.2 tai vanhempaa X-road versiota, eivät päivityksen jälkeen voi enää kutsua palveluasi tiedonhakijan roolissa.

Saat muutettua oletusasetuksen arvosta 7.2.0 haluamaasi versioon lisäämällä alla olevan rivin /etc/xroad/conf.d/local.ini-tiedoston [proxy]-osioon:

server-min-supported-client-version=6.20.0

Yllä olevassa esimerkissä palveluntarjoaja edellyttää asiakkaan liityntäpalvelimelta vähintään versiota 6.20.0, mutta palveluntarjoajana voit itse määritellä edellyttämäsi minimiversion. Löydät X-roadin eri versiot ja niiden julkaisutiedotteet täältä Avautuu uuteen ikkunaan.(englanniksi).

Palveluntarjoajana sinun on hyvä olla yhteydessä palveluitasi hyödyntäviin organisaatioihin jatkossa edellyttämästäsi minimiversiosta, jotta palveluasi hyödyntävät asiakkaat voivat ajoissa siirtyä vaadittuun versioon. Mikäli mahdollista, suosittelemme aluksi määrittelemään alhaisen minimiversion, jotta asiakkaillasi on tarpeeksi aikaa siirtyä uudempaan versioon. Mikäli palveluasi hyödyntävä organisaatio ei päivitä liityntäpalvelintaan vaatimaasi minimiversioon, estyy liikenne täysin palveluntarjoajan ja -hyödyntäjän välillä.

Päivitys uuteen versioon on tuettu ainoastaan versiosta 7.2.x tai 7.3.x.

Uuden version tarkemmat julkaisutiedot löytyvät alla olevasta osoitteesta (englanniksi):

• https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/279511050/X-Road+v7.4.0+Release+Notes
• https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/345800712/X-Road+v7.4.1+Release+Notes
• https://nordic-institute.atlassian.net/wiki/spaces/XRDKB/pages/414187521/X-Road+v7.4.2+Release+Notes

Kehitysympäristö (FI-DEV) on päivitetty versioon 7.4.2 2.4.2024 ja testiympäristö (FI-TEST) 9.4.2024.

Palveluväylän ylläpito lähettää tarkemmat päivitystä koskevat ohjeet liityntäpalvelinten teknisille yhteyshenkilöille keskusympäristöjen päivityksen jälkeen.

Uuden version asennukseen ja päivitykseen liittyviä kysymyksiä voit lähettää osoitteeseen palveluvayla@palveluvayla.fi.