Skip to main content

Autentisering

Anrop fra klienter til Datafangst 2.0 krever at requesten inneholder et gyldig autentiseringstoken.

Hente token via ID-Bridge​

Dette kan gjøres ved å logge inn i ID-Bridge, velge Datafangst 2.0 API og hente tokenet derfra.

Eksempel på bruk av token​

curl -X 'GET' 'https://datafangst.api.vegvesen.no/api/v2/kontrakter/{kontraktId}' \
-H 'accept: application/json' \
-H 'Authorization: Bearer <ditt-token-fra-utklippstavle>' \
-H 'X-Client: Geometri-Redigerings-Verktøy'

Bruk av token i Swagger​

Du kan også bruke tokenet direkte i Swagger UI for å teste API-forespørsler:

  1. Gå til Swagger UI
  2. Klikk på Authorize-knappen (låseikonet) øverst på siden
  3. Skriv inn <ditt-token> i feltet bearer (http, Bearer) og klikk Authorize
  4. Nå vil alle forespørsler du gjør via Swagger UI inkludere tokenet automatisk (Merk: når du bytter side i Swagger UI må du klikke Authorize på nytt for å inkludere tokenet i forespørslene på den nye siden)

Begrensning med ID-Bridge token​

Tokenet hentet fra ID-Bridge er gyldig i 8 timer og kan fornyes. Det er imidlertid viktig å merke seg at dette tokenet kun er gyldig for API Datafangst 2.0 og kan ikke brukes i andre APIer levert av NVDB. Tokenet vil kun inneholde roller knyttet til Datafangst 2.0, slik at hvis man har andre roller i NVDB som brukes i Datafangst applikasjonen, så vil ikke disse være tilgjengelige i tokenet hentet fra ID-Bridge. Tokenet er tiltenkt å brukes i tredjepartsapplikasjoner som skal integreres med Datafangst 2.0 API.

Krav til X-Client​

APIet benytter X-Client headeren i sin interne request-logg for å identifisere klienter. Denne headeren spiller en kritisk rolle i å overvåke og sikre korrekt bruk av APIet. Det er essensielt at X-Client-headeren inneholder en verdi som klart identifiserer klienten eller fagsystemet. Dette er nødvendig for å kunne identifisere og skille mellom de ulike applikasjonene som bruker APIet.

Implementasjon av X-Client​

Når du implementerer en klient som bruker APIet, må X-Client settes til en verdi som spesifikt identifiserer din klient.

Eksempel på X-Client verdi:​

"X-Client": "Geometri-Redigerings-Verktøy"