Integration SF STAR DFDG Bevillinger Integrationsbeskrivelse - version 2.3.1

Transkript

1 Integration - version Kommunernes Data & Infrastruktur - KDI

2 Versionshistorik Relevans Dato Initialer Version Kommentarer EHE Teknisk beskrivelse godkendt EHE Opdateret reference til WSDL-fil. Ændring i forhold til tidligere WSDL er, Namespace ændret Indholdet af CaseWorkerStructure skal være uden namespace i den nye kontrakt. Det er pga. et krav fra kilden at der ikke er namespace på dette element. Response er ændret da det forventede svar ind i et wrapper element Opdateringer til dokumentet: Forudsætninger og vilkår ændret: - Kapitel Kapitel relevant for KY - Kapitel relevant for STAR udbetaling - Kapitel Relevant for Serviceplatformen XEHL Opdateret til ny teknisk specifikation med Liberty Basic Soap Binding. Heraf opdatering af referencen [WSDL-SP], og tabel i afsnit XEHL [WSDL-SP] opdateret: pga. soap-fault name er ændret fra SP_FaultDetails til FaultDetails, og dermed tilsvarende øvrige integrationer på Serviceplatformen. Dertil redaktionelle tilpasninger: [SPref] fjernet, [SIKKERHED] fjernet. Opdateret url for referencer pga. migrering af dokumenter til nyt dokumentbibliotek XMHL [STARWS] opdateret med links til ny wiki. Nye referencer indsat i teksten. Opdateret afsnit og med beskrivelse af dataspecifikation og fejlhåndtering. Opdateret [WSDL-EXT] og afsnit , og med ny specifikation fra STAR. Opdateret afsnit med mapning på SP. Mindre redaktionelle rettelser: Opdateret afsnit om test i forbindelse med udvikling. Referencer Ref Titel Kommentarer Opdateret afsnit om Servicemanagement med ny kontakt . [STS- Sikkerhed] Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link KOMBIT A/S Halfdansgade København S CVR Side 2 af 23

3 r [WSDL-SP] [Bilag] [WSDL- EXT] [STARWS1] n refererer til SF1610 Teknisk Spec zip som indeholder WSDL på Serviceplatformen. Filen er placeret i samme mappe som integrationsbeskrivelsen, se link dengler%20release.aspx n refererer til SF1610 Bilag zip, som indeholder den eksterne dokumentation, der refereres til i integrationsbeskrivelsen. Filen er placeret i samme mappe som integrationsbeskrivelsen, se link dengler%20release.aspx UnemploymentregistrationService_3.zip Forretningsmæssig beskrivelse af SaveAppropriation på STARWI- KI.pdf Teknisk specifikation for servicen udstillet af STAR. Se gældende version af [Bilag] Forretningsmæssig beskrivelse af SaveAppropriation version 3 på STARWIKI. Se gældende version af [Bilag] [STARWS2] Snitfladebeskrivelse af SaveAppropriation på STARWIKI.pdf Snitfladebeskrivelse af SaveAppropriation version 3 på STAR- WIKI. Se gældende version af [Bilag] [STARWS3] [STARWS4] [GVF] [KDIDrift] [KDITest] Beskrivelse af DFDGs sikkerhedsmodel og header-information på STARWIKI.pdf Eksterne aftageres kald til DFDG webservices, herunder håndtering af sikkerhed.pdf Reference til Generelle vilkår og forudsætninger, der skal være på plads før Snitflader kan anvendes: Filen Generelle vilkår og forudsætninger.pdf, som ligger her: Hjemmeside med informationer om ibrugtagning og test af KDIs Services: Hjemmeside med informationer om drift og forvaltning af KDIs Services: Beskrivelse af DFDGs sikkerhedsmodel og headerinformation på STARWIKI. Se gældende version af [Bilag] Overordnet beskrivelse af, hvorledes eksterne aftagere kalder DFDG webservices, herunder håndtering af sikkerhed. Se gældende version af [Bilag] KOMBIT A/S Halfdansgade København S CVR Side 3 af 23

4 Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning til snitfalde Kontekst for integrationsparter Kontekst for KY Kontekst for STAR Specifikation for integrationsparter Specifikation af endpoints for KY Specifikation af endpoints for STAR Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen KOMBIT A/S Halfdansgade København S CVR Side 4 af 23

5 STAR DFDG Serviceplatform Ydelsessystem 1 Overordnet beskrivelse 1.1 Integrationens formål Ydelsessystemet (KY) skal opdatere Det Fælles Data Grundlag (DFDG) i Styrelsen for Arbejdsmarked og Rekruttering (STAR), hver gang en ydelsesbevilling godkendes eller afvises. Der sendes besked pr. borger identificeret ved CPR nummer. 1.2 Overordnet forretningsflow i integrationen Jf. figuren nedenfor indgår følgende forretningsflow i integrationen. Ydelsessystemet opdaterer DFDG ved kald af Serviceplatformen Serviceplatformen udstiller en service, der kaldes af ydelsessystemet, og gennemstiller kaldet fra ydelsessystemet til STAR DFDG. Der er således tale om en gennemstillingsintegration, hvor fagsystemet sender en opdatering til DFDG og efterfølgende modtager et synkront retursvar. STAR DFDG udstiller en service, der understøtter opdatering af ydelsesbevilling Opdater DFDG Bekræft opdatering Synkron viderestilling Synkront retursvar Opdater DFDG Bekræft opdatering Yderligere information om det forretningsmæssige flow findes i [STARWS1]. KOMBIT A/S Halfdansgade København S CVR Side 5 af 23

6 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum STAR DFDG Bevillinger Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. [Afklaring/KDF: Åbningstid for eksternt system kendes ikke] Svartid Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder [Afklaring/KDF: Svartid for eksternt system kendes ikke] Tilgængelighed Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. [Afklaring/KDF: Tilgængelighed for eksternt system kendes ikke] Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage. [Afklaring/KDF: Spidsbelastningsperioder for eksternt system kendes ikke] 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 tidsrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. [Afklaring/KDF: Servicevinduer for eksternt system kendes ikke] Service Management Informationer om driftsmeddelelser, forespørgsler og kontaktinformationer, findes på siden for Drift og Forvaltning af KDIs Services her: [KDIDrift]. KOMBIT A/S Halfdansgade København S CVR Side 6 af 23

7 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. Der er tale om en robust test af sikkerhed, routing og anden kernefunktionalitet i integrationen, samt mere en simpel test af, om de enkelte operationer kan benyttes, stikprøvekontrol. Testen omfatter ikke samtlige dataelementer i operationerne. Leverandøren af Serviceplatformen er ansvarlig for denne test. Det generelle udgangspunkt for KOMBITs teststrategi er, at alle involverede parter har gennemført en robust systemtest af egen løsning, før der gennemføres test parterne imellem. Generelle informationer om ibrugtagning og test, samt kontaktinformationer for specifikke ønsker, kan findes via [KDITest]. 1.5 Tilslutning til snitfalde For at kunne anvende snitfladen er der en række vilkår og forudsætninger, som skal være opfyldt af den integrationspart, der skal tilsluttes. Ved integrationspart skal forstås anvendersystemer, kildesystem osv. Disse vilkår og forudsætninger er opdelt i en generelle vilkår og forudsætninger, som gælder på tværs af snitfladerne og i specifikke vilkår og forudsætninger for tilslutning til selve snitfladen. De generelle vilkår og forudsætninger er beskrevet i et samlet dokument [GVF], mens de specifikke aktiviteter, der skal udføres som forudsætning for tilslutning af en integrationspart, er beskrevet for hver enkelt integrationspart i kapitel Køreplan for Implementering Nedenstående diagram viser køreplanen for udrulningen, som anvendersystem inden for KOM- BITs rammearkitektur under monopolbrudsprojektet følger. Det væsentlige i køreplanen er faserne, mens en egentlig tidsplan vil følge 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æssigt kan udføres i. Serviceplatformen: Ved idriftsættelse af en snitflade er alle aktiviteter afsluttet, og snitfladen er klar til anvendelse. Eksternt system: Alle aktiviteter i forhold til serviceplatformen er afsluttet, men der kan være yderligere aktiviteter i forbindelse med tilslutning af et anvendersystem eller en kommune i forhold til kildesystemet. Anvender-/fagsystem og kommune: Ved tilslutning af et anvendersystem og/eller en kommune, er der en række aktiviteter op til idriftsættelse, dels af aftalemæssig karakter, og dels også af konfigurationsmæssig karakter, som skal udføres. Er der aktiviteter, som medfører konfiguration på Ser- KOMBIT A/S Halfdansgade København S CVR Side 7 af 23

8 viceplatformen, vil dette ske i forbindelse med leverandørens oprettelse af serviceaftalen for kommunen Særlige vilkår 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. KOMBIT A/S Halfdansgade København S CVR Side 8 af 23

9 2 Kontekst for integrationsparter 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Lovbekendtgørelse BEK nr. 394 af 24/04/2014 (Bekendtgørelse om det fælles datagrundlag og statistiske datavarehus for beskæftigelsesindsatsen) Det forvaltningsmæssige formål er at opdatere Det Fælles Data Grundlag (DFDG) i STAR, hver gang en bevilling godkendes eller afvises. 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 Ønsker og forventninger til kapacitets- og servicekrav fra denne integrationspart Der oprettes månedligt ca sager, hvor der sendes besked til DFDG om bevilling (enten godkendt eller afvist). Forventet volumen er estimeret til kald pr. måned 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 anvendersystem kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS102 Anmodning om Serviceaftale for SF1610 Konfiguration Administrationsmodul Leverandør af fagsystem Leverandør af fagsystem TS103 Godkendelse af serviceaftale for SF1610 Konfiguration Administrationsmodul Kommune Kommune TS102 - Leverandøren skal anmode om indgåelse af serviceaftale for kommunen, der skal bruge snitflade SF1610 i rammearkitekturens administrationsmodul, og myndigheden skal godkende denne anmodning jf. Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen [STS-Sikkerhed]. TS103 - Kommune skal godkende ovenstående serviceaftale. KOMBIT A/S Halfdansgade København S CVR Side 9 af 23

10 2.2 Kontekst for STAR Lovhjemmel og forvaltningsmæssigt formål Ikke relevant Kapacitets- og servicekrav Ikke oplyst Forudsætninger for produktionssætning af integration STAR Dette kapitel beskriver de opgaver, som skal gennemføres af STAR i relation til snitfladen, for at en integrationspart kan benytte snitfladen. ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TS201 Udarbejdelse af Dataudvekslingsaftale Aftale STAR DFDG KDI STAR Fase 1 Direkte relateret til TSP00 Det er samme aftale, som også indgås for SF1610, SF1611 og SF1612 TS202 Registrering af KOMBIT certifikat Konfiguration STAR DFDG KDI STAR Fase 1 Antageligt samme certifikat for SF1611 og SF1612 TS203 STAR DFDG Registrering adgang til STAR DFDG for kommunen Konfiguration Leverandør af fagsystem STAR Fase 2.2 TS201 - Der skal udarbejde og indgås en dataudvekslingsaftale mellem STAR og kommunerne. KOMBIT KDI vil indgå aftalen på vegne af kommunerne. TS202 - STAR DFDG skal registrere adgang for kald KOMBITs OCES-certifikat med CVRnr TS203 - STAR skal registrer de enkelte kommuner så de får adgang STAR DFDG. KOMBIT A/S Halfdansgade København S CVR Side 10 af 23

11 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY Integrationen benyttes til at opdatere Det Fælles Data Grundlag (DFDG) i Styrelsen for Arbejdsmarked og Rekruttering (STAR), hver gang en ydelsesbevilling godkendes eller afvises. Der sendes besked pr. borger identificeret ved CPR nummer Overordnet forretningslogik KY informerer STAR, når en bevilling godkendes eller afvises. KY kalder endpoint EP_KY i begge tilfælde Oversigt over endpoints ID Navn Reference til wsdl* Servicenavn på Serviceplatformen** Version på Serviceplatformen*** EP_KY SendBevilling [WSDL-SP]/wsdl/token/ SendBevillingService.wsdl SendBevilling 2.0 Servicenavn: SendBevillingService Operationsnavn: SaveAppropriation * Referencen [WSDL-SP] findes i referencelisten i starten af dette dokument, og i referencelisten henviser til entydig version af referencen. ** Servicenavn refererer til det navn man kan finde servicen under på Serviceplatformens administrationsside (i relevant miljø). *** Version referer til den version af servicen på Serviceplatformens administrationsside, som denne integrationsbeskrivelse omhandler Beskrivelse af endpoint EP_KY - SendBevilling Transportspecifikation Serviceudstiller Serviceplatform udstiller service Serviceanvender KY er serviceanvender Teknologisk understøttelse Integrationen er en synkron SOAP webservice Teknisk endpoint Endpointoplysning er angivet i tabellen i afsnit KOMBIT A/S Halfdansgade København S CVR Side 11 af 23

12 Teknisk retning for udveksling KY kalder serviceplatformen med synkron forespørgsel Dataretning for udveksling Data sendes af KY til Serviceplatformen Service invokation / Triggers Kommunikation initieres af at KY kalder service udstillet på Serviceplatformen Dataspecifikation Forespørgsler Forespørgslen består af tre hovedelementer: CallContext (se information om udfyldelse i [STS- Sikkerhed]), ActiveOrganisationHeader og SaveAppropriationRequest. ActiveOrganisationHeader benyttes til angive, hvilken myndighed kalderen udgiver (impersonate) sig for at være overfor DFDG. Følgende felter skal udfyldes i strukturen: Feltnavn Type Beskrivelse OrganisationTypeIdentifier Integer Identificerer den type af organisation som kaldet er foretaget på vegne af. KY udfylder altid med: 7. OrganisationCode String Koden som identificerer organisationen. KY udfylder altid med kommunekode (tre cifre) for den kaldende myndighed. KOMBIT A/S Halfdansgade København S CVR Side 12 af 23

13 [Afklaring/KDI undersøg med STAR, om det er muligt at bruge CVRnummer i stedet for kommunekode] RequestMetadata benyttes til at angive den kaldende bruger overfor DFDG. Følgende felter skal udfyldes i strukturen: Feltnavn Type Beskrivelse EventDate datetime Det kaldende systems registreringstidspunkt. CaseWorkerGivenName String Det kaldende system og jobbets navn. KY udfylder altid med: KOMBIT KY. CaseWorkerMiddleName String Det kaldende system og jobbets navn. KY udfylder altid med: KOMBIT KY. CaseWorkerSurname String Det kaldende system og jobbets navn. KY udfylder altid med: KOMBIT KY. CaseWorkerRid String Det kaldende systems system ID (UUID). KOMBIT A/S Halfdansgade København S CVR Side 13 af 23

14 KY udfylder med system ID (UUID). Følgende felter skal udfyldes i strukturen Appropriation, som udgør forretningsindholdet i kaldet: Feltnavn Type Beskrivelse PersonCivilRegistrationIdentifier AppropriationOutcome String/Pattern: ((((0[1-9] 1[0-9] 2[0-9] 3[0-1])( )) ((0[1-9] 1[0-9] 2[0-9] 30)( )) ((0[1-9] 1[0-9] 2[0-9])(02)))[0-9]{6}) String/Enumeration: Approved Rejected Borgerens (ansøger) cpr-nummer Udfyldes med Approved/Rejected afhængigt af om bevillingen er godkendt eller afvist. Udfyldelse af felterne i Appropriation er beskrevet i [STARWS2], og udfyldelse af felterne i Active- OrganisationHeader og RequestMetadata er beskrevet i [STARWS3] (bemærk at der er nogle få forskelle i indholdet i ActiveOrganisationHeader og RequestMetadata ovenfor og servicen, der udstilles af STAR forskellene håndteres af Serviceplatformen) Svar Kvitteringen for modtagelsen af transaktionen fra STAR består af strukturen ServiceReciept: Følgende felter udfyldes i strukturen ServiceReceipt, som udgør forretningsindholdet i svaret: Feltnavn Type Beskrivelse MessageIdentifier String/Pattern: EventDate datetime Tidspunkt for transaktionen eller registrering. [0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA- Unik identifikation af transaktion eller registrering. KOMBIT A/S Halfdansgade København S CVR Side 14 af 23

15 F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12} Sikkerhed Der benyttes rammearkitekturens token-baserede sikkerhedsmodel Leverancesikkerhed og fejlhåndtering Informationen leveres at least once. Hvis svar fra STAR/DFDG er negativt, eller udebliver er det KY der har ansvaret for eventuel genfremsendelse. STAR validerer indholdet af felterne ActiveOrganisationHeader og RequestUserMetadataHeader ift. kalders rettigheder jf. sikkerhedsmodellen. Det kan resultere i følgende fejl: Fejlkode Fejlbesked 8173 OrganisationType is invalid according to the organisationtypeidentifiercodelist UserType is invalid according to the requestusertypeidentifiercodelist The Soap request message is missing its required Soap header: ActiveOrganisationHeader 8233 The Soap request message is missing its required Soap header: RequestUserMetadataHeader 8234 Could not deserialize the Soap header: ActiveOrganisationHeader 8235 Could not deserialize the Soap header: RequestUserMetadataHeader [Afklaring/KDI undersøg med STAR, hvilke forretningsmæssige fejl der anvendes] Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Værdi Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Serviceplatformen har forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder KOMBIT A/S Halfdansgade København S CVR Side 15 af 23

16 Tilgængelighed Spidsbelastningsperiode Servicevinduer Servicemålene for Serviceplatformen driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage. 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 tidsrummet søndag kl. 22:00 til mandag kl. 06:00. Varsling 1. måned, varighed max 8 timer. 3.2 Specifikation af endpoints for STAR Integrationen benyttes til at opdatere Det Fælles Data Grundlag (DFDG) i Styrelsen for Arbejdsmarked og Rekruttering (STAR), hver gang en ydelsesbevilling godkendes eller afvises. Der sendes besked pr. borger identificeret ved CPR nummer Overordnet forretningslogik KY informerer STAR når en bevilling godkendes eller afvises. Informationen går over Serviceplatformen, og Serviceplatformen kalder endpoint EP_STAR Oversigt over endpoints ID Navn EP_STAR UnemploymentRegistrationServiceVersion1 (SaveAppropriation) Beskrivelse af endpoint EP_STAR - UnemploymentRegistrationServiceVersion1 (SaveAppropriation) Transportspecifikation Serviceudstiller STAR er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Servicen udstilles som synkron SOAP webservice KOMBIT A/S Halfdansgade København S CVR Side 16 af 23

17 Teknisk endpoint Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. URI til WSDL Endpoint navn Endpoint IP [WSDL-EXT] se filen UnemploymentregistrationService.wsdl [Udfyldes af STAR senere] [Udfyldes af STAR senere] Det konkrete testmiljø afventer afklaring, men kommunikation vil følge vejledning beskrevet i [STARWS] Teknisk retning for udveksling Serviceplatform kalder service udstillet af STAR Dataretning for udveksling Serviceplatformen leverer data til STAR Service invokation / Triggers Kaldet initieres af at Serviceplatformen modtager et tilsvarende kald fra fagsystemet der skal gennemstilles til STAR Dataspecifikation Se afsnit Sikkerhed KOMBIT FOCES-certifikat benyttes i kommunikation med STAR for alle kommuner. Følgende beskrivelse af sikkerhed og brug af certifikater ved tilslutning STARs systemer er indsat fra [STARWS4]: Generelt baserer datakommunikation, der er sikret med certifikater, sig på, at både afsender og modtager har et certifikat og at hvert certifikat består af en privat og en offentlig del. Den private del udleveres aldrig til andre, den offentlige del udleveres til parter, man ønsker at kommunikere sikkert med. STAR stiller et certifikat til rådighed pr. miljø (udviklingstestmiljø, produktionsmiljø), aftager ønsker at kommunikere sikkert med. Aftager skal tilsvarende anskaffe sig et mindst et OCES-certifikat via Nets. I langt de fleste tilfælde vil en aftager have en lokal certifikatadministrator (LRA) som kan udstede certifikater på vegne af Nets. For alle certifikater, uanset typen, gælder at de skal være udstedt under samme CVRnummer som oplyst i tilslutningsaftalen med STAR. KOMBIT A/S Halfdansgade København S CVR Side 17 af 23

18 Der skal bestilles et funktionscertifikat pr. myndighed dvs. en myndighed skal bruge netop et funktionscertifikat. Leverandører med flere myndigheder som kunder skal således også bruge et funktionscertifikat pr. myndighed. Forudsætningen for kunne anvende de bestilte certifikater i forbindelse med adgang til Arbejdsmarkedsportalens webservices er: Aftager skal have etableret tilslutningsaftale med STAR. Aftager skal have godkendt samtlige certifikater hos STAR. Dette sker ved fremsendelse (pr ) af de offentlige dele af certifikaterne til systemforvalter. Hvis der udelukkende er tale om medarbejdercertifikater kan godkendelsen også ske ved at forsøge pålogning på Aftager skal bruge: Et eller flere funktionscertifikater idet der som minimum skal anvendes et funktionscertifikat pr aftagende system (F 1 F n) Styrelsen for arbejdsmarked og rekrutterings offentlige servercertifikat til det miljø, hvorfra der skal aftages webservices, f.eks. service.bm.dk (STAR 1) Aftager skal: Importere/installere (STAR 1) i sit lokale Certificate Store, så det kan ses af det system, der skal foretage forespørgslen. Kryptere sin forespørgsel med (STAR 1) Signere sin forespørgsel med den private del af (F x) Afsende sin forespørgsel mod det pågældende miljø og webservice. Aftager vil modtage et svar: Krypteret med (F x) Signeret med (STAR 1) Aftager skal dekryptere svaret med den private del af F x Leverancesikkerhed og fejlhåndtering Data leveres at least once Hvis kaldet fejler eller timer ud, er det det kaldende fagsystem der skal håndtere en eventuel genfremsendelse. Fejlkoder anvendt af STAR er beskrevet i afsnit 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 18 af 23

19 Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af den maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid inden for aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] KOMBIT A/S Halfdansgade København S CVR Side 19 af 23

20 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. Figuren nedenfor viser hvilke komponenter og endpoints, der indgår i integrationen. KY EP_KY Serviceplatformen IF02 Send Bevilling EP_STAR STAR/ DFDG Oversigt over integrationsflows ID Navn IF02 Send Bevilling Integrationsflow IF02: Send Bevilling Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_KY Send Bevilling 3.1 EP_STAR UnemploymentRegistrationServiceVersion1 (SaveAppropriation) Integrationstype Integrationen er en gennemstillingsintegration, hvor fagsystemet afsender status til STAR, hvorefter STAR returnerer synkront retursvar. KOMBIT A/S Halfdansgade København S CVR Side 20 af 23

21 Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. KY Serviceplatform STAR/DFDG Synkront kald for status til STAR SP viderestiller kald til STAR STAR returnerer resultat SP returnerer svaret til FS EP_KY EP_STAR Datatransformering Serviceplatformen skal mappe nedenstående felter fra InputRequestType i servicen udstillet af Serviceplatformen til OutputRequestType i servicen udstillet af STAR: InputRequestType CaseWorkerGivenName ActiveOrganisationHeader.OrganisationTypeIdentifier ActiveOrganisationHeader.OrganisationCode ActiveOrganisationHeader.OrganisationTypeIdentifier ActiveOrganisationHeader.OrganisationCode RequestMetadata.EventDate OutputRequestType UserFullName RequestOrganisationStructure.OrganisationTypeIdentifier RequestOrganisationStructure.OrganisationCode ActiveOrganisationHeader.OrganisationTypeIdentifier ActiveOrganisationHeader.OrganisationCode RegistrationDateTime Serviceplatformen skal indsætte følgende værdier i OutputRequestType i servicen udstillet af STAR: Værdi OutputRequestType UserIdentifier 1bd6d5d1-7e35-4c2a c17ed64b2 UserRequestTypeIdentifier Datapersistering Ingen krav Databerigelse Ingen krav. KOMBIT A/S Halfdansgade København S CVR Side 21 af 23

22 Routing Ingen krav Orkestrering Ingen krav Sikkerhed KY tilgår service via tokenbaseret sikkerhed jf. RA-sikkerhedsmodel. STAR udstiller service med certifikatbaseret sikkerhed Logning STAR stiller særlige krav til logning i forbindelse med brug af services. Følgende beskrivelse vedrørende logning er indsat fra [STARWS3]: Webserviceaftageren skal gennemføre en grundlæggende logning i forhold til kommunikationen med de i dette dokument beskrevne web services. Webserviceaftageren skal opretholde en log med de kvitteringer, der returneres til aftageren når serviceaftageren sender hændelser til de udstillede services. Hvis der i kommunikationen opstår en fejl, skal web serviceaftageren logge fejlen inkl. alle fejlinformationer, der returneres fra servicen, samt den afsendte besked. Webserviceaftageren skal som minimum også logge følgende informationer: BrugerID RID fra brugerens certifikat. Den organisationstype brugeren repræsenterer f.eks. jobcenter eller a-kasse. Den organisationskode der er knyttet til den organisation brugeren repræsenterer Timestamp Hvis der indgår personoplysninger i applikationen, skal logningen være i overensstemmelse med Bekendtgørelse nr. 528 af 15/06/ Bekendtgørelse om sikkerhedsforanstaltninger til beskyttelse af personoplysninger, som behandles for den offentlige forvaltning Testdata og testfaciliteter [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 22 af 23

23 4.1.3 Tilslutning til integrationspart: Serviceplatformen Dette kapitel liste de forudsætninger, som skal være opfyldt for at Serviceplatformen kan udstille den pågældende snitflade ID Aktivitet Opgavekategori Komponent Ansvarlig Udførende Fase og afhængighed Kommentar TSP00 Indgåelse af Dataudvekslingsaftale på vegne af kommuner Aftale Fagsystem KDI KDI Fase 1 Direkte relateret til TS201 Det er samme aftale, som indgås i TS201 og TSP00 for SF1611, SF1612 og SF1620 TSP01 Send KOMBITs certifikat til STAR Sikkerhed STAR KDI KDI Fase 1 Det er samme certifikat, som anvendes for: SF1611, SF1612 og SF1620 TSP03 Registrering af Serviceinformation Konfiguration Serviceplatformen KDI KDI Fase 1 TSP00 - Der skal udarbejde og indgås en dataudvekslingsaftale mellem STAR og kommunerne. KOMBIT KDI vil indgå aftalen på kommunernes vegne. TSP01 - Til brug for adgang til STARs produktionssystem skal Serviceplatformen benytte et OCES Virksomhedscertifikat (TDC OCES CA), som udstedes af KOMBIT (cvr ). CVR-nr skal være registreret hos STAR for at opnå adgang for webservices. TSP03 - Der skal registres information vedrørende servicen i serviceplatformen, så der kan oprettes serviceaftaler for kommunerne, bl.a. skal logiske og fysiske endpoint skal være relateret. KOMBIT A/S Halfdansgade København S CVR Side 23 af 23