Gå direkt till innehållet.
Suomi.fi-informationsled

1. Bekanta och planera

Efter detta avsnitt har du

  • bekantat dig med Informationsledens materialer
  • bekantat dig med Informationsledens och API-katalogens miljöer
  • kommit överens med de tekniska och administrativa kontaktpersoner
  • funderat på lösningen för anslutningsserver
  • valt den tekniska utgångspunkten för dina tjänster (SOAP eller REST)
  • bekantat dig med genomförandet av adaptertjänst

Bekanta och planera

Med hjälp av detta avsnitt kommer du igång med ibruktagningen. Om du vill kan du också lägga ut ibruktagningsprocessen av Informationsleden. Läs mer om utläggning av ibruktagningsprocess.

Längden på ibruktagningen

Vanligtvis tar Informationsledens ibruktagningsprocess cirka 1-3 månader, men längden på prosecessen kan vara också kortare. Själva installationsprocessen är i sig inte särskilt lång, speciellt om processen redan är bekant. Om en organisation ansluter sig till Informationsleden endast som utnyttjare eller om organisationen redan har en anslutningsserver ansluten till Informationsleden, är ibruktagningsprocessen snabbare. Det är bra att reservera några veckor för öppning av brandväggar och beviljande av certifikat.

Planering av ibruktagningen

Planera ibruktagningen noggrant så att den lyckas så smidigt som möjligt. Kom ihåg att din organisations behov och resurser påverkar processen, och det är bra att beakta dem redan i planeringsskedet. Planering av ibruktagning delas in i administrativ och teknisk planering. Observera att trots detta måste planeringen göras i tätt samarbete med alla personer och organ som deltar i ibruktagningsprocessen. Skeden som ingår i planering av den administrativa ibruktagningsprocessen hittar du från en annan sida.

I detta avsnitt presenteras följande faser som ingår till ibruktagningens planering:

  1. Bekanta dig med Informationsledens materialer
  2. Bekanta dig med Informationsledens och API-katalogens miljöer
  3. Kom överens om kontaktpersoner
  4. Bekanta dig med lösningar för anslutningsserver
  5. Planera den tekniska utgångspunkten av dina tjänster: SOAP eller REST
  6. Planera en eventuell adaptertjänst

1. Bekanta dig med Informationsledens materialer

Innan anslutning till Informationsleden bekanta dig åtminstone med följande material:

Mer information hittar du på följande:

2. Informationsledens och API-katalogens miljöer

Informationsledens miljöer

Suomi.fi-informationsleden fungerar i tre olika miljöer:

  • Utvecklingsmiljön (FI-DEV): I utvecklingsmiljön används påhittade organisationer och data. Du kan pröva på Informationsleden utan skyldighet att ansluta dig till test- eller produktionsmiljön. Även privatpersoner kan ansluta sig till utvecklingsmiljön. Om du vill ansluta dig till Informationsledens utvecklingsmiljö som privatperson får du från Informationsledens stöd den anslutningsinformation som behövs för utvecklingsmiljön. I utvecklingsmiljön används certifikat som tillhör den operatör som upprätthåller miljön. Certifikaten kan skaffas per e-post. Du får certifikaten genom att skicka en fritt formulerad ansökan till adressen palveluvayla@palveluvayla.fiÖppnas i ett nytt fönster.. Du kan läsa mer om utvecklingsmiljön här och denna stödartikel hjälper dig att ansluta till utvecklingsmiljön.
  • Testmiljön (FI-TEST): Du måste alltid ansluta dig till testmiljön innan du ansluter dig till produktionsmiljön. Testmiljön motsvarar produktionsmiljön i funktionerna och därför kan du pröva på Informationsleden och hur man ansluter sig till den i testmiljön. Finländska organisationer med FO-nummer eller organisationer som inte är skyldiga att registrera enligt finsk lagstiftning, till exempel privata företag, eller som inte får ett finskt FO-nummer, till exempel stiftelser kan ansluta sig till testmiljön. Villkoren för anslutningen beskrivs närmare i Informationsledens användarvillkor. I testmiljön används riktiga organisationer men påhittad data
  • Produktionsmiljön (FI): Produktionsmiljön är Informationsledens officiella verksamhetsmiljö. Du måste ansluta dig till testmiljön innan du övergår till produktionsmiljön. I produktionsmiljön följs det samma villkor för anslutningen som i testmiljön. I produktionsmiljön används riktiga organisationer och riktig data.

Informationsledens miljöer

Observera också att du behöver separata anslutningsservrar för alla miljöer. Med hjälp av en separat stödartikel kan du bekanta dig med installation av program för anslutningsserver när du ansluter dig till utvecklingsmiljön.

API-katalogens miljöer

API-katalogen presenterar de organisationer som finns i Informationsledens produktionsmiljö och de tjänster som de tillhandahåller. Respektive, Test-API-katalogen presenterar alla organisationer i testmiljön och de tjänster som de tillhandahåller.

När du anlsuter dig till Informationsledens testmiljö, beskriv din organisations uppgifter och tjänster i Test-API-katalogen. När du övergår till Informationsledens produktionsmiljö, beskriv din organisations uppgifter och tjänster i API-katalogen.

API-katalogens miljöer.
Läs mer om Informationsledens och API-katalogens miljöer.

3. Kom överens om kontaktpersoner

Kom överens om kontaktpersoner för ibruktagningen tillsammans med den personen som ansvarar för den administrativa ibruktagningsprocessen redan innan den riktiga ibruktagningen av Suomi.fi-informationsleden. Den administrativa och tekniska kontaktpersonen kan vara samma person. I din organisation, välj en:

  • Administrativ kontaktperson
  • Administrativ reservkontaktperson
  • Teknisk kontaktperson
  • Teknisk reservkontaktperson

Administrativa kontaktpersoner kan till exempel vara projekt- eller datahanteringschefer. Det är bra om den administrativa kontaktpersonen har namnskrivningsrätt i organisationen. Den administrativa kontaktpersonen ansvarar vanligtvis för till exempel den allmänna koordinationen av ibruktagningsprocessen, ansökningar om användningstillstånd och resursfördelning.

Tekniska kontaktpersoner kan till exempel vara sådana personer som ansvarar för underhållet av din organisations informationssystem. Den tekniska kontaktpersonen ansvarar till exempel för installations-, konfigurerings- och underhållsuppgifter relaterade till anslutningsservern.

Vi rekommenderar att tekniska kontaktpersoner är sådana personer som ansvarar för underhållet av informationssystemen i din organisation. Det är bra om personerna som deltar i den tekniska planeringen och ibruktagningens tekniska genomförande har grundläggande kunskaper i Ubuntu- eller RHEL-operativsystem, så att installationen av programmet för anslutningsservern sker utan problem. Om din organisation ska använda en containrad anslutningsserver borde personen vara bekant med Docker-teknologi.

Roll av anmälda kontaktpersoner

Observera att du behöver namnen och kontaktuppgifter för kontaktpersonerna och reservkontaktpersonerna för ansökan om Informationsledens användningstillstånd.

Begäran om ändring av systemet (t.ex. lägga till ett subsystem, portöppningar av brandväggar) måste göras via kontaktpersonerna som anges i ansökan om Informationsledens användningstillstånd. Att göra begäran om ändringen kan överföras till tredje parten och den ansvariga kontaktpersonen måste anmäla det till Informationsledens underhåll.

4. Bekanta dig med lösningen för anslutningsserver

Innan du inleder ibruktagningen av Informationsleden måste din organisation ha en server med vilken man ansluter sig till Informationsleden, dvs. en anslutningsserver. Fundera i planeringsskedet vilken lösning som passar din organisation bäst:

  • Användning av en egen anslutningsserver: I detta alternativ installerar din organisation programmet för anslutningsserver själv, och sköter själv om underhållet av anslutningsservern.
  • Köp av lösning för anslutningsserver från en utomstående tjänsteleverantör: I detta alternativ lägger din organisation ut installationen av programmet för anslutningsserver och underhållsarbeten relaterade till anslutningsservern till någon utomstående tjänsteleverantör.
  • Användning av en annan organisations anslutningsserver: I detta alternativ kommer ni överens med en organisation som är ansluten till Informationsleden att ni använder samma anslutningsserver, istället för att din organisation skulle installera en egen server.

Om din organisation implementerar anslutningsservern själv, måste din organisation välja:

  • Anslutningsserverns tekniska genomförandesätt: Din organisations måste väljä antingen RHEL- eller Ubuntu-anlsutningsserver eller containrad anslutningsserver.
  • Anslutningsserverns driftsmiljö: Din organisation måste välja mellan en molnmiljö och maskinsal.

I följande skedet berättar vi mer om lösningar för anslutningsservrar.

5. Planera den tekniska utgångspunkten av dina tjänster: SOAP eller REST

Tjänstelösningar som tillhandahålls via Informationsleden kan grunda sig antingen på dataöverföring enligt SOAP-protokollet eller på en REST-arkitekturmodell som är oberoende av informationens framställningsform. Innan anslutning till Informationsleden fundera om din organisation kommer att använda SOAP- eller REST-gränssnitt för att förmedla data. Det är möjligt att använda båda. Gränssnittets form påverkar lite i ibruktagningsprocessens gång.

  • SOAP (Simple Object Access Protocol) är ett telekommunikationsprogram som baserar sig på XML-språket. SOAP arbetar över flera olika protokoll, men i Informationsleden används den endast över HTTP-protokollet. SOAP är informationssäker, men en lösning som är tyngre än REST-modellen.
  • REST (Representational State Transfer) är en arkitekturmodell för programmeringsgränssnitt som grundar sig på ett HTTP-protokoll. REST begränsar inte den tekniken som används i gränssnitten eller informationens framställningsform. I den vanligaste formen för framställning av information som används i REST-applikationer är för närvarande JavaScript Object Notation (JSON), men även andra formers REST-applikationer kan läggas till i Informationsleden. REST är en enklare lösning än SOAP, eftersom den inte är så strikt standardiserad.

När det kommer till anslutning till Informationsleden är den största skillnaden mellan SOAP- och REST-tjänsterna den att SOAP-tjänsterna i regel behöver en separat adaptertjänst medan REST-tjänsterna inte. Mer information om implementering och planering av adaptertjänsten finns senare i detta avsnitt.

6. Planera en eventuell adaptertjänst

Adaptertjänsten är en komponent som ligger mellan anslutningsservern och informationssystemet, och som anpassar tjänsterna i din organisations system till ett format som är enhetligt med X-Road-dataöverföringsprotokollet som används i Informationsleden. Observera att du inte behöver en adaptertjänst när:

  • SOAP-tjänsten har planerats och genomförts specifikt för Informationsleden, och enligt de krav som Informationsleden har ställts.
  • Din organisation använder REST-gränssnitt för dataöverföring.

Om din organisation använder befintliga SOAP-gränssnitt för att tillhandahålla data via Informationsleden är adaptertjänsten nödvändig. Ibruktagningen av Informationsleden förutsätter att det datasystem som ska anslutas kan skicka och ta emot SOAP-meddelanden i den form som krävs av X-Road-dataöverföringsprotokollet som Informationsleden använder. I SOAP-meddelandena ingår vissa rubrikuppgifter som fastställs av dataöverföringsprotokollet. Dessutom ska förfrågnings- och svarsparametrar inkluderas i SOAP-meddelandets body-del på det sätt som fastställts i protokollet.

Adaptertjänsten är ingen färdig komponent som följer med programvaran för anslutningsservern utan ska skapas separat för varje system som kopplas till informationsleden. Det är alltså din organisation som ansvarar för planeringen och genomförandet av adaptertjänsten. Adaptertjänsten kan genomföras:

  • Antingen i ett system som ansluts direkt eller
  • I en separat adaptertjänst som ligger mellan systemet och anslutningsservern.

Bekanta dig närmare med adaptertjänsten.


Fortsätt till nästa skede

Uppdaterad: 10.10.2024

Är du nöjd med innehållet på denna sida?