I Datafordeler Administration er data tilgængeligt via tre

autentifikationsmetoder. 

Vær opmærksom på at adgang via autentifikationsmetoderne API-key, Shared Secret og Certifikat, som beskrevet nedenfor, også ved adgangsbegrænsede data kræver yderligere at IP-adressen for klienten, der prøver at hente data ved brug af et IT-system er på IP-Allowlisten for det pågældende IT-system. Læs mere om IP-Allowlister på siden IP-allowlist.

OAuth Shared Secret

En Shared Secret er en privat nøgle, som deles mellem en klient (f.eks. en applikation) og udbyderen (f.eks. en service som Datafordeleren). Denne nøgle bruges som en del af godkendelsesprocessen, hvor en klient får adgang til ressourcer på vegne af en bruger uden at afsløre brugerens loginoplysninger. 

En Shared Secret er en OAuth token, der kan bruges til at kalde alle typer af data hos Datafordeleren, dog med forbehold for at beskyttet data først kan hentes ved godkendt ansøgning. En Shared Secret skal ved alle kald til Datafordelerens tjenester sættes i en header.

Når du har oprettet en Shared Secret sendes denne, samt Client ID og grant type til https://auth.datafordeler.dk/realms/distribution/protocol/openid-connect/token hvorefter du vil modtage et Access Token. 

Det resulterende token er et Bearer Token der kan bruges til autentifikation ved efterfølgende kald til datafordeleren. Bemærk at dette token kun er validt i 60 minutter efter udstedelsen. 

I OAuth er et Access Token en hemmelig nøgle som er med til at identificere en anvender hos Datafordeleren, uden at kende til brugernavn eller et password. Når du laver en query med et Access Token i en Authorization header med et Bearer Token, kan Datafordeleren finde ud af hvilke rettigheder og roller som du har. En query bliver derfor afvist hvis dit Access Token mangler. 

Nedenstående tabel indeholder en beskrivelse af de oplysninger der skal angives for at få udstedt et Access Token.

Når du har modtaget et Access Token, skal det angives i en Authorization header i kaldet til tjenesterne. Nedenstående tabel beskriver hvorledes Access Token angives i kaldet.

OAuth Certifikater

Klientautentificering med certifikater i OAuth er en sikkerhedsmetode, hvor en klient (for eksempel en applikation) bruger et digitalt certifikat i stedet for en hemmelig nøgle til at bevise sin identitet over for autorisationsserveren. Processen involverer, at klienten præsenterer sit certifikat under TLS-håndtrykket, hvorefter autorisationsserveren validerer det. Denne metode er særligt velegnet til miljøer med høje sikkerhedskrav eller ved håndtering af følsomme data. Certifikater sættes i kaldets header. OAuth Certifikater kan bruges i stedet for Oauth Shared Secrets og sættes på kaldet som en client assertion.

Der er i Datafordeler Administration mulighed for at uploade et

OCES3 certifikat.

Certifikater kan

bruges til at kalde alle typer af data hos Datafordeleren. 

På samme måde som OAuth Shared Secret, skal certifikatet bruges til at indhente et Access Token. Dette gøres ved at Client ID, samt certifikat til https://auth-oces.datafordeler.dk/realms/distribution/protocol/openid-connect/token i en POST-request.

Bemærk at dette token kun er validt i 60 minutter efter udstedelsen. 

API-Key

En API-key er en privat nøgle, som bruges til at autentificere mod et API. Denne nøgle bruges som en del af godkendelsesprocessen, hvor en klient får adgang til et API uden at afsløre brugerens loginoplysninger.

API-keys bruges som et query-parameter ved at indsætte den i selve URL’en, for eksempel således i et GraphQL-kald: https://graphql.datafordeler.dk/<Register>/<Version>

En API-key er en unik token, der genereres én gang og

er som udgangspunkt aktiv i 2 år. Inden for denne periode kan du forny den, hvilket giver en ny gyldighed på yderligere 2 år. Hvis du ikke fornyer din API-Key inden udløb, og du fortsat skal bruge en, skal du oprette en ny API-key.

API-keys bliver anvendt direkte i URL'en og vil kun give adgang til ubeskyttet data (offentlig tilgængelige data).