Hjælp og vejledning

For at koble en tjeneste til Digital Fuldmagt er der en række trin, I skal gennemføre:

• Trin 1: Tilslutning

  For at tilbyde digital partsrepræsentation til borgere i jeres tjeneste via Digital Fuldmagt, skal jeres organisation være tilsluttet NemLog-in. Det er de fleste offentlige myndigheder allerede i dag. 

  Hvis du som myndighed ikke er tilsluttet NemLog-in, er første step at tilslutte jer. 

  Læs mere om tilslutning

• Trin 2: Opret tjeneste

  Dernæst skal I oprette den tjeneste (it-system), som skal benytte sig af fuldmagtsløsningen, hvis it-systemet ikke allerede er oprettet. Dette gøres via NemLog-in Administration (administration.nemlog-in.dk).

  Som myndighed skal I indrette jeres eget brugerstyringsmodul, så rettighederne, modtaget i SAML-billetter fra NemLog-in, giver fuldmagtshaveren adgang til de relevante dele af jeres løsning. I skal kunne modtage SAML-billetter, som indeholder fuldmagtsgivers identitet samt et antal rettigheder, som fuldmagtsgiveren har afgivet.

  Desuden skal I som myndigheden etablere den nødvendige logning, så der sikres dokumentation for, hvad repræsentanten gør på borgerens vegne i myndighedsløsningen. Dette bør desuden fremgå tydeligt i jeres brugergrænseflade for fuldmagtsgiver hvem, der har udført hvad på baggrund af en fuldmagt, som de har givet. 

  I skal derudover sikre, at fuldmagtshaveren nemt kan se i brugergrænsefladen, hvem vedkommende agerer på vegne af og nemt kan skifte mellem sig selv og fuldmagtsgiver.

• Trin 3: Definér fuldmagtens omfang

  Når du som myndighed har oprettet dit it-system, din selvbetjeningsløsning, skal I definere de (statiske) rettigheder for jeres løsning, som borgere skal kunne give til en repræsentant fx en pårørende. Rettighederne er løsningsspecifikke, så I kan frit vælge, hvorledes disse defineres/scopes. I kan sagtens have flere rettigheder/fuldmagter, til samme løsning for at afgrænse, hvad man kan give fuldmagt til. Det kan fx være delt op i én fuldmagt til at agere (handlingsfuldmagt) og én til at se indhold (læseadgang) i løsningen.

  Rettighederne skal oprettes i NemLog-in via NemLog-in/Administration som privilegier (borgerfuldmagt) samt gives en udførlig beskrivelse, så borgere forstår implikationerne af at afgive rettighederne.  

• Trin 4: Publicering af fuldmagten

  Når I har oprettet det/de ønskede privilegier (skal ligge i produktion før fuldmagten kan publiceres) bedes I læse og udfylde en række informationer omkring jeres fuldmagt blandt andet de tekster der skal vises til borgere. I forbindelse med udfyldelse af tilslutningsskabelonen skal I blandt andet tage stilling til, om fuldmagten i udgangspunktet kun skal være synlig for borgere i specifikke kommuner. Borgerne har dog altid mulighed for at slå den kommunale filtrering fra. Således vil alle borgere kunne tilgå fuldmagten, hvis de har behov for dette.
  
  Skabelonen returneres til NemLog-in på e-mail: digitalfuldmagt@digst.dk

  Hent skabelonen: Tilslutning til Digital Fuldmagt (pdf)

  Når Digitaliseringsstyrelsen har modtaget skabelonen, publicerer vi fuldmagten, så den bliver synlig i brugergrænsefladen for Digital Fuldmagt for borgere. Borgere kan herefter afgive eller anmode om jeres fuldmagt.

  Hvis I ønsker, at fuldmagten skal publiceres på et bestemt tidspunkt, kan dette aftales med Digitaliseringsstyrelsen.

Anvendelse af Digital Fuldmagt

Ønsker I at koble en tjeneste til NemLog-ins fuldmagtsfunktionalitet, kan I finde hjælp i integrationsvejledningen. Guiden er til dig, der skal udføre integrationen og den beskriver relevante aktiviteter, samt de snitflader, som anvendes i integrationen.

Du kan i denne guide læse mere om, hvorledes man som tjenesteudbyder eller it-leverandør kan integrere en borgerrettet tjeneste til Digital Fuldmagt. Den beskriver de relevante aktiviteter samt de snitflader, som anvendes i integrationen.

Åbn den teknisk guide til integration med Digital Fuldmagt (pdf) - opdateret i september 2024

• Digital Fuldmagt omtales som en basal fuldmagtsløsning - men hvorfor og hvad betyder det?

  Der findes en lang række forskelligartede behov inden for fuldmagtsområdet og derfor blev der i første omgang valgt at etablere en fuldmagtsløsning, der fokuserer på basale behov, der går igen hos mange myndigheder. Med andre ord: fællesoffentlige behov. Selvom løsningen er bygget op omkring basale behov til en start, er der planer om løbende at udvikle løsninger på baggrund af de behov, der måtte vise sig.

  Det basale består primært i to afgrænsninger:

  • Digital Fuldmagt integreres ikke med eksterne registre, som kunne bibringe viden om forældremyndighed, værgemål, betalingsstandsninger, konkurser med videre. Hvis myndigheder har behov for sådanne oplysninger i relation til fuldmagter, skal de selv indhente dem.
  • Afgivelse af en fuldmagt skal ses som delegering, altså en afgivelse, af statiske rettigheder fra en borger til en repræsentant fx en pårørende (til en digital selvbetjeningsløsning). Begrebet statiske rettigheder forklares nedenfor, men overordnet set betyder det at der er grænser for, hvor detaljeret og afgrænset fuldmagten kan blive. Eksempelvis kan man i løsningen godt give en pårørende fuldmagt til at se alle ens sager hos en offentlig myndighed, men ikke fuldmagt til én specifik sag identificeret ved et sagsnummer, da fuldmagtsløsningen ikke kender sagsnumrene hos myndighederne.
• Statiske rettigheder versus komplekse rettigheder

  Rettigheder kan ofte karakteriseres ud fra følgende tre aspekter:

  a) Handlingen som må udføres fx adgang til at læse, skrive, slette, indberette, ansøge, klage og så videre
  b) Objektet som handlingen udføres på (dataudsnit) fx et CVR-nummer, et CPR-nummer, en sag, en skattemappe, en postfolder, en journal, en konto, en høring og så videre. Objekter er i sagens natur ofte løsningsspecifikke og dynamiske.
  c) Parametre som nærmere afgrænser rettigheden fx beløbsgrænse, dato og så videre.

  Som eksempel kan nævnes rettigheden ”må overføre penge (handling) fra konto 12345678 (objekt) op til 20.000 kr. (parameter)” eller ”må bestille rejser (handling) for medarbejdere hørende til salgsafdelingen (objekt)”.

  Ved parametriserede rettigheder forstås, at brugeren i fuldmagtsløsningen indtaster nogle parametre, der præciserer fuldmagten, som fx beløbsgrænse eller sagsnummer. Brugeren kan eventuelt få hjælp til dette ved drop down bokse eller lignende. Ved dynamiske rettigheder forstås, at fuldmagtsløsningen via integration til myndighedsløsningen dynamisk henter de relevante objekter, som der kan gives fuldmagt til.

  Hvis man medtager alle tre aspekter i en rettighedsmodel for en løsning, vil det både give mulighed for at udtrykke rettigheder meget præcist (og dermed også fuldmagter til en repræsentant) – men det vil på den anden side medføre stor kompleksitet i håndteringen. Derfor er mange løsninger baseret på en mere simpel model, hvor kun handlingen angives eksplicit og objektet enten er underforstået af sammenhængen eller kun angives på overordnet niveau som eksempelvis et CVR-nummer eller CPR-nummer. Sådanne rettigheder benævnes ofte for simple eller statiske rettigheder (modsat dynamiske rettigheder) og kan udtrykkes som rettighedsattributter (ofte benævnt simple claims) i en SAML billet. Altså den billet, som myndigheden modtager, når en bruger logger ind i deres selvbetjeningsløsning.

   

  Digital Fuldmagt kan håndtere statiske rettigheder fx:

  • "Må se dokumenter i min skattemappe"
  • "Må indberette min indkomstskat"
  • "Må søge om boligstøtte på mine vegne"
  • "Må se mine dokumenter i Digital Post"
  • ”Må læse min e-journal”
  • "Må melde min flytning”
  • "Må indsende klage på mine vegne"
  • "Må tilmelde mig til studier i studieåret 2020/2021" og så videre

   

  Digital Fuldmagt kan på nuværende tidspunkt ikke håndtere mere komplekse og dynamiske rettigheder fx:

  • "Må se mine dokumenter fra folderen mine regninger i digital post" (brugerdefineret mappe)
  • "Må tilgå min sag med sagsnumer 139839283" (dynamisk objekt hos myndighed)
  • "Må tilmelde mig til studiet Dansk Hovedfag som første prioritet og Samfundsfag som anden prioritet på Københavns Universitet i studieåret 2020/2021"

  Bemærk, at nogle af ovenstående eksempler er fiktive og forudsætter, at de pågældende selvbetjeningsløsninger er tilsluttet Digital Fuldmagt.

• Opsætning af webservice kald

  NemLog-in SOAP-baserede web service grænseflader udstiller X forskellige webservice kald, hvor fuldmagtsprivilegier kan forespørges. Web service grænsefladerne har den fordel, at det er muligt at forespørge om fuldmagtsprivilegier for en vilkårlig bruger (repræsentant) eller for en organisation. Dette kan eksempelvis anvendes ved integration til tjenesteudbyderens interne systemer som fx i kundeportaler, hvor en sagsbehandler eller supportmedarbejder kan have behov for at vide, om der foreligger en fuldmagt fx hvis repræsentanten henvender sig via telefon eller e-mail, og sagsbehandleren har brug for at kontrollere, om der foreligger et fuldmagtsforhold i forhold til henvendelsen.

  De forskellige kald kan returnere fx et responseID, oprettelsesdato, udløbsdato, borgerens navns med videre, som kan udstilles i jeres interne systems brugergrænseflade, så medarbejdere nemt kan tjekke om der findes et gyldigt fuldmagtsforhold.

  Bemærk, at I bør anvende prod benet i pre-produktionsmiljøet (Devtest4-miljøet), ikke de andre testmiljøer, hvis I forsøger at integrere til metoden GetDelegationsByServicePrivilege. 

  Du finder en WSDL fil for webservicen.

  Delegation webservice for Digital Fuldmagt (WSDL)

  Endpoints til web services for Digital Fuldmagt i NemLog-ins testmiljøer er:

  Integrationstestmiljø:

  https://delegationquery.fuldmagt.test-nemlog-in.dk/QueryWebService.svc

  Pre-produktionsmiljø - Devtest4 (prod ben):

  https://delegationquery-fuldmagt.devtest4-nemlog-in.dk/QueryWebService.svc

  Pre-produktionsmiljø - Devtest4 (int ben):

  https://delegationquery-fuldmagt.test-devtest4-nemlog-in.dk/QueryWebService.svc
• Fuldmagt til telefonisk eller skriftlig kontakt

  Ønsker I som myndighed at give borgere mulighed for digitalt at kunne oprette en fuldmagt til den skriftelige og/eller telefoniske kontakt, kan I opnå dette ved at opsætte et webservicekald til fuldmagtsløsningen. 

  I jeres fagsystem kan I implementere et webservicekald, som gør det muligt for en medarbejder at forespørge, om en borger har en fuldmagt.

  

  Se et interaktivt eksempel på, hvordan et webservicekald kan integreres i et fagsystem