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

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 godkendt JJN Opdateret med forudsætninger og vilkår for tilslutning er tilføjet. - Kapitel 1.5 er omskrevet - Kapitel og Kapitel er nye. Tilrettet SF-nummer på forsiden, som var forkert. 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 ] [GVF] Integrationsvilkår Bilag 2. Logning version 1.3 Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Generelle vilkår og forudsætninger KOMBIT A/S Halfdansgade København S CVR Side 2 af 18

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning Kontekst for integrationsparter Kontekst for anvendere Specifikation for integrationsparter Specifikation af endpoints for anvendere Teststrategi Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 3 af 18

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 18

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 18

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 Forudsætninger for produktionssætning For at kunne anvende snitflade er det en række vilkår og forudsætninger, som skal være opfyldt af en tilslutningspart, der skal tilsluttes. Ved tilslutningspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i en generelle vilkår og forudsætning, som gælder på tværs af snitfladerne og i specifikke vilkår og forudsætninger for tilslutning til selve snitfalden. De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter der skal udføreres som forudsætning for tilslutning af en tilslutningspart er beskrevet for hver enkelt tilslutningspart i kapitel Køreplan for Implementering Nedenstående diagram viser en mulig køreplan for udrulningen af et anvendersystem inden for KOMBIT rammearkitektur under monopolbrudsprojektet. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge af den faktiske implementeringsplan. Aktiviteter, som er forudsætninger og betingelser i forbindelse med ibrugtagning af en snitflade, som følge af en udrulning af et anvendersystem, vil referere til den fase, den hensigtsmæssig kan udføres i. KOMBIT A/S Halfdansgade København S CVR Side 6 af 18

7 Serviceplatformen: Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse Kildesystem: Alle aktiviteter i forhold til serviceplatformen er afslutte, men der kan være yderligere aktiviteter i forbindelse med tilslut af et anvendersystem eller en kommune. Anvendersystem og kommune: Ved tilslutning af et anvendersystem og eller en kommuner, er der en række aktiviteter op til idriftsættelse, dels af aftalemæssig karakter, og dels også af konfigurationsmæssig karakter. Er der aktiviteter, som medføre konfiguration på Serviceplatformen, vil dette ske i forbindelse med oprettelse af myndighedens serviceaftalen for kommunen Særlige vilkår [Til brug for servicekataloget på serviceplatformen er der behov for kort at beskrive vilkår der er specifikke for den pågældende integration. Det vil typisk være indgåelse af aftale mellem anvendersystem og kildesystem. Aftale inde for rammearkitekturen skal ikke beskrives. Er der ingen specifikke vilkår for integrationen anvendes nedenstående tekst. Vilkår for servicen Der er ingen specielle vilkår for brug af nærværende service ud over de generelle vilkår, der er beskrevet under vilkår for hhv. leverandører og kommuner.] Supplerende information om tilslutning Intet [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] KOMBIT A/S Halfdansgade København S CVR Side 7 af 18

8 2 Kontekst for integrationsparter 2.1 Kontekst for anvendere 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 y-aksen er gennemsnitlig antal MB der skal flyttes til logningskomponenten pr. dag.. KOMBIT A/S Halfdansgade København S CVR Side 8 af 18

9 2.1.3 Specifikke forhold for tilslutning af system Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfladen, for at en kommune gennem et anvendersystemet kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS101 Aftale Opdatering af instruks for databehandling Serviceplatformen KOMBIT Kommune Fase 1 Aftale er indgået, er kun medtaget for helhedens skyld. TS102 Verifikation af SFTP bruger for simple SFTP er oprettet (se TBA08) Verifikation Serviceplatformen Leverandør af anvendersystem Leverandør af anvendersystem Fase 2.2 TS103 Verificer af simpel bruger for modtager, og typen Filtyper (se TBA08) Verifikation Anvendersystem Leverandør af anvendersystem Leverandør af anvendersystem Fase 2.2 Afhængig af TSP01 TS101 - Kommunerne og KOMBIT skal indgå databehandleraftale for logdata opsamlet på Serviceplatformen. Altalen er allerede indgået. TS102 - Anvendersystem skal verificerer, at der er oprette en simpel SFTP bruger på serviceplatformen. Denne SFTP bruger skal benyttes til at oveføre Logningsdata til Serviceplatformen. Se TBA08 i [GVF] TS103 - Anvendersystemet skal verificerer at bruger for modtager og filtype er korrekt. Dette gælder både ved modtagelse og afsendelse af fil over SFTP. KOMBIT A/S Halfdansgade København S CVR Side 9 af 18

10 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for anvendere 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 10 af 18

11 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 11 af 18

12 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 12 af 18

13 [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 13 af 18

14 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 14 af 18

15 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 15 af 18

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 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 SFTP platform: KOMBIT A/S Halfdansgade København S CVR Side 16 af 18

17 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 Generelle forhold for tilslutning til integrationspart: Serviceplatformen Dette kapitel beskriver de opgaver, som skal gennemføres i relation til snitfalden, for at snitflade kan anvendes på Serviceplatformen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TSP01 Verifikation af SFTP bruger for simple SFTP er oprettet (se TBA08) Verifikation Serviceplatformen SSE SSE Fase 1 TSP01 - Serviceplatformen skal verificerer, at der er oprette en simpel SFTP bruger på serviceplatformen til modtagelse af logs. Se TBA08 i [GVF] KOMBIT A/S Halfdansgade København S CVR Side 17 af 18

18 KOMBIT A/S Halfdansgade København S CVR Side 18 af 18