OIO standardservice til Advis. Generel servicevejledning. KMD Sag Version KMD A/S Side 1 af 22. Juli 2013 Version 1.

Transkript

1 OIO standardservice til Advis Generel servicevejledning KMD Sag Version KMD A/S Side 1 af 22

2 Generel servicevejledning til OIO Advis Ekstern standardservice Opdateret KMD A/S Side 2 af 22

3 Indholdsfortegnelse 1. Version Generelt Servicevejledningernes opbygning Servicevejledningernes formål Brug af servicevejledningerne Kontakt Begrebsliste Kort beskrivelse af KMD Sag KMD Sag Advis... 6 Adviser er meddelelser til en bruger om forhold, som brugeren skal undersøge Forudsætninger for anvendelse af OIO Advis Forretningsregler Hvor genfindes servicens indhold i KMD Sag Hændelsestypeplan Operationer Distribution af WSDL filer Servicens arkitektur Teknisk implementering OIOXML Sikkerhed Certifikater Autorisation Skemavalidering Bilag 1 Hvor genfindes servicens felter i KMD Sags dialog Referenceliste KMD A/S Side 3 af 22

4 1. Version Version Dato Ændring Version Diverse formuleringer ændret. 2. Generelt 2.1 Servicevejledningernes opbygning Der er udarbejdet følgende servicevejledninger Generelle servicevejledninger, til hhv. Sag, Dokument og Advis, som indeholder information om KMD s standardservices, som er gældende for alle de operationer som stilles til rådighed Specifikke servicevejledninger for hver af de operationer som stilles til rådighed 2.2 Servicevejledningernes formål Det er vejledningernes formål at give KMD s kunder og deres leverandører den information som er nødvendig for at der kan indgås aftale om et konkret implementeringsforløb. Dette igangsættes, når der er indgået kontrakt og KMD har modtaget en Anmodningsblanket om tilslutning Se Tilslutningsguide at være et redskab til støtte for kommunikationen mellem kunde, leverandør og KMD under implementeringsforløbet 2.3 Brug af servicevejledningerne Beskrivelserne må ikke overdrages eller kopieres i videre omfang end forudsat i Ophavsretsloven, men kun udlånes til softwareleverandører i forbindelse med etablering af servicerne og ved ændringer i disse. 2.4 Kontakt Henvendelser vedr. servicevejledningerne og spørgsmål til servicerne i øvrigt kan ske til sagsnitflade@kmd.dk KMD A/S Side 4 af 22

5 3. Begrebsliste Begreb AWS Certifikat EWS ITST KSP/CICS KWS OCES OWSA Model T 1.0 OIO OIOXML RACF SSL URI URN UUID WSDL KMD Sag Ejerskab KMD Sag Fordeling Beskrivelse KMD s Applikation Web Services Et certifikat er et digitalt identitetsbevis. Det bliver udstedt af et certificeringscenter og indeholder en række oplysninger om brugeren (certifikatholderen). KMD s Eksterne Web Services (udenfor CAP/IP) IT- & Telestyrelsen KMD s SikkerhedsProdukt til CICS KMD s interne Web Services (indenfor CAP/IP) Standarden for digital signatur, den såkaldte OCES-standard, hvor OCES står for Offentlige Certifikater til Elektronisk Service. OIO Web Service Arkitekturen, model T (OWSA Model T 1.0) angiver en punkt-til-punkt forbindelse mellem 2 sikkerhedsdomæner, hvor der er én serviceaftager og én serviceudbyder. Offentlig Information Online. Betegnelse for obligatorisk, åben standard for dataudveksling mellem offentlige myndigheder. Resource Access Control Facility. Anvendes af KMD til bla. identifikation og verifikation af bruger via bruger-id og password. Secure Sockets Layer. Protokol til krypteret kommunikation via internettet. Uniform Resource Identifier. Anvendes til at identificere et navn eller ressource, fx vha. en URL. Uniform Resource Names. En åben, ikke-proprietær standard, der tilbyder en identifikator uafhængig af placering. Universally Unique Identifier, standardiseret unik identifikator. Web Services Description Language, et XML-baseret sprog, som beskriver webtjenester, herunder hvilke data, som udveksles og hvilken protokol, der anvendes. KMD Sag modulet Ejerskab bruges til at registrere ejerskabet det myndighedsmæssige ansvar - af sager og journaler på afdelinger. Afdelingerne skal være defineret i LOS. I Ejerskab er det muligt at oprette ejerskabsregler pr. KLE-nr. og her bestemme, hvilken Sikkerhedsenhed, sager med dette KLE-nr. skal have. Ejerskabet er altså bestemmende for, hvem der kan få adgang til sagerne. KMD Sag modulet Fordeling bruges til elektronisk at fordele sager, adviser og journaler til den enkelte sagsbehandler eller sagsbehandlergruppe i kommunen. Sagsbehandlergrupperne skal være defineret i LOS, og sagsbehandlerne skal være oprettet i KSP/CICS. I Fordeling er det muligt at oprette fordelingsregler pr. KLE-nr. og her bestemme, hvilken sagsbehandler el. sagsbehandlergruppe sager med dette KLE-nr. skal have. KMD A/S Side 5 af 22

6 4. Kort beskrivelse af KMD Sag KMD Sag er en overordnet betegnelse for KMD s sagsstyringskoncept og omfatter flere moduler. KMD Sag kan betragtes som sagsbehandlerens værktøjskasse ved sagsbehandling og integration til andre systemer. KMD Sag skaber overblik og samler oplysninger om dokumenter, journalnotater, adviser og erindringer. Til KMD Sag hører desuden en række forskellige administrationsmoduler, som anvendes til at tilpasse den enkelte kommunes brug af systemet. Indstillingerne i administrationsmodulerne gælder for hele kommunen og ikke for enkelte afdelinger eller brugere. Yderligere information i form af vejledninger til installation, autorisation og daglig brug af KMD Sag kan findes via KMD's hjemmeside KMD Sag Advis Adviser er meddelelser til en bruger om forhold, som brugeren skal undersøge. 5. Forudsætninger for anvendelse af OIO Advis Det er en forudsætning for anvendelse af OIO Service til Advis, at kunden anvender KMD Sag Basis, der inkluderer Advis løsningen. KMD A/S Side 6 af 22

7 6. Forretningsregler Forretningsreglerne for servicerne følger, så vidt det er muligt, de regler som er gældende for adviser oprettet fra KMD's fagsystemer. Følgende regler gælder specifikt for adviser som oprettes, importeres, rettes eller slettes via OIO servicerne Ved brug af servicerne kontrolleres om der er registreret en tilslutningsaftale for den pågældende leverandør Ved oprettelse af et advis tildeles dette en unik UUID Ved import af et advis kontrolleres om UUID en er unik og ikke findes i KMD Sag i forvejen Det kan i servicen angives, om et advis skal være låst eller ej. Er adviset låst, kan status på adviset ikke ændres via dialogen i KMD Sag, men alene via OIO servicen Sikkerhedsenhed Det er kunden, der skal overveje og beslutte, hvordan sikkerhedsenheden skal tilknyttes sagen ud fra en vurdering af nedenstående regelsæt og dets konsekvenser. - Hvis der medsendes en tilknyttet sag på adviset, anvendes sikkerhedsenheden fra denne sag - Hvis der ikke medsendes en tilknyttet sag på adviset, men der findes en sag på advisparten med samme KLE-nr. som adviset har, anvendes sikkerhedsenheden fra denne sag - Hvis der ikke medsendes en sag og der heller ikke findes en sag på samme personnummer og med samme KLE-nr., anvendes sikkerhedsenheden fra KMD Sag Ejerskab - Hvis der ikke i KMD Sag Ejerskab findes en regel for tildeling af sikkerhedsenhed, anvendes kommunens øverste administrative enhed Sagsbehandler/-gruppe og ansvarlig afdeling Det er kunden, der skal overveje og beslutte, hvordan sagsbehandler/-gruppe og ansvarlig afdeling skal tilknyttes sagen ud fra en vurdering af nedenstående regelsæt og dets konsekvenser. - Hvis der medsendes en tilknyttet sag på adviset, anvendes sagsbehandler/-gruppe og ansvarlig afdeling fra denne sag - Hvis der ikke er en tilknyttet sag, hvorfra oplysningerne kan anvendes, men sagsbehandler/-gruppe og ansvarlig afdeling medsendes, anvendes disse KMD A/S Side 7 af 22

8 - Hvis der medsendes en sagsbehandler/-gruppe, men ikke en ansvarlig afdeling, anvendes den medsendte sagsbehandler/- gruppe og ansvarlig afdeling hentes fra KMD Sag Fordeling. Hvis der ikke findes regel i KMD Sag Fordeling sættes ansvarlig afdeling til øverste administrative enhed - Hvis der ikke medsendes en sagsbehandler/-gruppe, men en ansvarlig afdeling, anvendes den ansvarlige afdeling, og der anvendes en sagsbehandlergruppe svarende til kommunens øverste administrative enhed. Sagsbehandler bliver blank - Hvis hverken sagsbehandler/-gruppe eller ansvarlig afdeling medsendes, men der findes en sag på samme personnummer og med samme KLE-nr., anvendes oplysningerne fra denne sag - Hvis hverken sagsbehandler/-gruppe eller ansvarlig afdeling medsendes, og der heller ikke findes en sag på samme personnummer, hvorfra oplysningerne kan anvendes, hentes oplysningerne fra KMD Sag Fordeling. Hvis der ikke findes regel i KMD Sag Fordeling sættes til øverste administrative enhed Hvis der ikke medsendes en handlingsfacet, sættes denne default til G01 Hvis der medsendes en tilknyttet sag, anvendes dennes primære part i stedet for advisparten, som ignoreres. Hvis der medsendes en tilknyttet sag, anvendes dennes KLE-nr., og et eventuel medsendt KLE-nr. ignoreres Når et advis slettes via servicen, er der ingen logning af, at det pågældende advis har eksisteret og efterfølgende er blevet slettet I nogle af servicens felter skal der angives kaldenavnkort. Kaldenavnkort er en obligatorisk oplysning, Kaldekort, som knytter sig til de administrative enheder som oprettes i LOS. 7. Hvor genfindes servicens indhold i KMD Sag I Bilag 1 vises en oversigt over, hvor servicens felter vises i KMD Sags dialog. 8. Hændelsestypeplan En hændelsestypeplan er en hierarkisk klassifikation af hændelser. Hver leverandør skal oprettes med en landsdækkende hændelsestypeplan. De hændelsesnumre, som medsendes i servicen, skal være kendt i hæn- KMD A/S Side 8 af 22

9 delsestypeplanen. Planens indhold aftales på det/de afklaringsmøder, der finder sted som en del af implementeringsprocessen. Læs mere om implementeringsprocessen i Tilslutningsguiden til OIO Standardservices. 9. Operationer Følgende operationer er implementeret Opret Opretter et advis. Importer Importerer et advis. Ret Retter (ændrer) status på et advis. Slet Sletter et advis. 10. Distribution af WSDL filer WSDL filer mm. kan desværre ikke sendes via , da de stoppes af viruskontrol. De hentes derfor via KMD s distributionscenter. De nødvendige oplysninger om leverandøren, til brug for registrering på distributionscentret, oplyses i forbindelse med Anmodningsblanket om tilslutning. Læs mere om Anmodningsblanket om tilslutning i Tilslutningsguiden til OIO Standardservices KMD A/S Side 9 af 22

10 11. Servicens arkitektur Systemskitse og sikkerhedsmodel: Klient PC (Anvender-certifikat) OCES CA (NETS_DANID) Validering af: Anvendercertifikat 3. part Service (Anvender-certifikat) OIOXML EWS TDC Rodcertifikat (SOCES) Eksternt KMD XML Tilslutningsaftale bekræftes KWS Certifikat oversættes til RACFid Internt KMD Anvender Certifikater: (OCES) MOCES: Medarbejdercertifikat FOCES: Funktionscertifikat Applikationskomponent Advis KMD Sag SOCES: Servercertifikat Figur 1. KMD A/S Side 10 af 22

11 12. Teknisk implementering KMD anvender en teknisk driftsmodel, der udbyder mainframeservices efter OWSA-T modellen, til webservices på EWS en. Det vil sige, at services opfører sig som online services med en bruger tilknyttet. Der er ingen asynkrone led. Der vil således returneres svar om operationen er gået godt eller ej. Anvendere af servicen skal derfor overholde OWSA-T standarden. (Yderligere information findes på OIOXML OIOXML bruges til datatyper i Eksterne Web Services (EWS). EWS baseres på sikkert transport via OIO Web Service Arkitektur, model T (OWSA-T), som består af: WS-I Basic Profile 1.1 & Simple SOAP Binding Profile 1.0 HTTPS vha. OCES certifikater (datakryptering og autentifikation) OIOXML XML Schemaer, WSDL filer kan rekvireres på følgende mailadresse sagsnitflade@kmd.dk 12.2 Sikkerhed Data leveres via 3. part Web Service, som følger OIOXML-standarden med brug af certifikat, leveret over SOAP protokollen (se også figur 1). Sikkerheden håndteres af SSL, og implementeres ved hjælp af OCES certifikater, som skal installeres på den klientmaskine, der skal kalde en eller flere webservices Certifikater Det er det afsendende systems ansvar at garantere brugerens identitet. Brugeren identificeres via det medsendte anvender-certifikat, medarbejdereller funktionscertifikat, som omsættes af KSP til den KMD-brugerid, RACF_ID, som certifikatet er knyttet til. Det er kommunen, som bestiller de certifikater, man ønsker at anvende. Læs mere om certifikater i Tilslutningsguiden til OIO Standardservices KMD A/S Side 11 af 22

12 12.4 Autorisation Den RACF_ID, som det medsendte anvender-certifikat omsættes til skal være tildelt rolleprofilen SAG-SA-R, der autoriserer brugeren til de operationer (opret, importer, ret og slet advis) som stilles til rådighed. Læs mere om autorisationer i Tilslutningsguiden til OIO Standardservices Det er kommunens sikkerhedsansvarlige, som opretter RACF_brugeren i KSP/CICS og tildeler de relevante autorisationer Skemavalidering Der foretages en skemavalidering af XML for overholdelse af bla. version, format og gyldighed af tags i henhold til den givne operation. Data pakkes ud via KWS en, så de kan modtages af KMD Sag Advis applikationskomponenten. KMD A/S Side 12 af 22

13 13. Bilag 1 Hvor genfindes servicens felter i KMD Sags dialog OIO NAVN Feltnavn KMD Sag Fig. 1 AdvisDato Dato 1 2 BeskrivelseTekst Beskrivelse 1 3 TitelTekst Hændelse og Hændelse tekst kolonnerne i Advisoversigten 7 4 FremdriftStatusKode Status 1 5 FremdriftStatusDato Igangsat d./af eller Færdiggjort d./af 1 6 Ansvarlig Afdeling 1 7 Ejer Org.nr. 1 8 FordelTil Sikkerhedsenhed 1 9 PrimaerBehandler Sagsbehandler 1 10 PrimaerKlasse Sagstype 1 11 TilknyttedeSager Sag, logisk tilknyttet sag 1 AdvisPart 12 PartTypeKode Vises uden ledetekst 2/3 13 PartIdentifikator (primær part) Vises uden ledetekst 1 14 PartTilhoersKommuneKode Vises uden ledetekst 3 15 PartNavn Vises uden ledetekst 2 HaendelsePart 16 PartTypeKode Hændelse vedr. Vises kun for Ejendom, Produktionsenheds og Virksomhedsparter 4 Vises for alle parter på Advisoversigten 17 PartIdentifikator Hændelse vedr PartTilhoersKommuneKode Hændelse vedr. Vises kun for Ejendomsparter i fremmede kommuner Gælder både på Advisoversigten og på detaljebilledet 5 KMD A/S Side 13 af 22

14 OIO NAVN Feltnavn KMD Sag Fig. 19 PartNavn Hændelse vedr. Vises kun for Frittekst parter 20 PartRolleKode Vises ikke 1 21 PartRolleTekst Relation 1 22 DitriktTypeKode Distriktstype 2 23 DistriktIdentifikator Distrikt 2 24 HaendelsesIdentifikator Hændelse 1 25 HaendelsesNavn Vises ikke - 26 HaendelsesTekst Hændelse 1 27 HaendelsesDato Hændelsesdato 1 28 LeverandoerKode Vises ikke - 6 KMD A/S Side 14 af 22

15 / Fig. 1 KMD A/S Side 15 af 22

16 12/ Fig. 2 KMD A/S Side 16 af 22

17 12/14 Fig. 3 KMD A/S Side 17 af 22

18 16 Fig. 4 KMD A/S Side 18 af 22

19 18 Figur 5 KMD A/S Side 19 af 22

20 19 Figur 6 KMD A/S Side 20 af 22

21 3 Figur 7 KMD A/S Side 21 af 22

22 14. Referenceliste 1. OWSA Model T version 1.0; IT- og Telestyrelsen, Specifikation af serviceinterface for Dokument, OIO-udvalget for sags- og dokumentområdet, version 1.1; IT- og Telestyrelsen, Generelle egenskaber for serviceinterfaces på sags- og dokumentområdet; OIO-udvalget for sags- og dokumentområdet; IT- og Telestyrelsen, Brugervejledning til sikkerhedsadministratorer KSP/CICS- Administration; KMD håndbog KMD-HDB-086; KMD A/S Unikke Identifikatorer til digitale objekter; Standardisering; IT- og Telestyrelsen, Vejledning om anvendelse af obligatoriske, åbne standarder for software i det offentlige; IT- og Telestyrelsen, KMD A/S Side 22 af 22