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 samt gives en korrekt beskrivelse af hvad de giver adgang til.

• 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. Læs følgende vejledning for at formulere letforståelige tekster til borgere.

  Godt sprog i Digital Fuldmagt (pdf)

  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 februar 2025

• 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.

• API til Digital Fuldmagt

  Digital Fuldmagt udstiller et SOAP-baseret API med en række forskellige services, hvor oplysninger om digitale fuldmagter kan forespørges. Fuldmagterne repræsenteres som delegeringer af fuldmagtsprivilegier fra fuldmagtsgiver til repræsentant, og et it-system kan kun forespørge på egne fuldmagtsprivilegier.

  Brug af API’erne har den fordel, at det er muligt at forespørge om fuldmagtsprivilegier for en vilkårlig borger og repræsentant. Dette kan bruges ved integration til tjenesteudbyderens interne systemer, fx kundeportaler. En sagsbehandler eller supportmedarbejder kan have behov for at vide, om der findes en fuldmagt. Det er fx relevant, hvis en repræsentant henvender sig via telefon eller e-mail, og sagsbehandleren eller supportmedarbejderen skal bekræfte fuldmagtsforholdet.

  Du finder en WSDL fil for webservicen.

  Delegation webservice for Digital Fuldmagt (WSDL) - version 1

  Delegation webservice for Digital Fuldmagt (WSDL) - indledende version 2

  SOAP API’et er under opdatering, og version 2 af SOAP API’et implementeres endeligt i slutningen af august 2025.

  • Hvis man som myndighed påtænker at tage SOAP API’et i brug inden september 2025, anbefaler vi, at man tager version 1 i brug, da response vil være bagud kompatibelt efter den endelige implementering af version 2. Således vil response for version 2 ligne nuværende response på kald til version 1.
  • Hvis man som myndighed allerede har taget den indledende version 2 i brug, vil man forventeligt skulle foretage tilpasninger efter den endelige implementering i slutningen af august 2025, da den indledende version ikke er bagud kompatibel. Man er velkommen til at kontakte Digital Fuldmagt-forvaltningen for råd og vejledning.

  Digital Fuldmagt-forvaltningen: E-mail

  Fra september kan version 2 af SOAP API’et tages i brug. Alle it-systemudbydere anbefales at migrere til version 2 inden marts 2026, da version 1 herefter ikke længere vil blive vedligeholdt. Migreringen vil fra slut august 2025 alene kræve, at SOAP-action (http header) og endpoint (URL) ændres, så de indeholder v2.

  Endpoints til webservices for Digital Fuldmagt i NemLog-ins miljøer er:

  Version 1:

  Produktionsmiljø:

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

  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

  Indledende version 2:

  Produktionsmiljø:

  https://delegationquery.fuldmagt.nemlog-in.dk/QueryWebServiceV2.svc

  Integrationstestmiljø:

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

  Pre-produktionsmiljø - Devtest4 (prod ben):

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

  Pre-produktionsmiljø - Devtest4 (int ben):

  https://delegationquery-fuldmagt.test-devtest4-nemlog-in.dk/QueryWebServiceV2.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

Fuldmagtspakker med særlige indstillinger

Ønsker I at oprette fuldmagtspakker, der er afgrænset i forhold til fuldmagtsgiverens alder, kan I læse mere her: 

Hvordan virker de særlige indstillinger i forhold til fuldmagtsgivers alder?