Vilkår for integration til SAPA Dialogintegration KOMBIT A/S Halfdansgade 8 2300 København S Tlf 3334 9400 www.kombit.dk kombit@kombit.dk CVR 19 43 50 75 Side 1/5
Dokumenthistorik Dato Version Ansvarlig Kommentar til ændringer i version 01.05.2014 1.0 KLR / SAPA Første version offentliggjort 1. Indledning og vejledning Dette notat beskriver de integrationsvilkår, der gør sig gældende for systemer, der ønsker at integrere med SAPA i relation til den såkaldte Dialogintegration, også betegnet som hop fra - og til - SAPAs brugergrænseflade. SAPA Dialogintegration har til formål, at understøtte en smidig transport af en bruger fra SAPA it-løsningens brugergrænseflade til brugergrænsefladen i en anden sagsbærende it-løsning (ESDH-/fagsystem). Dialogintegration er en del af SAPA-systemet idet SAPA tillader en sagsbehandler, der arbejder i SAPA-systemet, at hoppe fra en konkret sag, ydelse, eller dokument i SAPAs brugergrænseflade til den konkrete sag eller dokument i det ESDH-/fagsystem, hvor sagen bor. Behovet opstår, såfremt brugeren har behov for yderligere detaljer end det der vises i SAPA eller der er behov for videre sagsbehandling med konkret registrering af oplysninger direkte i ESDH- /fagsystemet. På samme vis understøtter SAPA Dialogintegration hop fra et ESDH-/Fagsystem til SAPAs sags- og parts-overblik. KOMBIT A/S Halfdansgade 8 2300 København S Tlf 3334 9400 www.kombit.dk kombit@kombit.dk CVR 19 43 50 75 Side 2/5
Dialogintegration, som mekanisme til hop fra SAPA til andre sags-bærende itsystemer (og vice versa), baserer sig på en række forudsætninger til de involverede systemer, der er skitseret herunder: Adressering: Hop fra SAPA til et andet it-system kræver, at det modtagende systems endpoint er stillet til rådighed for SAPA på forhånd. Udveksling af parametre: De enkelte fagsystemer, der hoppes til fra SAPA, skal kunne modtage og forstå et af SAPA foruddefineret sæt af parametre, der medtages som led i hoppet (f.eks. cpr-nr., sags-id, dokument-id, etc.). Oversættelse af bruger-kontekst til relevante skærmbilleder: Det modtagende it-system skal indeholde en funktionel komponent, der ved kald/viderestilling fra SAPA, kan fortolke brugerens kontekst (i form af de medsendte parametre) med henblik på at kunne dirigere brugeren til specifikke skærmbilleder og objekter i det modtagende system. Eksempelvis sags-oversigter, sags-dialoger og dokument-detaljer. Autentifikation/autorisation: Det system der hoppes til er ansvarlig for at kunne autentificere og autorisere den enkelte bruger, hvad enten det er på basis af separat login eller ved sammenligning af de medsendte brugerparametre med systemets eget brugerregister. Heraf følger, at systemet ligeledes er ansvarlig for at afvise brugere, der har fulgt et link de ikke har rettigheder til. 1.1 Definitioner Begreb Kaldende applikation Modtagende applikation Dialogintegration Definition Den applikation, der initierer en dialogintegration. Den applikation, som modtager og afvikler dialogintegration. Dialogintegrationen sker i brugergrænsefladen og er defineret som en situation hvor brugeren eksekverer en handling, hvorigennem brugeren ledes fra en dialog KOMBIT A/S Halfdansgade 8 2300 København S Tlf 3334 9400 www.kombit.dk kombit@kombit.dk CVR 19 43 50 75 Side 3/5
(skærmbillede) i den kaldende applikation over i en dialog (skærmbillede) i den modtagende applikation. Dialogintegration omtales også som hop mellem applikationer. Endpoint Den specifikke URL/sti udstillet af den modtagende applikation, hvortil brugeren og dennes kontekst i form af parametre, videresendes. Parametre overføres til den modtagende applikation, ved at eksekvere en https request i stil med: [Protokol]://[endpoint modtagende applikation]?[parametre] Det modtagende system er ansvarligt for at kunne fortolke de medsendte parametre og dirigere brugeren videre til den ønskede dialog i systemet (eksempelvis til den konkrete sag eller dokument). Parametre De medsendte parametre fra den kaldende applikation, adskilt af &. 2. Vilkår til it-systemers anvendelse af SAPA Dialogintegration Der sondres i de følgende vilkår mellem to forskellige scenarier Vilkår i forbindelse med hop fra SAPA Vilkår i forbindelse med hop til SAPA 3. Vilkår for hop fra SAPA til ESDH-/fagsystemer Dette afsnit indeholder vilkår for hop fra SAPA til ESDH-/fagsystemer. 3.1 Udstilling af endpoint Det modtagende system skal stille et endpoint til rådighed for SAPA, hvortil viderestilling af SAPA brugere og deres kontekst kan rettes. 3.2 Udveksling af parametre Det modtagende system skal kunne modtage og forstå et fast, foruddefineret sæt af parametre, der medtages som led i hoppet (defineret som SAPAs parameter-model). For SAPA dialogintegration er identificeret følgende relevante parametre: Brugerident (identifikation af den pågældende bruger/sagsbehandler) Partsident (identifikation af den pågældende borger) KOMBIT A/S Halfdansgade 8 2300 København S Tlf 3334 9400 www.kombit.dk kombit@kombit.dk CVR 19 43 50 75 Side 4/5
Sagsident (identifikation af den specifikke sag i modtagersystemet) Dokumentident (identifikation af det specifikke dokument i modtagersystemet) Kommuneident (identifikation af den relevante kommune) Systemident (identifikation af det kaldende system) SAML token (med henblik på Single Sign-On) 3.3 Kontekstfortolkning Det modtagende system skal indeholde en funktionel komponent, der ved kald/viderestilling fra SAPA, kan fortolke brugerens kontekst (i form af de medsendte parametre) med henblik på at kunne dirigere brugeren til specifikke skærmbilleder og objekter i det modtagende system (eksempelvis specifikke sager og dokumenter). 3.4 Autentifikation/autorisation af brugere Det modtagende system er ansvarligt for at kunne autentificere og autorisere den enkelte bruger, hvad enten det er på basis af separat login eller ved sammenligning af de medsendte brugerparametre med systemets eget brugerregister. Heraf følger, at systemet ligeledes er ansvarlig for at afvise brugere, der har fulgt et link de ikke har rettigheder til. 4. Vilkår for hop fra ESDH-/fagsystemer til SAPA Dette afsnit indeholder vilkår for hop fra ESDH-/fagsystemer til SAPA. 4.1 Kald af endpoint Det kaldende system skal rette viderestilling af bruger og dennes kontekst til det endpoint SAPA udstiller. 4.2 Udveksling af parametre Det kaldende system skal som led i viderestillingen af sine brugere til SAPA, medtage parametre, der overholder SAPAs parameter-model. KOMBIT A/S Halfdansgade 8 2300 København S Tlf 3334 9400 www.kombit.dk kombit@kombit.dk CVR 19 43 50 75 Side 5/5