SF1530 CVR-Online Integrationsbeskrivelse - version 2.2.0

Transkript

1 Integrationsbeskrivelse - version Kommunernes Datafællesskab - KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer SEJ 0.1 Første version EDM Opdateret med input fra SAPA og STS EDM Integrationen er beskrevet med link til serviceplatformen.dk MHO Tilrettet efter internt review EHE 0.5 Klargjort til SP. Ikke review hos fagprojekter, da det er eksisterende service på SP. Kapacitetsbehov kommer fra fagprojekter EDM Opdateret med midlertidigt WSDL/XSD med ny sikkerhedsmodel MHO Referencerettelser mm EHE 2.1 Teknisk beskrivelse godkendt EHE Opdateret reference til ny wsdl. WSDL opdateret pga. fejl i forbindelse med KOMBIT token policy. Referencer Ref Titel Kommentarer [SPref] Se Note vedrørende servicemål for Serviceplatformen.pdf på følgende link: [SIKKER- HED] [STS-Sikkerhed] [WSDL-SP] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link Integrationsbeskrivelsen refererer til SF1530 Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link KOMBIT A/S Halfdansgade København S CVR Side 2 af 31

3 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Forudsætninger for produktionssætning af integration Kontekst for integrationsparter Kontekst for SAPA [!@SAPA@!] Kontekst for Støttesystem Organisation [!@STS@!] Kontekst for KY [!@KY@!] Specifikation for integrationsparter Specifikation af endpoints for SAPA, STS og KY [!@SAPA@!],[!@STS@!],[!@KY@!] Specifikation af endpoints for CVR [!@CVR@!] Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen [!@Systematic@!] KOMBIT A/S Halfdansgade København S CVR Side 3 af 31

4 CVR-Online Serviceplatformen Fagsystem(n) Integrationsbeskrivelse 1 Overordnet beskrivelse 1.1 Integrationens formål Integrationen skal dække forretningsmæssige behov fra monopolbrudsprojekterne KY, STS og SAPA. Snitfladen anvendes til at indhente basisoplysninger om en virksomhed og dennes produktionsenheder. Bemærk at CVR-Online findes som gennemstilling på Serviceplatformen i dag, se Overordnet forretningsflow i integrationen Følgende forretningsflow indgår i integrationen. Forespørg CVR (synkront kald) Hent virksomhedsoplysninger Synkron gennemstilling Send virksomhedsoplysninger Figur 1 Forespørg CVR gennemstilling Fagsystemet sender forespørgsel via Serviceplatformen, som gennemstiller til CVR-Online. KOMBIT A/S Halfdansgade København S CVR Side 4 af 31

5 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Forespørg CVR Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om [SPref]: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder 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]. 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 Eventuelle tilretninger og præciseringer i integrationens beskrivelse og specifikation, vil indtil integrationen ligger på Serviceplatformens eksterne testmiljø, blive håndteret af Kommunernes Data Fællesskab (KDF). Spørgsmål vedr. specifikation sendes til datafaellesskab@kombit.dk. KDF sørger for at involverede parter i integrationen oplyses om tilretningerne og præciseringerne. Se oversigten over hvornår de enkelte integrationer forventes at være tilgængelige i eksternt testmiljø her: KOMBIT A/S Halfdansgade København S CVR Side 5 af 31

6 Når servicen er tilgængelig i det eksterne testmiljø på Serviceplatformen, vil den overgå til Serviceplatformens governanceproces. Beskrivelse af denne tilgår senere Incident Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen? Det er KDFs forventning, at dette punkt kan udfyldes med udgangspunkt i den nuværende driftsaftale for Serviceplatformen afsnit 25. Incidents forventes på denne baggrund at skulle rapporteres til følgende kontaktpunkt hos Service Desk-leverandøren, TDC Hosting (telefon: , mail: sd@tdchosting.dk).] Problem Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] Change Management [Afklaring/Programmet rejst emne: Skal der være spoc på integrationen?] Lifecycle Management [Afklaring/Programmet: Håndteres i programemnelog #14] 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] 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] [Afklaring/CVR-Online: Findes der et testmiljø med brugbare testdata?] Testdata [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] [Afklaring/CVR-Online: Findes der et testmiljø med brugbare testdata?] KOMBIT A/S Halfdansgade København S CVR Side 6 af 31

7 1.4.2 Test i forbindelse med produktionssætning [Afklaring/KOMBIT: Det skal afklares hvilke evt. andre krav, der er behov for. Det kan fx være behov for beskrive verifikation af 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. 1.5 Forudsætninger for produktionssætning af integration Nedenstående er oplysninger om forudsætninger og betingelser, der skal være på plads for at sikre succesfuld tilslutning til integrationsparter Forudsætninger for funktionalitet på Serviceplatformen Ingen identificeret Generelle forsætninger for tilslutning til CVR-Online for brugersystemerne 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]. Leverandøren skal anmode om indgåelse af serviceaftale for de myndigheder, der skal bruge servicen, i rammearkitekturens administrationsmodul, og myndigheden skal godkender denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. [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] Snitfladen mod kildesystem er CVR-Online 3.0. Hvis denne opgraderes skal der udarbejdes ny snitfladebeskrivelse. CVR-Online findes på Serviceplatformen i dag som gennemstillingsintegration. KOMBIT A/S Halfdansgade København S CVR Side 7 af 31

8 2 Kontekst for integrationsparter 2.1 Kontekst for SAPA Lovhjemmel og forvaltningsmæssigt formål Det er SAPAs vurdering, at nærværende Integration ikke er omfattet af nogen speciallovgivning. Integrationsformål har dog hjemmel i Forvaltningslovens kap. 8. Derudover gælder det, at SAPA indhenter data om borgere i forbindelse med den kommunale sagsbehandling, og at SAPA over for sin leverandør har fremsat et mindstekrav om overholdelse af Persondataloven. Endelig indhenter SAPA data til brug for afgørelser i forbindelse med den kommunale sagsbehandling og/eller statistiske formål. Dette sker altid under hensyntagen til den tavshedspligt, som gælder ved videregivelse af oplysninger til en anden forvaltningsmyndighed, jf. forvaltningsloven 28, stk. 2, punkt 3. Formålet med at vise CVR-oplysninger om en virksomhedspart i SAPA er at sikre, at brugeren har adgang til basisoplysninger om virksomheden. 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 indehold 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 anslåede volumen er opslag/dag. Det vil sige ca. 1 mio. opslag/måned. Der er ingen særlige krav til svartid. Se desuden krav til svartid på SP jf. Kravspecifikation indgået mellem KOMBIT og Systematic. Der er Ingen særlige krav til oppetid. Se desuden krav til oppetid på SP jf. Kravspecifikation indgået mellem KOMBIT og Systematic. CVR-data tilgås af brugeren direkte i brugergrænsefladen i SAPA. Data skal vises hver gang et partsoverblik for en virksomhed åbnes Specifikke forhold for tilslutning af system [Udfyldes med detaljer om evt. specifikke forhold for tilslutning] KOMBIT A/S Halfdansgade København S CVR Side 8 af 31

9 2.2 Kontekst for Støttesystem Organisation Lovhjemmel og forvaltningsmæssigt formål Det er STS s vurdering, at nærværende Integration ikke er omfattet af nogen speciallovgivning. Integrationsformål har dog hjemmel i Forvaltningslovens kap. 8. Derudover gælder det, at STS Organisation indhenter data fra CVR i forbindelse med oprettelse af myndigheder i Organisation. Støttesystemet Organisation benytter synkrone serviceoperationer til at fremfinde data fra CVR registeret. Integrationen benyttes til at oprette Myndighed og Virksomhed objekter og til at holde objekternes stamdata opdateret. Støttesystemet Organisation er udvidet med 4 objekter hvoraf to af dem: Myndighed og Virksomhed kan identificeres ved deres CVR nummer. Under oprettelsen af disse objekter vil en stor del af deres stamdata og relationer kunne hentes fra CVR registeret. Leverandøren benytter det eksisterende CVR register til at oprette nye Myndighed og Virksomhed objekter, ud fra et CVR nummer. Periodemæssigt gennemløbes alle Myndighed og Virksomhed objekterne for om der er sket opdateringer til de underliggende data i CVR registeret. Er dette tilfældet, opdateres objekterne med de nye data, ved at udnytte de bitemporale egenskaber som objekterne understøtter. Leverandøren benytter sig af et design som passer ind i Rammearkitekturen ved at omdanne CVR data til objekter som understøtter De Generelle Egenskaber, og derved gøre dem udskiftelige når, grunddataprogrammet leverer de officielle versioner. 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 indehold 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 Den anslåede volumen er ca opslag/måned. Ingen særlige krav til svartid. Se desuden krav til svartid på SP jf. Kravspecifikation indgået mellem KOMBIT og Systematic. Ingen særlige krav til oppetid. Se desuden krav til oppetid på SP jf. Kravspecifikation indgået mellem KOMBIT og Systematic. CVR-data tilgås af brugeren direkte i brugergrænsefladen Specifikke forhold for tilslutning af system CVR-Online[Udfyldes med detaljer om evt. specifikke forhold for tilslutning] KOMBIT A/S Halfdansgade København S CVR Side 9 af 31

10 2.3 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Formålet med integrationen er at fremsøge og vise virksomhedsoplysninger i forbindelse med administration af en borgers kontanthjælpsydelser. Det er KY s vurdering, at nærværende Integration ikke er omfattet af nogen speciallovgivning. Integrationsformål har dog hjemmel i Forvaltningslovens kap. 8. Derudover gælder det, at KY indhenter data om borgere i forbindelse med den kommunale sagsbehandling og KY over for sin leverandør har fremsat et mindstekrav om overholdelse af Persondataloven. Endelig indhenter KY data til brug for afgørelser i forbindelse med den kommunale sagsbehandling og/eller statistiske formål. Dette sker altid under hensyntagen til den tavshedspligt som gælder ved videregivelse af oplysninger til en anden forvaltningsmyndighed, jf. forvaltningsloven 28, stk. 2, punkt 3. 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 indehold 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 anslåede volumen er opslag/måned. KY er indstillet på, at man initielt lever med de servicemål, der kan leveres på eksisterende service, men forbeholder sig ret til at ændre beslutning, hvis performancetest under udrulning giver anledning hertil Specifikke forhold for tilslutning af system [Udfyldes med detaljer om evt. specifikke forhold for tilslutning] KOMBIT A/S Halfdansgade København S CVR Side 10 af 31

11 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for SAPA, STS og KY Integrationen benyttes til at kalde og hente oplysninger fra CVR Online ved bl.a. oprettelse af virksomheder eller myndigheder, som er baseret på CVR informationer. Serviceplatformen udstiller i dag en gennemstilling til CVR-Online Overordnet forretningslogik Fagsystemerne kalder Serviceplatformen på endpoint EP_FS1, for at hente informationer om en virksomhed i det Centrale Virksomhedsregister (CVR). Servicen er implementeret som en SOAP webservice og understøtter de samme fem operationer som CVR-Online 3.0, men eksponerer disse i én webservice i stedet for fem Oversigt over endpoints ID Navn EP_FS1 CVR-Online Beskrivelse af endpoint EP_FS1 - CVR-Online Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Fagsystemerne er serviceanvendere Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Midlertidig WSDL og XSD vedlagt i SF1530-WSDL.zip med ny sikkerhedsmodel. Miljø: Produktion URI til WSDL [WSDL-SP] Endpoint navn KOMBIT A/S Halfdansgade København S CVR Side 11 af 31

12 Endpoint IP [Afklaring/Systematic oplysninger udfyldes af Systematic] Miljø: Test URI til WSDL Endpoint navn Endpoint IP [WSDL-SP] [Afklaring/Systematic oplysninger udfyldes af Systematic] Teknisk retning for udveksling Fagsystemet kalder Serviceplatformen for at hente CVR informationer Dataretning for udveksling Serviceplatformen returnerer CVR informationer til fagsystemet Service invokation / Triggers Kommunikationen initieres af, at fagsystemerne har behov for at hente data fra CVR Dataspecifikation Endpointet indeholder fem operationer, som svarer til de tilsvarende services i CVR-Online 3.0: LegalUnitGet LegalUnitSearch ProductionUnitGet ProductionUnitSearch RelatedProductionUnitNameAndAddressGet Hvis der ønskes uddybende information om P-numre, er dette et separat kald pr. nummer. Der forretningsmæssige flow er det samme. Dokumentationen til snitfladen er placeret på serviceplatformen.dk på dette link: 11e d4bed98c63db Dokumentationen beskriver dataspecifikationerne. Midlertidig WSDL og XSD vedlagt i SF1530-WSDL.zip med ny sikkerhedsmodel. Miljø: Produktion Inputdata [WSDL-SP] / XSD KOMBIT A/S Halfdansgade København S CVR Side 12 af 31

13 Outputdata [WSDL-SP] / XSD Miljø: Test Inputdata Outputdata [WSDL-SP] / XSD [WSDL-SP] / XSD Sikkerhed Sikkerhed mellem serviceplatformen og de nuværende brugere af snitfladen er certifikatbaseret. Sikkerheden mellem serviceplatformen og de kommende fagsystemer skal være tokenbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC Leverancesikkerhed og fejlhåndtering [Afklaring/Systematic Systematic udfylder dette afsnit med beskrivelse af leverancesikkerhed og fejlhåndtering i forhold til brugerne af den nuværende løsning.] [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [SPref] KOMBIT A/S Halfdansgade København S CVR Side 13 af 31

14 [Afklaring/SP: For beskedfordeler, SFTP mv. kendes svartid/håndteringstider ikke] Tilgængelighed Spidsbelastningsperiode Servicevinduer Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid [SPref]. Må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Ved mindre opdateringer: 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: 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 [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Problem Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Change Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Testplan Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. KOMBIT A/S Halfdansgade København S CVR Side 14 af 31

15 Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.2 Specifikation af endpoints for CVR [!@CVR@!] Integrationen benyttes til at hente oplysninger fra CVR Online ved bl.a. oprettelse af virksomheder eller myndigheder, som er baseret på CVR informationer.cvr-online Overordnet forretningslogik Fagsystemerne kalder Serviceplatformen på endpoint EP_FS1, for at hente informationer om en virksomhed i det Centrale Virksomhedsregister (CVR). Serviceplatformen gennemstiler kaldet med en simpel routning til den rette service hos CVR-Online Oversigt over endpoints ID Navn EP_CVR1 EP_CVR2 EP_CVR3 EP_CVR4 EP_CVR5 LegalUnitGet LegalUnitSearch ProductionUnitGet ProductionUnitSearch RelatedProductionUnitNameAndAddressGet Beskrivelse af endpoint EP_CVR1 - LegalUnitGet Transportspecifikation Serviceudstiller CVR er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. KOMBIT A/S Halfdansgade København S CVR Side 15 af 31

16 Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP LegalUnitGet_ wsdl LegalUnitGetServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Miljø: Test URI til WSDL Endpoint navn Endpoint IP LegalUnitGet_ wsdl LegalUnitGetServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CVR-Online 3.0 for at hente CVR informationer Dataretning for udveksling CVR-Online leverer CVR informationer til Serviceplatformen Service invokation / Triggers Når et fagsystem har behov for at hente CVR informationer til f.eks. oprettelser af virksomheder eller myndigheder Dataspecifikation CVR-Online 3.0 version 1.5 er specificeret her: og her Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata KOMBIT A/S Halfdansgade København S CVR Side 16 af 31

17 Sikkerhed Sikkerhed mellem serviceplatformen og CVR-Online 3.0 er username/password i en SSL-krypteret kommunikation. På sigt bør den være certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC Leverancesikkerhed og fejlhåndtering [Afklaring/Systematic Systematic udfylder dette afsnit med beskrivelse af leverancesikkerhed og fejlhåndtering i forhold til CVR-Online for den nuværende løsning.] [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi [Afklaring/KDF - Udfyldes med tidsrummet hvor der sikres normal drift] [Afklaring/KDF - Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] Tilgængelighed [Afklaring/KDF - Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] Spidsbelastningsperiode Servicevinduer [Afklaring/KDF - Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Afklaring/KDF - Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_CVR2 - LegalUnitSearch Transportspecifikation Serviceudstiller CVR er serviceudstiller. KOMBIT A/S Halfdansgade København S CVR Side 17 af 31

18 Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP LegalUnitSearch_ wsdl LegalUnitSearchServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Miljø: Test URI til WSDL Endpoint navn Endpoint IP LegalUnitSearch_ wsdl LegalUnitSearchServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CVR-Online 3.0 for at hente CVR informationer Dataretning for udveksling CVR-Online leverer CVR informationer til Serviceplatformen Service invokation / Triggers Når et fagsystem har behov for at hente CVR informationer til f.eks. oprettelser af virksomheder eller myndigheder Dataspecifikation CVR-Online 3.0 version 1.5 er specificeret her: og her Miljø: Produktion Inputdata Outputdata KOMBIT A/S Halfdansgade København S CVR Side 18 af 31

19 Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem serviceplatformen og CVR-Online 3.0 er username/password i en SSL-krypteret kommunikation. På sigt bør den være certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC Leverancesikkerhed og fejlhåndtering [Afklaring/Systematic Systematic udfylder dette afsnit med beskrivelse af leverancesikkerhed og fejlhåndtering i forhold til CVR-Online for den nuværende løsning.] [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi [Afklaring/KDF - Udfyldes med tidsrummet hvor der sikres normal drift] [Afklaring/KDF - Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] Tilgængelighed [Afklaring/KDF - Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] Spidsbelastningsperiode Servicevinduer [Afklaring/KDF - Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Afklaring/KDF - Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] KOMBIT A/S Halfdansgade København S CVR Side 19 af 31

20 3.2.5 Beskrivelse af endpoint EP_CVR3 - ProductionUnitGet Transportspecifikation Serviceudstiller CVR er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP ProductionUnitGet_ wsdl ProductionUnitGetServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Miljø: Test URI til WSDL Endpoint navn Endpoint IP ProductionUnitGet_ wsdl ProductionUnitGetServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CVR-Online 3.0 for at hente CVR informationer Dataretning for udveksling CVR-Online leverer CVR informationer til Serviceplatformen Service invokation / Triggers Når et fagsystem har behov for at hente CVR informationer til f.eks. oprettelser af virksomheder eller myndigheder Dataspecifikation CVR-Online 3.0 version 1.5 er specificeret her: og her KOMBIT A/S Halfdansgade København S CVR Side 20 af 31

21 Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem serviceplatformen og CVR-Online 3.0 er username/password i en SSL-krypteret kommunikation. På sigt bør den være certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC Leverancesikkerhed og fejlhåndtering [Afklaring/Systematic Systematic udfylder dette afsnit med beskrivelse af leverancesikkerhed og fejlhåndtering i forhold til CVR-Online for den nuværende løsning.] [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi [Afklaring/KDF - Udfyldes med tidsrummet hvor der sikres normal drift] [Afklaring/KDF - Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] Tilgængelighed [Afklaring/KDF - Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] KOMBIT A/S Halfdansgade København S CVR Side 21 af 31

22 Spidsbelastningsperiode Servicevinduer [Afklaring/KDF - Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Afklaring/KDF - Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_CVR4 - ProductionUnitSearch Transportspecifikation Serviceudstiller CVR er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP ProductionUnitSearch_ wsdl ProductionUnitSearchServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Miljø: Test URI til WSDL Endpoint navn Endpoint IP ProductionUnitSearch_ wsdl ProductionUnitSearchServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CVR-Online 3.0 for at hente CVR informationer Dataretning for udveksling CVR-Online leverer CVR informationer til Serviceplatformen Service invokation / Triggers Når et fagsystem har behov for at hente CVR informationer til f.eks. oprettelser af virksomheder eller myndigheder. KOMBIT A/S Halfdansgade København S CVR Side 22 af 31

23 Dataspecifikation CVR-Online 3.0 version 1.5 er specificeret her: og her Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem serviceplatformen og CVR-Online 3.0 er username/password i en SSL-krypteret kommunikation. På sigt bør den være certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC Leverancesikkerhed og fejlhåndtering [Afklaring/Systematic Systematic udfylder dette afsnit med beskrivelse af leverancesikkerhed og fejlhåndtering i forhold til CVR-Online for den nuværende løsning.] [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Værdi KOMBIT A/S Halfdansgade København S CVR Side 23 af 31

24 Tidsrum Svartid [Afklaring/KDF - Udfyldes med tidsrummet hvor der sikres normal drift] [Afklaring/KDF - Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] Tilgængelighed [Afklaring/KDF - Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] Spidsbelastningsperiode Servicevinduer [Afklaring/KDF - Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Afklaring/KDF - Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_CVR5 - RelatedProductionUnitNameAndAddressGet Transportspecifikation Serviceudstiller CVR er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP RelatedProductionUnitNameAndAddressGet_ wsdl RelatedProductionUnitNameAndAddressGetServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Miljø: Test URI til WSDL Endpoint navn Endpoint IP RelatedProductionUnitNameAndAddressGet_ wsdl RelatedProductionUnitNameAndAddressGetServicePort [Afklaring/Systematic - IP udfyldes af Systematic] Teknisk retning for udveksling Serviceplatformen kalder CVR-Online 3.0 for at hente CVR informationer. KOMBIT A/S Halfdansgade København S CVR Side 24 af 31

25 Dataretning for udveksling CVR-Online leverer CVR informationer til Serviceplatformen Service invokation / Triggers Når et fagsystem har behov for at hente CVR informationer til f.eks. oprettelser af virksomheder eller myndigheder Dataspecifikation CVR-Online 3.0 version 1.5 er specificeret her: og her Miljø: Produktion Inputdata Outputdata Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem serviceplatformen og CVR-Online 3.0 er username/password i en SSL-krypteret kommunikation. På sigt bør den være certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC Leverancesikkerhed og fejlhåndtering [Afklaring/Systematic Systematic udfylder dette afsnit med beskrivelse af leverancesikkerhed og fejlhåndtering i forhold til CVR-Online for den nuværende løsning.] [Udfyldes med oplysninger om den tekniske leverancesikkerhed via snitfladen, herunder fx med henvisning til definitioner i QoS for basic delivery assurances: At most once, At least once, Exactly once og No guarantee. [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med tekniske fejl.] [Udfyldes med information om fejlhåndtering og ansvar i forbindelse med forretningsmæssige fejl.] [Ovenstående skal også omfatte information om aftalte timeoutintervaller og regler for genfremsendelse.] KOMBIT A/S Halfdansgade København S CVR Side 25 af 31

26 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi [Afklaring/KDF - Udfyldes med tidsrummet hvor der sikres normal drift] [Afklaring/KDF - Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] Tilgængelighed [Afklaring/KDF - Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] Spidsbelastningsperiode Servicevinduer [Afklaring/KDF - Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Afklaring/KDF - Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Service Management Incident Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Problem Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Change Management [Afklaring/Programmet rejst emne: skal der være spoc på integrationer?] Testplan Integrationstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] Produktionssætningstest Den planlagte test af services til installation på Serviceplatformen omfatter pt., at Systematic udfører automatiserede tests af services og unit tests. Se [SPref] for detaljer. KOMBIT A/S Halfdansgade København S CVR Side 26 af 31

27 Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] KOMBIT A/S Halfdansgade København S CVR Side 27 af 31

28 Fagsystem Integrationsbeskrivelse 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen [!@Systematic@!] 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. EP_FS1 Serviceplatformen IF01 EP_CVR1 EP_CVR2 EP_CVR3 EP_CVR4 EP_CVR5 CVR-Online Oversigt over integrationsflows ID Navn IF01 CVR-Online_ Integrationsflow IF01: CVR-Online_ Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_FS1 CVR-Online Afsnit EP_CVR1 LegatUnitGet Afsnit EP_CVR2 LegatUnitSearch Afsnit EP_CVR3 ProductionUnitGet Afsnit KOMBIT A/S Halfdansgade København S CVR Side 28 af 31

29 EP_CVR4 ProductionUnitSearch Afsnit EP_CVR5 RelatedProductionNameAndAddresseGet Afsnit Integrationstype Integrationen er en gennemstillingsintegration, hvor de fem services på CVR-Online 3.0 udstilles som en service med fem operationer på Serviceplatformen Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Operation: LegalUnitGet Fagsystemet kalder Serviceplatformen for hente CVRinformationer Serviceplatformen router ud fra operationen i servicekaldet at gennemstille til den tilsvarende service på CVR online 3.0. Fagsystem Serviceplatformen CVR-online 3.0 Oper: LegalUnitGet EP_FS1 EP_CPR1 CVR online returnerer CVRinformationen gennem Serviceplatformen til fagsystemet. Operation: LegalUnitSearch Fagsystemet kalder Serviceplatformen for hente CVRinformationer Serviceplatformen router ud fra operationen i servicekaldet at gennemstille til den tilsvarende service på CVR online 3.0. Fagsystem Serviceplatformen CVR-online 3.0 Oper: LegalUnitSearch EP_FS1 EP_CPR2 CVR online returnerer CVRinformationen gennem Serviceplatformen til fagsystemet. Operation: ProductionUnitGet KOMBIT A/S Halfdansgade København S CVR Side 29 af 31

30 Fagsystemet kalder Serviceplatformen for hente CVRinformationer Serviceplatformen router ud fra operationen i servicekaldet at gennemstille til den tilsvarende service på CVR online 3.0. Fagsystem Serviceplatformen CVR-online 3.0 Oper: ProductionUnitGet EP_FS1 EP_CPR3 CVR online returnerer CVRinformationen gennem Serviceplatformen til fagsystemet. Operation: ProductionUnitSearch Fagsystemet kalder Serviceplatformen for hente CVRinformationer Serviceplatformen router ud fra operationen i servicekaldet at gennemstille til den tilsvarende service på CVR online 3.0. Fagsystem Serviceplatformen CVR-online 3.0 Oper: ProductionUnitSearch EP_FS1 EP_CPR4 CVR online returnerer CVRinformationen gennem Serviceplatformen til fagsystemet. Operation: RelatedProductionUnitNameAndAddressGet Fagsystemet kalder Serviceplatformen for hente CVRinformationer Serviceplatformen router ud fra operationen i servicekaldet at gennemstille til den tilsvarende service på CVR online 3.0. Fagsystem Serviceplatformen CVR-online 3.0 Oper: RelatedProductionUnitNameAndAddressGet EP_FS1 EP_CPR5 CVR online returnerer CVRinformationen gennem Serviceplatformen til fagsystemet. KOMBIT A/S Halfdansgade København S CVR Side 30 af 31

31 Datatransformering Ingen krav Datapersistering Ingen krav Databerigelse Ingen krav Routing Serviceplatformen router operationer fra forespørgslen fra fagsystemet mod EP_FS1 til de tilsvarende services på CVR-Online 3.0 EP_CVR1 EP CVR Orkestrering Ingen krav Sikkerhed Sikkerheden mellem Serviceplatformen og de nuværende brugere af servicen er certifikatbaseret. Sikkerheden mellem Serviceplatformen og de kommen de fagsystemer vil være tokenbaseret. Sikkerheden mellem Serviceplatformen og CVR-Online 3.0 er er baseret på username/password i en SSL-krypteret kommunikation. En fremtidig version af løsningen bør baseres på certifikat som beskrevet i UC-SEC-06 [Sikkerhed] Logning Ingen ekstrakrav til logning ud over de generelle logningskrav på Serviceplatformen Testdata og testfaciliter [Afklaring/Programmet: Programmets udmelding om teststrategi, programlog-id #1] Konfiguration Ingen krav Supplerende information Ingen supplerende information. KOMBIT A/S Halfdansgade København S CVR Side 31 af 31