Tekninen yleiskuvaus
Suomi.fi-verkkopalvelun Rekisterit-osion tekninen yleiskuvaus
Suomi.fi-verkkopalvelun Rekisterit-osio tuo Suomi.fi-palveluväylän kautta loppukäyttäjän näkyville henkilökohtaisia tai yritystietoja useista eri palveluun liitetyistä tietovarannoista. Rekisterin liittäminen Verkkopalveluun edellyttää Suomi.fi-palveluväylän käyttöönottoa ja SOAP- tai REST-liitynnän luomista liitettävään tietovarantoon. Tutustu tarkemmin Palveluväylään ja sen käyttöönottoon sivulla Suomi.fi-palveluväylä.
Suomi.fi-verkkopalvelussa näytettävät tiedot ovat kooste keskeisistä tiedoista, jotka asiakasorganisaatio on valinnut rekistereistään. Tietoja ei tallenneta eikä näytetä muille kuin asianomaiselle loppukäyttäjälle. Verkkopalvelu kutsuu liitettyä palvelua lähettämällä sanomakutsun, joka sisältää tunnistautuneen henkilön henkilötunnuksen sekä halutun kieliversion (suomi, ruotsi tai englanti). Kutsu lähtee Verkkopalvelusta, kun loppukäyttäjä on Omat tiedot -osiossa valinnut, mitä rekisteritietoja hän haluaa tarkastella. Liitetyn palvelun tulee tällöin palauttaa sanoma, joka sisältää kaikki näytettävät tiedot halutulla kielellä. Tutustu tarkemmin SOAP/XML-sanoman muodostamiseen Rajapintakyselyt rekistereissä-sivulla.
Rekisterien tietoliikenne kulkee Suomi.fi-palveluväylässä, jonka liikenne on julkisen internetin yli tapahtuvaa liityntäpalvelinten välistä liikennettä. Tiedot salataan tiedonsiirron ajaksi TLS (SSL) -salausprotokollalla, ja kaikki tieto allekirjoitetaan varmenteilla. X-Road-ratkaisun liityntäpalvelinten rajapintatoteutuksessa käytetään XML-kieleen pohjautuvaa SOAP (Simple Object Access Protocol) -tietoliikenneprotokollaa. Myös REST-arkkitehtuurin käyttö on mahdollista, mutta kysy REST-mahdollisuudesta Digi- ja väestötietovirastolta ennen käyttöönoton tarkempaa suunnittelua.
SOAP-toteutuksissa tietojen näyttäminen Verkkopalvelussa tapahtuu muuntamalla SOAP/XML-sanoma JSON-muotoon ja poimimalla sieltä näytettävät kentät Handlebars-templaten avulla. Tietojen näyttämiseen käytetään Verkkopalvelun esitysmallia. Liittyjän on toimitettava tietomallin lisäksi tarvittavat tukilinkit ja ohjeistukset sekä palvelun kuvake. Tutustu tarkemmin Verkkopalveluun tuotavan rekisterin kuvailutietoihin sivulta Rekisterin kuvailutiedot.
Liitynnän testaus edellyttää asiakkaalta omaa testiympäristöä ja testiaineistoa sekä liityntää testiympäristöön. Digi- ja väestötietovirasto tekee testihaut asiakkaan testiympäristöön. Lopullinen hyväksymistestaus tuotantoympäristössä tehdään yhteistyössä liittyjän ja Digi- ja väestötietoviraston kanssa ja hyväksynnän jälkeen liitetyn palvelun nosto näkyy Suomi.fi-verkkopalvelun rekisterit-osiossa.