Teknisk översikt
Teknisk översikt av avsnittet Register i Suomi.fi-webbtjänsten
Avsnittet Register i Suomi.fi-webbtjänsten visar personliga uppgifter eller företagsuppgifter om flera olika tjänster för slutanvändaren via Suomi.fi-informationsleden. För att ansluta registret till webbtjänsten krävs ibruktagande av Suomi.fi-informationsleden och att en SOAP- eller REST-anslutning skapas i det datalager som ansluts. Bekanta dig närmare med Informationsleden och hur det tas i bruk.
De uppgifter som visas i Suomi.fi-webbtjänsten är en sammanställning av de centrala uppgifterna som kundorganisationen har valt i sina register. Uppgifterna sparas inte och visas inte för andra än den behöriga slutanvändaren. Den anslutna tjänsten anropas av webbtjänsten som skickar en inbjudan som innehåller den identifierade personens personbeteckning samt önskad språkversion (finska, svenska eller engelska). Inbjudan skickas från webbtjänsten när slutanvändaren i avsnittet Mina uppgifter har valt vilka registeruppgifter hen vill granska. Den anslutna tjänsten ska då returnera ett meddelande som innehåller all information som ska visas på önskat språk. Bekanta dig närmare med hur du skapar ett SOAP/XML-meddelande på sidan Gränssnittsförfrågningar i registren.
Registrens datatrafik går via Suomi.fi-informationsleden, vars trafik är trafik mellan anslutningsservrarna som sker via offentligt internet. Uppgifterna krypteras under dataöverföringen med krypteringsprotokollet TLS (SSL) och all information undertecknas med certifikat. I gränssnittsrealiseringen av X-Road-lösningens anslutningsserver används datatrafikprotokollet SOAP (Simple Object Access Protocol) som baserar sig på XML-språket. Det är också möjligt att använda REST-arkitekturen, men fråga Myndigheten för digitalisering och befolkningsdata om REST-möjligheten innan ibruktagandet planeras närmare.
I SOAP-genomföranden visas uppgifterna i webbtjänsten genom att SOAP/XML-meddelandet omvandlas till JSON-format och de fält som visas där plockas ut med en Handlebars-template. För att visa uppgifterna används Presentationsmodellen för webbtjänsten. Utöver datamodellen ska den som ansluter sig lämna in nödvändiga stödlänkar och anvisningar samt en ikon för tjänsten. Bekanta dig närmare med beskrivningen av registret som importeras till webbtjänsten på sidan Registrets beskrivningsuppgifter.
Testningen av anslutningen förutsätter att kunden har en egen testmiljö och eget testmaterial samt en anslutning till testmiljön. Myndigheten för digitalisering och befolkningsdata gör testsökningar i kundens testmiljö. Den slutliga godkännandetestningen i produktionsmiljön görs tillsammans med den som ansluter sig och Myndigheten för digitalisering och befolkningsdata. Efter godkännandet syns lyftet av den anslutna tjänsten i avsnittet Register i Suomi.fi-webbtjänsten.