Määrittele Palveluväylän palveluntarjoajana asiakasorganisaatioidesi liityntäpalvelimilta edellyttämäsi minimiohjelmistoversio

Tämä artikkeli koskee niitä Palveluväylän asiakkaita, jotka käyttävät Suomi-versioita ja -ohjeistuksia. Jos olet asentanut NIISin repositoriosta Vanilla-paketin, puuttuu liityntäpalvelimeltasi Suomi-kohtaisia asetuksia ellet ole määritellyt niitä itse erikseen.

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ä.

Lue tiedote Palveluväylän keskuspalvelimen päivittämisestä täältä.

Palveluntarjoajana voit käyttää minimiversion oletusarvoa X-road 7.2.X, tai määritellä itse vaatimasi minimiversion.

Palveluntarjoajana voit muuttaa asiakkaiden liityntäpalvelimilta vaatimaasi minimiversiota seuraavasti. Suomen X-road-version voi varmistaa tarkastamalla löytyykö seuraava konfiguraatiotiedosto liityntäpalvelimelta:

/etc/xroad/conf.d/override-securityserver-fi.ini

Mikäli konfiguraatiotiedosto löytyy, on käytössäsi X-roadin Suomi-versio. Jos tiedostoa ei löydy, on käytössäsi Vanilla-versio, jossa minimiversiota ei ole määritelty. Suomi-version ollessa käytössä ominaisuuden saa muutettua vaihtamalla arvon 7.2.0 haluttuun vaatimaasi versioon lisäämällä alla olevan rivin tiedoston /etc/xroad/conf.d/local.ini [proxy]-osioon:

server-min-supported-client-version=6.20.0

Yllä olevassa esimerkissä palveluntarjoajan liityntäpalvelimelta tietoja hakevalta liityntäpalvelimelta vaadittu vähimmäisversio on 6.20.0 versio, mutta palveluntarjoajana voit määritellä edellyttämäsi X-road-ohjelmiston version arvon vapaasti.

HUOM! Palveluntarjoajana vastuullasi on viestiä palveluitasi hyödyntäville organisaatioille mahdollisesti vaatimastasi minimiversiosta ja sen vaikutuksesta palvelusi käyttöön! Suomi.fi-palveluväylä suosittelee, että palveluntarjoajana edellytät ensin alhaisempaa minimiversiota kuin 7.2, jotta palveluasi hyödyntävä organisaatiot ovat varmasti tietoisia uudesta rajoitteesta ja ehtivät päivittää liityntäpalvelimensa. Palveluväylä kuitenkin suosittelee minimiversion asettamista kahta aiempaa versiota alemmaksi kuin mikä keskuspalvelimilla on käytössä.

Suomi.fi-palveluväylän keskuspalvelimet vaativat 22.5.2024 alkaen Palveluväylään käyttäviltä organisaatioilta vähintään X-road versiota 6.20.0. Siirryttäessä X-roadin 7.5-versioon (alustava aikataulu syksy 2024), edellyttävät keskuspalvelimet liityntäpalvelimilta vähintään X-road versiota 7.0.4.

X-roadin eri versiot ja niiden julkaisutiedotteet (englanniksi).Avautuu uuteen ikkunaan.