Hjælp og vejledning

Anvendelse af Digital Fuldmagt

Informationspakken er til jer som en myndighed, som overvejer integration til Digital Fuldmagt. I kan i informationspakken læse mere om løsningens:

funktionalitet, herunder forskellige brugerrejser,
juridiske grundlag, supportstrukturen omkring løsningen, mm.

Du finder også en række emner, der kan være væsentlige at overveje i forbindelse med integrationen.

Digital Fuldmagt - Informationspakke til myndigheder (pdf) - opdateret august 2025

Integrationsvejledningen er til jer, der skal udføre integrationen teknisk og den beskriver relevante aktiviteter, samt de snitflader, som anvendes i integrationen.

Du kan i denne guide læse mere om, hvordan man som tjenesteudbyder eller it-leverandør kan integrere en borgerrettet tjeneste til Digital Fuldmagt. Den beskriver:

de relevante aktiviteter
de snitflader, som anvendes i integrationen.

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

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

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

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?

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.

SOAP API’et er blevet udvidet med en version 2. Alle it-systemudbydere, der i dag anvender version 1 af SOAP API’et, anbefales at overgå til version 2 inden marts 2026. Herefter vil version 1 ikke længere blive vedligeholdt.

Hvis I som it-systemudbyder anvender version 1 og skal overgå til version 2

I skal opdatere:

Endpoint (URL) (tilføj V2)
SOAP Action header (https) (tilføj V2)

Version 2 ligner version 1. Dette betyder at navne på elementer og deres indhold er det samme som i version 1, hvorfor det alene er ovenstående der skal opdateres. Der er tilføjet et nyt element <Constraints> i version 2, som kan anvendes af it-systemudbydere, når det i fremtiden bliver muligt at opsætte dynamiske dataafgræsninger på fuldmagter. På nuværende tidspunkt vil elementet <Constraints> være tomt i svar på API-kald, og derfor vil det ikke være nødvendigt at behandle det.

For spørgsmål om overgangen til SOAP API version 2, kan man kontakte:

Digital Fuldmagt Forvaltningen: E-mail

Hvis I som it-systemudbyder skal integrere til version 2

I skal bruge WSDL-fil og endpoints nedenfor.

WSDL-filer og endpoints

Delegation webservice for Digital Fuldmagt (WSDL) - version 2

Delegation webservice for Digital Fuldmagt (WSDL) - version 1

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

Øvrige emner

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