For at få adgang til Dataforsyningens download, API’er og webservices kræver det, at man identificerer sig ved hjælp af brugernavn og adgangskode eller en token samt anvender HTTPS protokollen.

Login med brugernavn og adgangskode

Dit brugernavn og adgangskode benyttes til at logge ind på Dataforsyningens hjemmeside og FTP.

Når du er logget ind på dataforsyningen.dk har du adgang til at:

• hente data klar til download
• administrere dine tokens til API’er og webservices
• tilmelde nyhedsbreve og beskeder
• administrere dine brugeroplysninger
• oprette underbrugere (for de brugere der har aftale om adgang til adgangsbegrænsede data)

Har du brug for at downloade data direkte fra FTP, kan du benytte samme brugernavn og adgangskode. Adgang til FTP sker via ftp.dataforsyningen.dk

Authentication - login med token

Token benyttes i webapplikationer og GIS systemer, når du kalder API’er og webservices. Dataforsyningen er stateless, derfor skal token altid sendes med hver forespørgsel til Dataforsyningen, undtagen alle DAWA og Inspire OGC-services.

Du skal være oprettet som bruger på Dataforsyningen og være logget ind, for at oprette og administrere dine tokens på Dataforsyningen.:

1. Klik på brugerikonet øverst i højre hjørne

2. Gå til "Administrer token til webservices og API’er"

3. Klik på ”Opret ny token”

Der bliver generet en token bestående af tilfældige tal og har et navn af tilfældige bogstaver og tal. Du kan ændre navnet på dine tokens, det anbefales hvis du bruger dine tokens til fx et fagsystem eller en specifik webløsning. Du kan også definere udløbsdata for tokens.

Token benyttes til at identificere sig overfor Dataforsyningen uden risiko for at afsløre brugernavn og adgangskode. Det kan fx være relevant, hvis Dataforsyningens webservices er implementeret i webapplikationer tilgængelige for alle på internettet.

Token skal angives på én af følgende måder i requesten:

1. Som header parameteren "token" (anbefaler vi at bruge, da det er den mest sikre måde)

https://api.dataforsyningen.dk/{servicenavnet på tjenesten}

Headers:

token: {DinToken}

2. Som queryparameter "token" i URL'en

https://api.dataforsyningen.dk/{servicenavnet på tjenesten}?token={DinToken}

En gyldig URL vil fx se således ud:

HTTPS og TLS

Der skal anvendes TLS, Transport Layer Security, for at sikre transmissionen mod aflytning. TLS skal være minimum version 1.2. Nogle ældre operativsystemer eller klienter understøtter muligvis ikke dette, så i disse tilfælde skal der opgraderes eller ændres indstillinger. Dette gøres ved at anvende HTTPS protokollen i stedet for HTTP.
Ved brug af HTTPS kan man også undgå Browser advarsler når man blander sikkert og usikkert indhold. Det kunne f.eks. være i sammenhæng med brug af NemID.