SF2250 NemSMS - Afsend SMS og tilmeld borger Integrationsbeskrivelse - version 2.2.0

Transkript

1 SF2250 NemSMS - Afsend SMS og tilmeld borger Integrationsbeskrivelse - version Kommunernes Datafællesskab KDF

2 Versionshistorik Relevans Dato Initialer Version Kommentarer sej 0.1 Første version edm Opdatering af første version edm Opdateret til gennemstilling til NemSMS edm Opdateret med kommentarer fra internt review edm Opdateret med arkitektur-beslutning af SF / edm Opdateret titel edm Opdateret med kommentarer fra fagsystem review JJN Referencerettelser mm EHE 2.1 Teknisk beskrivelse godkendt EHE WSDL indarbejdet, dvs. reference [WSDL-SP] opdateret Referencer Ref Titel Kommentarer [SPref] Note vedrørende servicemål for Serviceplatformen [SIKKERHED] Use cases for brug af sikkerhedsmodeller på Serviceplatformen - v [STS-Sikkerhed] [VBF] Se vilkår Bilag 2 - Vilkår for anvendelse af sikkerhedsmodellen i Rammearkitekturen version 2.0 på nedenstående link Se vilkår Underbilag 2N - Vilkår for integration til støttesystemet Beskedfordeler version 2.0 på nedenstående link [WSDL-SP] [Digital Post] Notat - Kvitteringer i KOMBIT snitflader.docx Integrationsbeskrivelsen refererer til SF2250 Teknisk Spec zip som indeholder WSDL på serviceplatformen, og er placeret i samme mappe som integrationsbeskrivelsen, se link [Fejlhåndtering] Digitaliseringsstyrelsens dokumentation for Digital Post og NemSMS. [SF1600] Print på Serviceplatformen [SF1460_A] Modtag besked Beskrivelse af protokol for Beskedfordeler KOMBIT A/S Halfdansgade København S CVR Side 2 af 33

3 [SF1460_B] Vedligehold værdiliste i beskedabonnement Beskrivelse af protokol for Beskedfordeler [SF1460_C] Aflever besked Beskrivelse af protokol for Beskedfordeler [SF1460_D] Modtag besked via pull Beskrivelse af protokol for Beskedfordeler Indholdsfortegnelse 1 Overordnet beskrivelse Integrationens formål Overordnet forretningsflow i integrationen Servicebetingelser for den samlede integration Teststrategi Tilslutning af services Kontekst for integrationsparter Kontekst for KY [!@KY@!] Specifikation for integrationsparter Specifikation af endpoints for KY [!@KY@!] Specifikation af endpoints for NemSMS [!@NS@!] Beskrivelse for integrationsplatforme Beskrivelse for Serviceplatformen [!@Systematic@!] KOMBIT A/S Halfdansgade København S CVR Side 3 af 33

4 1 Overordnet beskrivelse 1.1 Integrationens formål Fagsystemer skal have integration til SMS på Serviceplatformen. Denne skal bruges til at sende borgeren beskeder omkring f.eks. udbetalinger, samt ad-hoc beskeder som f.eks. Der er sket ny i din sag. Se mere på Selvbetjeningen Det er en forudsætning at borgeren forudgående har tilmeldt sig SMS, hvilket tilbydes borgeren i KY s online grænseflade. 1.2 Overordnet forretningsflow i integrationen Serviceplatformen skal understøtte følgende forretningsgange, som opdeles i - Forespørge på NemSMS tilmeldingsstatus [SF1600] - Modtage ændringer af-/tilmeldinger til NemSMS gennem Beskedfordeler [SF1600] - Tilmelde borgeren til NemSMS - Afsende SMS [SF1600] Da grænsefladerne er identisk med Digital Post og er udstillet af Digital Post, vil disse grænseflader blive genbrugt. I forbindelse med NemSMS er der udstillet en ny service, Tilmelde borgeren til NemSMS, som ikke kan benyttes i forbindelse med Digital Post og derfor er beskrevet i dette dokument. I dette dokument henvises til [SF1600] Print på Serviceplatformen for de snitflader, som er ens. Når en myndighed tilmelder sig Digital Post eller NemSMS, får myndigheden et SystemId (eller SysId), som skal benyttes ved hvert kald til Digital Post eller NemSMS for at identificere afsenderen. Der benyttes forskellige SystemID for Digital Post og NemSMS for hver myndighed, hvilket adskiller om man benytter henholdsvis Digital Post eller NemSMS Forespørge på tilmeldingsstatus Digital post udstiller en service, hvor der kan forespørges om borgeren er tilmeldt Digital Post eller NemSMS (eboks). Serviceplatformen udstiller en synkron SOAP service, hvor fagsystemet kan forespørge på tilmeldingsstatus for en person, som gennemstilles til Digital Post med OIOREST. Denne snitflade udstilles i [SF1600]. (EP_SP1) Tegningen nedenfor beskriver denne funktionalitet. KOMBIT A/S Halfdansgade København S CVR Side 4 af 33

5 Digital Post (eboks) Serviceplatform Fagsystem(n) Tilmeldingsstatus Forespørg på tilmeldinger Forespørg tilmelding Modtag resultat Hent tilmelding Returner synkront Tilmelding Database Hent tilmelding Returner synkront Modtage af-/tilmeldinger til NemSMS gennem Beskedfordeler Serviceplatformen henter tilmeldingslister fra NemSMS dagligt per myndighed. Herefter sammenlignes listen med gårsdagens liste for at afgøre, hvilke forretningsmæssige tilmeldingsændringer, som har fundet sted. Til sidst afleveres data til Beskedfordeler med en besked per hændelse. Fagsystemer skal oprette et abonnement i Beskedfordeler med angivelse af filtre på kuvertens metadata, herunder relevante personhændelser og personnumre. Fagsystemets adgang til typer af personhændelser fra Beskedfordeler skal opsættes i det fælleskommunale støttesystem Adgangsstyring. Fagsystemet vil således kun kunne modtage personhændelser fra Beskedfordeler på angivne beskedtyper og som er indeholdt i fagsystemets abonnement. Integrationen er en gennemstillingsintegration med content based routing og transformation, som integrerer til Beskedfordeler. KOMBIT A/S Halfdansgade København S CVR Side 5 af 33

6 Digital Post Serviceplatformen Beskedfordeler Fagsystem (n) Nedenfor er illustreret flowet i integrationen: Modtag tilmeldingsændringer NemSMS Modtag Besked Modtag Besked Distribuer besked til dueslag Udstil besked Hent tilmeldingsliste Send Besked Udstil tilmeldingsliste Dan forretningshændelser Tilmeldingsdatabase Serviceplatformen skal beregne ændringer i tilmeldingerne ud fra gårsdagens lister, som derfor skal gemmes i Serviceplatformen. Beskedfordeler modtager beskederne og udregner hvilke abonnementer, som skal modtage beskeden og distribuerer herefter beskeder til de korrekte dueslag. Fagsystemerne kan selv opsætte og administrere deres dueslag. KOMBIT A/S Halfdansgade København S CVR Side 6 af 33

7 Fagsystemet modtager beskeden og behandler den efter egne forretningsregler jf. snitflade SF1460_D. Denne snitflade omhandler kun Serviceplatformens modtagelse af personhændelser og afsendelse af forretningshændelser vedr. person (Part). Denne funktion varetages af SF1600 Print på Serviceplatformen, som har en funktionalitet til at kalde Digital Post for at hente tilmeldinger til Digital Post. Digital Post og NemSMS leveres af eboks og har ens snitflader, hvor det er det SystemId per myndighed, som benyttes i kaldet, der bestemmer om det Digital Post eller NemSMS. Se yderligere i [SF1600] Tilmelde borgeren til NemSMS Borgeren skal have mulighed for at tilmelde sig NemSMS, hvilket sker gennem NemSMS løsningens register (eboks). Serviceplatformen udstiller en SOAP service, hvor fagsystemet, på vegne af borgeren, kan tilmelde denne til NemSMS. Fagsystemet kalder først NemSMS for at oprette/opdatere borgerens data for derefter at tilmelde borgeren til NemSMS. Borgeren skal herefter bekræfte mobilnummer/sms, før NemSMS bliver aktiv. Hvis borgeren er oprettet i forvejen, vil borgeren data blive opdateret. Tegningen nedenfor beskriver denne funktionalitet. KOMBIT A/S Halfdansgade København S CVR Side 7 af 33

8 NemSMS (eboks) Serviceplatform Fagsystem(n) Tilmelding NemSMS Tilmelde til NemSMS Opret / opdater slutbruger Tilmelde NemSMS Gennemstil til NemSMS Gennemstil til NemSMS Opret / opdater slutbruger Tilmeld slutbruger al NemSMS er Tilmeldinger Afsende SMS Serviceplatformen udstiller en synkron service til afsendelse af breve, som også benyttes til afsendelse af SMS. Servicen på serviceplatformen udstilles som den gennemstillingsservice til NemSMS. Det er afsenders opgave at undersøge om modtager er tilmeldt NemSMS inden afsendelse. Status for afsendelsen returneres i det synkrone kald. KanalValg sættes til D for Digital Post/NemSMS og prioritet sættes til D for direkte afsendelse. Denne snitflade udstilles i [SF1600]. (EP_SP2). Tegningen nedenfor beskriver denne funktionalitet. KOMBIT A/S Halfdansgade København S CVR Side 8 af 33

9 Fjernprint(n) Digital Post (eboks) Serviceplatform Fagsystem(n) Afsend SMS (Print på Serviceplatformen) Afsend brev direkte eller batch Afsend brev Ja Som Digital Post Nej Mapning til DP brev Ja direkte Nej Viderestil til kommunens fjernprint Organisation Afsend direkte digital post Afsend batch digital post Afsend status Afsend status Afsend brev Generelle forudsætninger Følgende forudsættes: KOMBIT A/S Halfdansgade København S CVR Side 9 af 33

10 Kommunerne indgår fornødne aftaler med NemSMS (eboks) omkring levering af NemSMS, og al afregning for afsendelse tilgår den enkelte kommune. Der skal betales et engangsbeløb ved tilslutning af kommunen til NemSMS. Kommunerne vil have et andet SystemId (System Identitet) i NemSMS i forhold til Digital Post. Der skal kun være et samlet SystemId der dækker alle kommunens systemer der sender via Serviceplatformen. Bemærk at tilslutningsafgift betales pr. SystemId. Protokollen fra Serviceplatform til Kildesystem (digital post fjernprintløsning) er OIOREST, som defineret af Digitaliseringsstyrelsen. Beskeden kan ikke overstige 160 tegn. Der kan kun afsendes SMS i tidsrummet 8-22 i flg. vilkår for NemSMS. Filformatet skal altid sættes til TXT for NemSMS. 1.3 Servicebetingelser for den samlede integration Servicemål Parameter Tidsrum Tilmelde borgeren til NemSMS Serviceplatformen driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer [SPref]. Digitaliseringsstyrelse NemSMS opgiver at der kan afsendes SMS i tidsrummet 8-22 i flg. vilkår for NemSMS Svartid 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 Digitaliseringsstyrelse NemSMS vil ikke forpligtige sig til at oplyse svartider. 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 [SPref]. Digitaliseringsstyrelse NemSMS vil ikke forpligtige sig til at oplyse et servicemål for tilgængelighed Spidsbelastningsperiode Spidsbelastningen for Serviceplatformen må antages at være i perioden 06:00-18:00 på arbejdsdage [SPref]. Digitaliseringsstyrelse NemSMS vil ikke forpligtige sig til at oplyse spidsbelastningsperioder. KOMBIT A/S Halfdansgade København S CVR Side 10 af 33

11 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]. Digitaliseringsstyrelse NemSMS vil ikke forpligtige sig til at oplyse servicevinduer 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: 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/KDF: Udfyldes med relevant tværgående opsummering.] 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/KDF: Udfyldes med relevant tværgående opsummering.] Change Management [Afklaring/KDF: Udfyldes med relevant tværgående opsummering.] Lifecycle Management [Afklaring/KDF: Udfyldes med relevant tværgående opsummering.] KOMBIT A/S Halfdansgade København S CVR Side 11 af 33

12 1.4 Teststrategi [Indhold afventer generel afklaring af test] Test i forbindelse med udvikling [Indhold afventer generel afklaring af test] Testfaciliteter og testmiljø [Indhold afventer generel afklaring af test] Testdata [Indhold afventer generel afklaring af test] 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 1.5 Tilslutning af services 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]. [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] Forudsætninger for funktionalitet på Serviceplatformen [Afklaring/KDF det skal angives, hvilke certifikater der skal foreligge for at kunne benytte integrationen] De nødvendige abonnementer og opsætninger skal være oprettet i Beskedfordeler, så systemet kan modtage de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [STS-Sikkerhed]. KOMBIT A/S Halfdansgade København S CVR Side 12 af 33

13 1.5.2 Forudsætninger for tilslutning til integrationspart: Fagsystemer 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]. De nødvendige beskedtyper og opsætninger skal være oprettet i Beskedfordeler, så systemet kan sende de beskeder, der indgår i integrationen jf. Vilkår for integration til støttesystemet Beskedfordeler [VBF] Forudsætninger for tilslutning til integrationspart: Ekstern system [Afklaring/KDF det skal angives, hvilke certifikater der skal foreligge for at kunne benytte integrationen] KOMBIT A/S Halfdansgade København S CVR Side 13 af 33

14 2 Kontekst for integrationsparter 2.1 Kontekst for KY Lovhjemmel og forvaltningsmæssigt formål Det er monopolbrudsprojektets vurdering, at nærværende Integration ikke er omfattet af nogen speciallovgivning. Integrationsformålet har dog hjemmel i Forvaltningslovens kapitel 8. Bemærk, at det kræver samtykke at sende notifikationer via NemSMS. Derudover gælder det, at KY indhenter data om borgere i forbindelse med den kommunale sagsbehandling og KY har over for sin leverandør fremsat et mindstekrav om overholdelse af Persondataloven. Endelig indhenter KY data til brug for afgørelser i forbindelse med den kommunale sagsbehandling. Dette sker altid under hensyntagen til den tavshedspligt som gælder ved videregivelse af oplysninger til en anden forvaltningsmyndighed, jf. Forvaltningsloven 28, Stk. 2, 3) Det forvaltningsmæssige formål er at kommunikere med borgerne og gøre opmærksom på nye hændelser i sagsforløb mm. 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 Forventet volumen for snitfladen er estimeret til kald per måned. Løsningen skal sende besked via SMS-komponentens snitflade når der er opdateringer på en borgers sag, som f.eks. statusopdateringer eller udbetalinger. Løsningens konkrete anvendelse (volumen) af snitfladen er derfor ikke p.t. mulig at præcisere Specifikke forhold for tilslutning af system [Udfyldes med detaljer om evt. specifikke forhold for tilslutning] KOMBIT A/S Halfdansgade København S CVR Side 14 af 33

15 3 Specifikation for integrationsparter 3.1 Specifikation af endpoints for KY Integrationen benyttes til at afsende SMS, tilmelde borgeren til NemSMS samt forespørge på tilmelding til NemSMS på Serviceplatformen (SP) Overordnet forretningslogik Når et fagsystem ønsker at afsende SMS, forespørger fagsystemet først om modtageren er tilmeldt NemSMS på SP Endpoint EP_SP1. Borgeren kan via online delen af fagsystemet tilmelde sig til NemSMS. Dette sker synkront på SP gennem endpoint EP_SP2. Hvis borgeren er oprettet i forvejen, vil borgerens stamdata i NemSMS blive opdateret og efterfølgende blive tilmeldt alle NemSMS på endpoint EP_SP3. Fagsystemet kan afsende SMS på SP Endpoint EP_SP4. KanalValg sættes til D og Prioritet til D. Serviceplatformen mapper til DP format og gennemstiller NemSMS Oversigt over endpoints ID Navn EP_SP1 EP_SP2 EP_SP3 EP_SP4 Spoerg_tilmelding_SP [SF1600 EP_SP1 Spoerg_tilmelding_SP]] Opdater_Borger_NemSMS_SP Tilmeld_NemSMS_SP Afsend_SMS_SP [SF1600 EP_SP2 Afsend_brev_SP] Beskrivelse af endpoint EP_SP1 - Spoerg_tilmelding_SP Se [SF1600 EP_SP1 Spoerg_tilmelding_DP, afsnit 3.1.3] Beskrivelse af endpoint EP_SP2 Opdater_Borger_NemSMS_SP [KDF/KY Afklare om det skal være muligt at læse borgerens stamdata, hvis denne er oprettet] Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Fagsystemet, KY, er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som en SOAP webservice, version Teknisk endpoint [Udfyldes med teknisk endpoint] KOMBIT A/S Halfdansgade København S CVR Side 15 af 33

16 Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL [WSDL-SP] Se filen [Afklaring/KDF: WSDL mangler] Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL [WSDL-SP] Se filen [Afklaring/KDF: WSDL mangler] Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Teknisk retning for udveksling Fagsystemet kalder synkron service på Serviceplatformen Dataretning for udveksling Fagsystemet afsender data til NemSMS Service invokation / Triggers Kommunikation initieres når fagsystemet har behov for at tilmelde en borger til NemSMS Dataspecifikation Servicen kaldes med OpdaterBorgerNemSMSRequest og den returnerer OpdaterBorgerNemSMS- Response. Ved fejl returneres standard KOMBIT SOAP fault. Se Transportkvittering i [Fejlhåndtering] Detaljeret dokumentation af grænseflader findes på [Digital Post]. OpdaterBorgerNemSMSRequest Niv Feltnavn Kard Værdisæt Betegnelse 1 AfsenderMyndighed 1..1 KOMBIT A/S Halfdansgade København S CVR Side 16 af 33

17 2 Objekttype 1..1 String Klassifikation = Myndighed 2 ReferenceID 1..1 URN Kommunens CVR-nr (URN urn:oio:cvr-nr:xxxxxxxx ) 1 TilmeldingRequest CPR-nr eller CVR-nr skal være udfyldt 2 SysId 1..1 SystemIdentifikator hos NemSMS 2 IndholdstypeId CPR-nr 0..1 String URN urn:oio:cpr-nr:xxxxxxxxxx 2 CVR-nr 0..1 String URN urn:oio:cvr-nr:xxxxxxxx 2 SlutbrugerStamdata 1..1 Complex OIOXML SlutbrugerStamdata.xsd fra [Digital Post] OpdaterBorgerNemSMSResponse Niv Feltnavn Kard Værdisæt Betegnelse 1 [Standard KOMBIT fejl struktur] Snitfladen og XSD er beskrevet i [Digital Post] Bilag A2 REST Register v63 uden ndringsmarkering.pdf Miljø: Produktion Inputdata Outputdata [Afklaring/KDF: XSD mangler] [Afklaring/KDF: XSD mangler] Miljø: Test Inputdata Outputdata [Afklaring/KDF: XSD mangler] [Afklaring/KDF: XSD mangler] KOMBIT A/S Halfdansgade København S CVR Side 17 af 33

18 Sikkerhed Sikkerhed mellem fagsystemerne og serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed], UC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering Det er vigtigt at alle SMS der bestilles via printkomponenten på Serviceplatformen, afsendes rettidigt til borgeren. Quality of Service skal derfor være mindst At Least Once. [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 Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage 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: KOMBIT A/S Halfdansgade København S CVR Side 18 af 33

19 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 Beskrivelse af endpoint EP_SP3 - Tilmeld_NemSMS_SP Transportspecifikation Serviceudstiller Serviceplatform er serviceudstiller Serviceanvender Fagsystemet, KY, 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 [WSDL-SP] Se filen [Afklaring/KDF: WSDL mangler] Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] Miljø: Test URI til WSDL [WSDL-SP] Se filen [Afklaring/KDF: WSDL mangler] Endpoint navn [Afklaring/SP: Endelig Url skal indsættes] Endpoint IP [Afklaring/SP: Endelig IP skal indsættes] KOMBIT A/S Halfdansgade København S CVR Side 19 af 33

20 Teknisk retning for udveksling Fagsystemet kalder synkron service på Serviceplatformen Dataretning for udveksling Fagsystemet afsender data til NemSMS Service invokation / Triggers Kommunikation initieres når fagsystemet har behov for at tilmelde en borger til NemSMS Dataspecifikation Servicen kaldes med TilmeldNemSMSRequest og den returnerer TilmeldNemSMSResponse. Ved fejl returneres standard KOMBIT SOAP fault. Se Transportkvittering i [Fejlhåndtering] Detaljeret dokumentation af grænseflader findes på [Digital Post]. TilmeldNemSMSRequest Niv Feltnavn Kard Værdisæt Betegnelse 1 AfsenderMyndighed Objekttype 1..1 String Klassifikation = Myndighed 2 ReferenceID 1..1 URN Kommunens CVR-nr (URN urn:oio:cvr-nr:xxxxxxxx ) 1 TilmeldingRequest CPR-nr eller CVR-nr skal være udfyldt 2 SysId 1..1 SystemIdentifikator hos NemSMS 2 IndholdstypeId CPR-nr 0..1 String URN urn:oio:cpr-nr:xxxxxxxxxx 2 CVR-nr 0..1 String URN urn:oio:cvr-nr:xxxxxxxx 2 Myndighedstilmelding 1..1 Complex OIOXML Myndighedstilmelding.xsd fra [Digital Post] TilmeldNemSMSResponse Niv Feltnavn Kard Værdisæt Betegnelse KOMBIT A/S Halfdansgade København S CVR Side 20 af 33

21 1 [Standard KOMBIT fejl struktur] Snitfladen og XSD er beskrevet i [Digital Post] Bilag A2 REST Register v63 uden ndringsmarkering.pdf Miljø: Produktion Inputdata Outputdata [Afklaring/KDF: XSD mangler] [Afklaring/KDF: XSD mangler] Miljø: Test Inputdata Outputdata [Afklaring/KDF: XSD mangler] [Afklaring/KDF: XSD mangler] Sikkerhed Sikkerhed mellem fagsystemerne og serviceplatformen er tokenbaseret, som defineret i RA STS [STS-Sikkerhed], UC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering Det er vigtigt at alle SMS der bestilles via printkomponenten på Serviceplatformen, afsendes rettidigt til borgeren. Quality of Service skal derfor være mindst At Least Once. [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 21 af 33

22 Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi Systemet driftsafvikles hele døgnet alle dage bortset fra når der udføres ændringer/hvor der er servicevinduer. Der er forskellig SLA på svartid alt efter hvilken integrationskompleksitet, der er tale om: Simpel = 1 sekund Mellem = 1,5 sekund Kompleks = 4 sekunder Servicemålene for systemets driftseffektivitet er 99,8% for perioden 06:00-18:00 på arbejdsdage samt 98,5 % i den øvrige tid. Må antages at være i perioden 06:00-18:00 på arbejdsdage 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 Beskrivelse af endpoint EP_SP4 - Afsend_SMS_SP Se [SF1600 EP_SP2 Afsend_brev_DP, afsnit 3.1.4] 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?] KOMBIT A/S Halfdansgade København S CVR Side 22 af 33

23 3.1.8 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. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] 3.2 Specifikation af endpoints for NemSMS [!@NS@!] Integrationen benyttes til at afsende SMS til NemSMS, tilmelde borgeren til NemSMS samt vedligeholde replika af tilmeldinger på Serviceplatformen (SP) samt modtage kvittering fra NemSMS, som skal videresendes til fagsystemerne. Serviceplatformen gennemstiller services fra SOAP webservices mod fagsystemerne til OIOREST mod NemSMS (Digital Post) Overordnet forretningslogik Serviceplatformen gennemstiller forespørgsler på tilmelding til NemSMS fra fagsystemerne på endppoint EP_NS1. Serviceplatformen kan tilmelde borgeren til NemSMS (alle NemSMS myndigheder), hvor der første kaldes til NemSMS på endpoint EP_NS2 for at oprette/opdatere borgeren for efterfølgende at tilmelde NemSMS på endpoint EP_NS3. Borgeren skal efterfølgende bekræfte SMS-tilmeldingen før den bliver aktiv. Serviceplatformen kan afsende en SMS fra et fagsystem til NemSMS på endpoint EP_NS4. Fagsystemet medsender SystemId til NemSMS. Endpoint EP_NS1 og EP_NS4 er udstillet i [SF1600] Print på Serviceplatformen, og er ikke beskrevet her Oversigt over endpoints ID Navn EP_NS1 EP_NS2 EP_NS3 Spoerg_tilmelding_NS [SF1600 EP_DP1 Spoerg_tilmelding_DP] Opdater_borger_NS Tilmeld_NemSMS_NS KOMBIT A/S Halfdansgade København S CVR Side 23 af 33

24 EP_NS4 Afsend_brev_NS [SF1600 EP_DP2 Afsend_brev_DP] Beskrivelse af endpoint EP_NS1 - Spoerg_tilmelding_NS Se [SF1600 EP_DP1 Spoerg_tilmelding_DP, afsnit 3.2.3] Beskrivelse af endpoint EP_NS2 - Opdater_borger_NS Transportspecifikation Serviceudstiller NemSMS er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som OIO-REST Teknisk endpoint OIO-REST kaldet er: HTTP PUT /register/{sysid}/boks/{cpr} for personer eller HTTP PUT /register/{sysid}/boks/{cvr} for virksomheder Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [Udfyldes senere af Systematic] [Udfyldes senere af Systematic] [Udfyldes senere af Systematic] Miljø: Test URI til WSDL Endpoint navn Endpoint IP [Udfyldes senere af Systematic] [Udfyldes senere af Systematic] [Udfyldes senere af Systematic] Teknisk retning for udveksling Serviceplatformen kalder NemSMS. KOMBIT A/S Halfdansgade København S CVR Side 24 af 33

25 Dataretning for udveksling Serviceplatformen overfører borgerens/virksomhedens stamdata til NemSMS Service invokation / Triggers Når et fagsystem på vegne af en borger/virksomhed skal tilmelde borgeren til NemSMS via Serviceplatformen Dataspecifikation Kaldet er specificeret i afsnit A2.3.2 Opret NemSMSbruger / opdater stamdata [Digital Post]. Miljø: Produktion Inputdata SysId CPR-nr (URN urn:oio:cpr-nr:xxxxxxxxxx ) eller CVR-nr (URN urn:oio:cvr-nr:xxxxxxxx ) SlutbrugerStamdata (OIOXML SlutbrugerStamdata.xsd fra [Digital Post]) Outputdata Fejlkode Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem serviceplatformen og NemSMS er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. SP kan gentage operationen hvis der opstår fejl Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid. KOMBIT A/S Halfdansgade København S CVR Side 25 af 33

26 Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_NS3 - Tilmeld_NemSMS_NS Transportspecifikation Serviceudstiller NemSMS er serviceudstiller Serviceanvender Serviceplatformen er serviceanvender Teknologisk understøttelse Snitfladen er implementeret som OIO-REST Teknisk endpoint OIO-REST kaldet er: HTTP PUT /register/{sysid}/boks/{cpr}/myndighedstilmelding for borgere eller HTTP PUT /register/{sysid}/boks/{cvr}/myndighedstilmelding for virksomhed Følgende specificerer endpoint-oplysninger for produktionsmiljø og testmiljø. Miljø: Produktion URI til WSDL Endpoint navn Endpoint IP [Udfyldes senere af Systematic] [Udfyldes senere af Systematic] [Udfyldes senere af Systematic] Miljø: Test URI til WSDL [Udfyldes senere af Systematic] KOMBIT A/S Halfdansgade København S CVR Side 26 af 33

27 Endpoint navn Endpoint IP [Udfyldes senere af Systematic] [Udfyldes senere af Systematic] Teknisk retning for udveksling Serviceplatformen kalder NemSMS Dataretning for udveksling Serviceplatformen overfører borgerens stamdata til NemSMS Service invokation / Triggers Når et fagsystem opretter/opdaterer en borgers stamdata til NemSMS via Serviceplatformen Dataspecifikation Kaldet er specificeret i afsnit A2.3.3 Til- / afmeld en slutbruger til NemSMS er for alle myndigheder [DigitalPost]. [Udfyld specifikation for både input og output data. Dataelementer specificeres med elementnavn, datatype, feltlængde, valgfri/tvungen, evt. bemærkning til anvendelse, og krav til validering.] Miljø: Produktion Inputdata SysId CPR-nr (URN urn:oio:cpr-nr:xxxxxxxxxx ) eller CVR-nr (URN urn:oio:cvr-nr:xxxxxxxx ) Myndighedstilmelding = true (OIOXML Myndighedstilmelding.xsd fra [Digital Post]) Outputdata Fejlkode Miljø: Test Inputdata Outputdata Sikkerhed Sikkerhed mellem serviceplatformen og NemSMS er certifikatbaseret, som defineret i RA STS [STS-Sikkerhed], UC-SEC-06. [Udfyldes med information om den anvendte sikkerhedsmodel] [Gælder for Certifikatbaseret sikkerhed, hvor SP udstiller service, følgende tekst kopieres ind som hjælp til leverandør: For at få adgang til at kalde services på Serviceplatformen er der en række krav der skal være opfyldt i forhold til at identificere serviceaftale, service, kaldende kommune og KOMBIT A/S Halfdansgade København S CVR Side 27 af 33

28 IT-system. Dette gøres i en invocation context, som sendes med. De tekniske detaljer er beskrevet på Serviceplatformen, ( hvor der også ligger vejledning til udviklere, samt demoprojekter.] Leverancesikkerhed og fejlhåndtering At least once. SP kan gentage operationen hvis der opstår fejl Servicemål Følgende underafsnit indeholder oplysninger vedrørende servicemål for aftalt driftstid Aftalt driftstid Parameter Tidsrum Svartid Tilgængelighed Spidsbelastningsperiode Servicevinduer Værdi [Udfyldes med tidsrummet hvor der sikres normal drift] [Udfyldes med angivelse af det maksimale svartid for dataudvekslingen.] [Udfyldes med krav til oppetid indenfor aftalt driftstid fx 99,5 pct.] [Udfyldes med tidsrummet hvor, der forventes spidsbelastning.] [Udfyldes med oplysninger om aftalte servicevinduer og varsling af nedetid.] Beskrivelse af endpoint EP_NS4 - Afsend_SMS_NS Se [SF1600 EP_DP2 Afsend_brev_DP, afsnit 3.2.4] 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. KOMBIT A/S Halfdansgade København S CVR Side 28 af 33

29 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. Derudover: [Afklaring/Programmet: Teststrategi håndteres i programemnelog #1] KOMBIT A/S Halfdansgade København S CVR Side 29 af 33

30 4 Beskrivelse for integrationsplatforme 4.1 Beskrivelse for Serviceplatformen Nærværende afsnit angiver den integrationsfunktionalitet, som Serviceplatformen håndterer i interaktionen mellem integrationsparter. Da NemSMS baserer sig på Digital Post, benyttes disse services fra [SF1600] også for NemSMS, hvor myndigheden har et andet SystemId for NemSMS i forhold Digital Post. 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. Serviceplatformen Fagsystem EP_SP2 EP_SP3 IF01 IF02 EP_NS2 EP_NS3 Digital Post Oversigt over integrationsflows ID Navn IF01 IF02 Opdater Borger NemSMS Tilmeld NemSMS Integrationsflow IF01: Opdater borger NemSMS Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_SP2 Opdater_Borger_SP Afsnit EP_NS2 Opdater_borger_NS Afsnit KOMBIT A/S Halfdansgade København S CVR Side 30 af 33

31 Integrationstype Dette er en gennemstillinsintegration, som opretter eller opdaterer en borger eller en virksomhed i NemSMS. Hvis borgeren er oprettet, bliver borgerens stamdata opdateret Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Fagsystem Serviceplatformen NemSMS Fagsystem opdaterer en borger i NemSMS. Serviceplatformen gennemstiller Opret/Opdater Borger i NemSMS EP_SP2 Opret/Opdater borger EP_NS Datatransformering N/A Datapersistering N/A Databerigelse N/A Routing N/A Orkestrering Ingen Sikkerhed Sikkerheden hos kilde er certifikatbaseret, mens fagsystemerne anvender rammearkitekturens sikkerhedsmodel. Derfor skal serviceplatformen foretage veksling mellem sikkerhedsmodeller som beskrevet i UC-SEC-06 i [SIKKERHED] Logning Ingen særlige krav Testdata og testfaciliter [Indhold afventer generel afklaring af test] KOMBIT A/S Halfdansgade København S CVR Side 31 af 33

32 Konfiguration [Udfyldes med oplysninger om hvilke parametre der skal være konfigurerbare, hvilken personkreds/brugertype der skal have konfigurationsmulighed - og hvor ofte der vil være behov for at ændre konfigurationen.] Supplerende information Integrationsflow IF02: Tilmeld NemSMS Anvendte service endpoints Endpoint ID Navn på endpoint Dokument-reference EP_SP3 Tilmeld_NemSMS_SP Afsnit EP_NS3 Tilmeld_NemSMS_NS Afsnit Integrationstype Dette er en gennemstillinsintegration, som tilmelder en borger eller en virksomhed i NemSMS. Tilmelding kræver at borgeren er oprettet i NemSMS først (se IF02) Diagram over integrationsflowet Jf. figuren nedenfor indgår følgende integrationsflows i integrationen. Fagsystem Serviceplatformen NemSMS Fagsystem tilmelder en borger/ virksomhed til NemSMS Serviceplatformen gennemstiller til NemSMS EP_SP3 Tilmeld NemSMS EP_NS Datatransformering N/A Datapersistering N/A Databerigelse N/A Routing N/A. KOMBIT A/S Halfdansgade København S CVR Side 32 af 33

33 Orkestrering N/A Sikkerhed Sikkerheden hos kilde er certifikatbaseret, mens fagsystemerne anvender rammearkitekturens sikkerhedsmodel. Derfor skal serviceplatformen foretage veksling mellem sikkerhedsmodeller som beskrevet i UC-SEC-06 i [SIKKERHED] Logning Ingen særlige krav Testdata og testfaciliter [Indhold afventer generel afklaring af test] Konfiguration [Udfyldes med oplysninger om hvilke parametre der skal være konfigurerbare, hvilken personkreds/brugertype der skal have konfigurationsmulighed - og hvor ofte der vil være behov for at ændre konfigurationen.] Supplerende information KOMBIT A/S Halfdansgade København S CVR Side 33 af 33