Integration SF1612 - Logning i de fælleskommunale IT systemer version 1.1 Integrationsbeskrivelse - version 2.0.0 Kommunernes Datafællesskab - KDF
Versionshistorik Version Kommentarer 2015-01-23 TBD 0.1 Første version 2015-05-28 JJN 0.7 Opdateret med SFTP og afklaringspunkter til de aktuelle logfiler 2015-07-01 MHO 0.7.1 Referencerettelser mm. 2015-07-01 EHE 2.0.0 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: https://share-komm.kombit.dk/p089/referencedokumenter Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v.0.4.3 [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 https://share-komm.kombit.dk/p024/delte%20dokumenter/forms/integrationsvilkr.aspx [STS- Logning] [ÆØ- LOG- NING ] Integrationsvilkår Bilag 2. Logning version 1.3 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 2 af 16
Indholdsfortegnelse 1 Overordnet beskrivelse... 4 1.1 Integrationens formål... 4 1.2 Overordnet forretningsflow i integrationen... 4 1.3 Servicebetingelser for den samlede integration... 5 1.4 Teststrategi... 5 1.5 Tilslutning af services... 6 2 Kontekst for integrationsparter... 7 2.1 Kontekst for KY (Kontanthjælp) /KSD (Sygedagpenge) /SAPA (Sagsoverblik og partkontakt)... 7 3 Specifikation for integrationsparter... 9 3.1 Specifikation af endpoints for KY /KSD /SAPA... 9 3.2 Teststrategi... 13 4 Beskrivelse for integrationsplatforme... 14 4.1 Beskrivelse for Serviceplatformen... 14 KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 3 af 16
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. SF1635 - 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 4 af 16
1.3 Servicebetingelser for den samlede integration 1.3.1 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. 1.3.2 Service Management 1.3.2.1 Incident Management 1.3.2.2 Problem Management 1.3.2.3 Change Management 1.3.3 Lifecycle Management 1.4 Teststrategi 1.4.1 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 5 af 16
1.4.1.1 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] 1.4.1.2 Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 1.4.2 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 1.5.1 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. 1.5.2 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 6 af 16
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) 2.1.1 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 31.5.2000 med ændringer, herunder ved lov nr. 280 af 25.4.2001 (Justits-ministeriet/Datatilsynet), og Lov nr. 639 af 12.6.2013 (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. 2.1.2 Kapacitets- og servicekrav Det påregnes at volumen udvikler sig som følger på figur. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 7 af 16
35000 30000 25000 20000 15000 10000 5000 0 y-aksen er gennemsnitlig antal MB der skal flyttes til logningskomponenten pr. dag.. 2.1.3 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 8 af 16
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. 3.1.1 Overordnet forretningslogik Fagsystemet leverer logfil samt triggerfil via Serviceplatformens SFTP-server [SFTP]. Endpoint EP_FS1 repræsenterer PUT på Serviceplatformens SFTP-server [SFTP]. 3.1.2 Oversigt over endpoints ID Navn EP_FS1 log_put 3.1.3 Beskrivelse af endpoint EP_FS1 - log_put 3.1.3.1 Transportspecifikation 3.1.3.1.1 Integrationsmønster Serviceplatformen udstiller Simpel SFTP, hvor operationen PUT anvendes. 3.1.3.1.2 Serviceudstiller Serviceplatform er serviceudstiller. 3.1.3.1.3 Serviceanvender Fagsystemet er serviceanvender. 3.1.3.1.4 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. 3.1.3.1.5 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 9 af 16
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 3.1.3.1.6 Teknisk retning for udveksling Fagsystemet kalder SFTP-service på Serviceplatformen for at overføre filerne. 3.1.3.1.7 Dataretning for udveksling Fagsystemet kalder SFTP-service på Serviceplatformen for at overføre filerne. 3.1.3.1.8 Service invokation / Triggers Kommunikation initieres af fagsystemet med et interval, der på nuværende tidspunkt ikke er fastlagt. 3.1.3.2 Dataspecifikation 3.1.3.2.1 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 10 af 16
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. 154645 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 11 af 16
[Afklaring/SP: SFTP brugeren bestemmes i forbindelse med ibrugtagning.] 3.1.3.2.2 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] 3.1.3.3 Sikkerhed Brug Use case UC-SEC-07: Intern SFTP server for sikkerhedsmønster. Se dokumentet [SIKKERHED] 3.1.3.4 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 3.1.3.5 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. 3.1.3.5.1 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 12 af 16
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]. 3.1.4 Service Management 3.1.4.1 Incident Management 3.1.4.2 Problem Management 3.1.4.3 Change Management 3.1.5 Lifecycle Management 3.2 Teststrategi 3.2.1 Test i forbindelse med udvikling 3.2.1.1 Testfaciliteter og testmiljø 3.2.1.2 Testdata 3.2.2 Test i forbindelse med produktionssætning KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 13 af 16
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 4.1.1 Oversigt over integrationsflows ID Navn IF01 Logfil via SFTP 4.1.2 Integrationsflow IF01: Logfil via SFTP 4.1.2.1 Anvendte service endpoints Endpoint ID Navn på endpoint Dokumentreference EP_FS1 Logfil_PUT Afsnit 3.1 4.1.2.2 Integrationstype Integrationen er en filtransport, hvor KY, KSD og SAPA uploader logfiler med tilhørende routingfil til Serviceplatformens SFTP-server. 4.1.2.3 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 14 af 16
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. 4.1.2.4 Datatransformering Ingen krav. 4.1.2.5 Datapersistering Der er pt. ingen yderligere krav i forhold til [SFTP]. 4.1.2.6 Databerigelse Ingen krav. 4.1.2.7 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 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 15 af 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 4.1.2.8 Orkestrering Ingen krav. 4.1.2.9 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]. 4.1.2.10 Logning Der er pt. ingen yderligere krav i forhold til [SFTP]. 4.1.2.11 Testdata og testfaciliter 4.1.2.12 Konfiguration Ingen krav. 4.1.2.13 Supplerende information Ingen supplerende information. KOMBIT A/S Halfdansgade 8 2300 København S www.kombit.dk CVR 19 43 50 75 Side 16 af 16