Integration SF Logning i de fælleskommunale IT systemer version 1.1 Integrationsbeskrivelse - version 2.0.0

Transkript

1 Integration SF Logning i de fælleskommunale IT systemer version 1.1 Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Version Kommentarer TBD 0.1 Første version JJN 0.7 Opdateret med SFTP og afklaringspunkter til de aktuelle logfiler MHO Referencerettelser mm EHE Teknisk beskrivelse indarbejdet Referencer Ref Titel Kommentarer [SPref] Relevans Dato Initialer [SIKKER- HED] [STS-Sikkerhed] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v [SFTP] <Indsæt dokumentation af SFTP> Endnu ikke udarbejdet Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link [STS- Logning] [ÆØ- LOG- NING ] Integrationsvilkår Bilag 2. Logning version 1.3 KOMBIT A/S Halfdansgade København S CVR Side 2 af 16

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning af services Kontekst for integrationsparter Kontekst for KY (Kontanthjælp) /KSD (Sygedagpenge) /SAPA (Sagsoverblik og partkontakt) Specifikation for integrationsparter Specifikation af endpoints for KY /KSD /SAPA Teststrategi Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 16

4 1 Overordnet beskrivelse 1.1 Integrationens formål Formålet med snitfladen er at kunne sammenholde logfiler på tværs af systemer. Dette er med udgangspunkt i, at de fælleskommunale it-systemer er underlagt ens krav til logning, der således skal foregå centralt. Til udbud af de fleste systemer der indgår i monopolbruddet er der vedlagt underbilag 2.5 Konkrete Integrationer som beskriver hvordan logning skal forgå og underbilag 2.4 der beskriver hvad der skal logges. Overordnet set er logning delt i logningstyperne systemlog, revisionslog, afregningslog, verifikationslog, driftslog samt transaktionslog, og i første omgang er det kun revisions- og transaktionslog, som skal overføres serviceplatformen. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Fagsystemet uploader logfil samt en triggerfil, der beskriver placering af logfil. Serviceplatformen modtager upload af logfil på SFTP-serveren og persisterer data i den pågældende log folder på baggrund af triggerfil. SF Logning via Serviceplatformens sftp-server Serviceplatform Fagsystem Send logfil og metadata SFTP PUT*2 Persistering Logfil placeres i log folder baseret på metadata Persistering SFTP GET*2 SFTP DELETE*2 KOMBIT A/S Halfdansgade København S CVR Side 4 af 16

5 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Flow 1 Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen. Der er pt. ingen yderligere krav, i forhold til den gældende aftale for Serviceplatformen Service Management Incident Management Problem Management Change Management Lifecycle Management 1.4 Teststrategi Test i forbindelse med udvikling Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] KOMBIT A/S Halfdansgade København S CVR Side 5 af 16

6 Testfaciliteter og testmiljø Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unittests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Test i forbindelse med produktionssætning I forbindelse med produktionssætning er det omfattet af gældende aftale med Systematic, at der gennemføres følgende 3 prøver: Overtagelsesprøve Idriftsættelsesprøve Driftsprøve Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.5 Tilslutning af services Funktionalitet på Serviceplatformen Forudsætningen for at kunne integrere via SFTP løsningen på Serviceplatformen er at integrationspartnerne skal være oprettet som bruger på Serviceplatformen, og systemet skal være registreret med et certifikat. Simpel SFTP skal vælges for hver af systemerne og der skal angives SFTP bruger og public nøgle. For yderligere information vedrørende anvendelse, se Vejledning til Serviceplatformens SFTP Service, som er tilgængelig på serviceplatformens informationssider Generelle forhold for tilslutning til integrationspart: KY, KSD og SAPA Leverandøren skal være oprettet som tilslutningspart i rammearkitekturens administrationsmodul, og leverandøren skal oprette en tilslutningsaftale for it-systemet i administrationsmodulet. Leverandøren skal tiltræde, og overholde, vilkårene i den til enhver tid gældende aftale for tilslutning af itsystemer til den fælleskommunale rammearkitektur. Leverandøren af It-systemet er ansvarlige for at It-systemet tilsluttes via rammearkitekturens administrationsmodul, med den, eller de, systemtyper (brugervendt system, anvendersystem og/eller serviceudbyder), der er relevante for It-systemet jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. KOMBIT A/S Halfdansgade København S CVR Side 6 af 16

7 Leverandøren skal sikre, at tilslutningsaftalen for it-systemet indeholder tilvalg af SFTP [SFTP]. [Afklaring/KDF: Tilføj yderligere dokumentation med vejledning i brug af sikkerhedsmodellen, herunder brug af Security Token Servicen, støttesystemer, mv. i Rammearkitekturen, når denne modtages fra STS] 2 Kontekst for integrationsparter 2.1 Kontekst for KY (Kontanthjælp) /KSD (Sygedagpenge) /SAPA (Sagsoverblik og partkontakt) Lovhjemmel og forvaltningsmæssigt formål Det lovmæssige og forvaltningsmæssige formål er beskrevet i [STS-Logning] Systemet skal understøtte overholdelse af gældende præceptiv dansk lovgivning, herunder blandt andet: Lov om behandling af personoplysninger (Persondataloven) Lov nr. 429 af med ændringer, herunder ved lov nr. 280 af (Justits-ministeriet/Datatilsynet), og Lov nr. 639 af (Justitsministeriet). Bekendtgørelse nr. 528 af 15. juni 2000 som ændret ved Bekendtgørelse nr. 201 af 22. marts 2001 om sikkerhedsforanstaltninger til beskyttelse af personoplysninger, som behandles for den offentlige forvaltning (Sikker-hedsbekendt gørelsen). Systemet skal understøtte overholdelse af deklaratoriske regler, herunder blandt andet: - Retningslinjer for sikkerhed, som specificeret i ISO27001 eller tilsvarende Det anførte hjemmelsgrundlag er bestemt af det enkelte og relevante fagprojekt i KOMBIT på bestillingstidspunktet. Det er fastsat på baggrund af en rimelig og dækkende analyse. Henvisningen til hjemmelsgrundlaget bliver ikke vedligeholdt, hvorfor KOMBIT naturligvis ikke kan indestå for, at denne henvisnings indhold og retsvirkning til alle tider vil være korrekt. KOMBIT skal derfor understrege, at læseren af dette dokument udelukkende skal læse hjemmelsgrundlaget som en orientering Kapacitets- og servicekrav Det påregnes at volumen udvikler sig som følger på figur. KOMBIT A/S Halfdansgade København S CVR Side 7 af 16

8 y-aksen er gennemsnitlig antal MB der skal flyttes til logningskomponenten pr. dag Specifikke forhold for tilslutning af system De systemer der skal overføre logs til serviceplatformen, skal have oprette en SFTP bruger til use case 01 på serviceplatformen [SFTP]. KOMBIT A/S Halfdansgade København S CVR Side 8 af 16

9 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY /KSD /SAPA Integrationen benyttes af fag og støttesystemet til at levere en logfil til Serviceplatformens. Fag og støttesystem benytter den specifikke SFTP bruger på serviceplatformen, som er oprettet til denne Overordnet forretningslogik Fagsystemet leverer logfil samt triggerfil via Serviceplatformens SFTP-server [SFTP]. Endpoint EP_FS1 repræsenterer PUT på Serviceplatformens SFTP-server [SFTP] Oversigt over endpoints ID Navn EP_FS1 log_put Beskrivelse af endpoint EP_FS1 - log_put Transportspecifikation Integrationsmønster Serviceplatformen udstiller Simpel SFTP, hvor operationen PUT anvendes Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Fagsystemet er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som PUT på Serviceplatformens SFTP-server. Der skal altid leveres to filer; en fil med data og en fil med routing information Teknisk endpoint Upload af logfil foretages via det tekniske endpoint: Miljø: Test SFTP platform: Host IP SFTP bruger: Serviceplatformen KY KSD SAPA [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - SP_SIMPELSFTP_LOG [Afklaring/KDF oplysninger leveres af KY] - KY_ SIMPELSFTP [Afklaring/KDF oplysninger leveres af KSD] - KSD_ SIMPELSFTP [Afklaring/KDF oplysninger leveres af SAPA] - SAPA_ SIMPELSFTP KOMBIT A/S Halfdansgade København S CVR Side 9 af 16

10 Miljø: Produktion SFTP platform: Host IP SFTP bruger: Serviceplatformen KY KSD SAPA [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - SP_SIMPELSFTP_LOG [Afklaring/KDF oplysninger leveres af KY] - KY_ SIMPELSFTP [Afklaring/KDF oplysninger leveres af KSD] - KSD_ SIMPELSFTP [Afklaring/KDF oplysninger leveres af SAPA] - SAPA_ SIMPELSFTP Teknisk retning for udveksling Fagsystemet kalder SFTP-service på Serviceplatformen for at overføre filerne Dataretning for udveksling Fagsystemet kalder SFTP-service på Serviceplatformen for at overføre filerne Service invokation / Triggers Kommunikation initieres af fagsystemet med et interval, der på nuværende tidspunkt ikke er fastlagt Dataspecifikation SFTP Triggerfil Ved overførelse af logs via SFTP skal der udformes en triggerfil, som skal ledsage en logfil. Triggerfilen kan navngives frit, dog skal den have extension.trigger Der er ikke noget krav til at filnavnet skal være unikt, men i tilfælde af at en triggerfil med samme navn allerede eksistere i den folder, der ønskes at flyttes til, vil flytningen fejle indtil den blokkerede fil er blevet behandlet. Triggerfilen er XML baseret og skal indeholde information om forsendelsen, som vist nedenfor: Element Kardinalitet Forklaring Eksempel på værdi (Anvendt/ mulig) FileContentDescriptorType 1/1 Complex element N/A - (Any) 1/(0..*) Angiver typen af logfilen, og kan være: - systemlog - revisionslog - afregningslog - verifikationslog - driftslog - transaktionslog <FilType> LogType </FilType> <SF>1635</SF> LogType udskiftes med den faktiske lognavn fra kolonnen forklaring, KOMBIT A/S Halfdansgade København S CVR Side 10 af 16

11 Routinginformation 1/1 Complex element N/A - FileName 1/1 Der er ingen krav til navngivning af datafile, men det er dog hensigtsmæssig at den i en hvis grad er unik af hensyn til sporbarhed. Dog må den ikke have extension.trigger. Systemlog0024.csv [Afklaring/Serviceplatformen: Der er ikke taget beslutning om navngivning af logfiler] - SizeInBytes 1/1 Størrelsen af datafil i bytes - Sender 1/1 SFTP brugeren f.eks. KY, SAPA, KSD KY_ SIMPELSFTP [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] - SendersFileId 1/0..* Der er valgfrit for afsendelsessystem om der medgives ID-er, der kan identificere filen. Kunne være UUID Der bør angives en unik identifikation, som gør filen sportbar. Dette er en string, som ikke er defineret med en begrænsning. [Afklaring/SP: Antal og længde af streng er ikke identificeret] - Recipients 1/(1..*) SFTP brugeren f.eks. Serviceplatform SP_ SIMPELSFTP _LOG KOMBIT A/S Halfdansgade København S CVR Side 11 af 16

12 [Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] Formatering af logfiler [Afklaring/Serviceplatformen: Format og parameter mv. for de aktuelle logs er ikke fastlagt i detaljer, og kan derfor ikke beskrives pt.] [Afklaring/Serviceplatformen: Det er endnu ikke beslutte om der vil være en samlet logfil, der indeholder alle typer logstatements, eller om der vil være en separat file per type log-statement] Sikkerhed Brug Use case UC-SEC-07: Intern SFTP server for sikkerhedsmønster. Se dokumentet [SIKKERHED] Leverancesikkerhed og fejlhåndtering Der er pt. ingen yderligere krav, forhold til Simpel SFTP. Det skal dog gentages, at det er afsendersystemets ansvar at rydde op i den tildelte folderstruktur. Umiddelbart er der to fejlscenarier der skal ryddes op efter i afsendelsessituationen: Der placeres en datafil uden at der efterfølgende placeres en triggerfil. Der placeres en datafil og en triggerfil med fejl f.eks. forkert xml format eller modtagersystem findes ikke. Afsendersystem modtager en teknisk fejl fra SFTP, og skal selv slette datafilen. Serviceplatformen rydder dagligt op på SFTP serveren ved at slette filer der har ligget umodificeret på SFTP serveren i 30 dage. Inden en fil slettes vil der 10 dage før blive udsendt en mail til anvendersystemet om at filen vil blive slettet om 10 dage Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Værdi Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. KOMBIT A/S Halfdansgade København S CVR Side 12 af 16

13 Servicevinduer Ved mindre opdateringer for Serviceplatformen: En gang om ugen i tidsrummet 05:00-06:00. Varsling: 1. uge, varighed (naturligvis) max en time. Ved større og kritiske opdateringer: Optil 1 gang om måneden i tidsrummet mandag kl. 03:00 til mandag kl. 06:00. Varsling: 1. uge, Varighed: max 3 timer Ved omlægning af miljøer, arkitektur og services for Serviceplatformen: 1 gang pr. kvartal i tidrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer [SPref] Service Management Incident Management Problem Management Change Management Lifecycle Management 3.2 Teststrategi Test i forbindelse med udvikling Testfaciliteter og testmiljø Testdata Test i forbindelse med produktionssætning KOMBIT A/S Halfdansgade København S CVR Side 13 af 16

14 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. En integration kan understøttes af flere integrationsflow, som vil være beskrevet hver for sig i nærværende afsnit. I hvert integrationsflow vil der indgå en række endpoints. Hvert endpoint vil være specificeret i integrationsbeskrivelserne for integrationsparterne, jf. ovenstående afsnit 3. Jf. figuren nedenfor indgår følgende komponenter og endpoints i integrationen. KY, KSD, SAPA EP_FS1 Serviceplatformen IF01 Logfil via SFTP Dataretning Oversigt over integrationsflows ID Navn IF01 Logfil via SFTP Integrationsflow IF01: Logfil via SFTP Anvendte service endpoints Endpoint ID Navn på endpoint Dokumentreference EP_FS1 Logfil_PUT Afsnit Integrationstype Integrationen er en filtransport, hvor KY, KSD og SAPA uploader logfiler med tilhørende routingfil til Serviceplatformens SFTP-server Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade København S CVR Side 14 af 16

15 Fag- og støttesystemer Serviceplatform Afsend logfil Afsend routing fil EP_FS1(PUT datafil) EP_FS1(PUT triggerfil) (Hent og slet triggerfil) (Hent og slet datafil) Hver Logfil overføres individuelt. Først overføres datafilen og herefter triggerfil, herefter behandler SFTP serveren på Serviceplatformen og overføre dem til modtageren Datatransformering Ingen krav Datapersistering Der er pt. ingen yderligere krav i forhold til [SFTP] Databerigelse Ingen krav Routing Serviceplatformen skal for EP_FS1 håndtere kommunikation med SFTP serveren i overensstemmelse med den simple SFTP [SFTP]. Det betyder at serviceplatformen skal betragtes, som modtagersystem, og implementere håndtering af SFTP bruger med tilhørende folderstruktur. Miljø: Test SFTP platform: Host IP SFTP bruger: Serviceplatformen KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - SP_SIMPELSFTP_LOG [Afklaring/KDF oplysninger leveres af KY] - KY_ SIMPELSFTP [Afklaring/KDF oplysninger leveres af KSD] - KSD_ SIMPELSFTP Miljø: Produktion KOMBIT A/S Halfdansgade København S CVR Side 15 af 16

16 SFTP platform: Host IP SFTP bruger: Serviceplatformen KY KSD [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] [Afklaring/KDF oplysninger leveres af Systematic] - SP_ SIMPELSFTP _LOG [Afklaring/KDF oplysninger leveres af KY] - KY_ SIMPELSFTP [Afklaring/KDF oplysninger leveres af KSD] - KSD_ SIMPELSFTP Orkestrering Ingen krav Sikkerhed Sikkerhed mellem fagsystemet og Serviceplatformen er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed]. Logning via SFTP er intern service som benytter Sikkerhedsmodel UC-SEC-07 [SIKKERHED] Logning Der er pt. ingen yderligere krav i forhold til [SFTP] Testdata og testfaciliter Konfiguration Ingen krav Supplerende information Ingen supplerende information. KOMBIT A/S Halfdansgade København S CVR Side 16 af 16