NB! Dokumentasjonen på dette nettstedet er for en løsning som skal avvikles innen juni 2026. Dokumentasjon for ny løsning finner du her.

Delegering av API-tilgang

Altinn kan benyttes for å videredelegere tilgang til API-er sikret med Maskinporten

Introduksjon

Den nasjonale referansearkitekturen for eOppslag søker å møte behovet for samordnede sikkerhetsmekanismer for å sikre tilganger til API-er gjennom sterk autentisering, samt mulighet for å kunne delegere tilganger videre til f.eks. leverandører som skal utføre arbeid på vegne av en aktør som har fått tilgang til et API.

Maskinporten er delen av den felles nasjonale innloggingsløsningen ID-porten som tilbyr sikring av API-tilganger via maskin-til-maskin-autentisering og en OAuth2-scope basert autorisasjonsmekanisme.

Sammen med Altinn er det implementert en mekanisme som gjør det mulig for virksomheter som er gitt tilgang til et API gjennom Maskinporten å gi denne videre til for eksempel en leverandør som skal utføre den tekniske implementasjonen på deres vegne. Dette gjør at API-eier ikke trenger å forholde seg til enkeltleverandører, og man unngår deling av virksomhetssertifkat mellom virksomheten som har fått tilgang og dens leverandør.

Et eksempel

Skatteetaten oppretter API-er for oppslag mot Folkeregisteret (1), og registrerer samtidig API-et (scopet) som en delegerbar ressurs i Altinn (2). Deretter gis tilgang til Leikanger kommune til scopet som representerer Folkeregisteret (3).

En hoveadministrator for Leikanger kommune logger da inn i Altinn og utfører en vanlig tjenestedelegering til en leverandør. (4)

graph TD subgraph Skattetaten SSC[Selvbetjeningsklient] end subgraph Maskinporten SSA[Selvbetjenings-API] end subgraph Leikanger Kommune CON[Tilgangsstyrer] end subgraph "Delegeringskilde (Altinn)" AP[Altinn Portal] AA[Altinn Autorisasjon] end SSC--> |1. Oppretter API|SSA SSC --> |2. Registrer API som delegerbar ressurs|AA SSC --> |3. Gir tilgang til Leikanger kommune|SSA CON --> |4. Delegerer tilgang til leverandør via Portal|AP

Underleverandøren får beskjed om dette via varsel, og kan da opprette en OAuth2-klient i Maskinporten som provisjoneres med scopet som representerer Folkeregisteret. Når underleverandøren da forsøker å hente ut et access token, oppgir de at de gjøre dette på vegne av Leikanger Kommune. Maskinporten gjør da et oppslag mot Altinn for å sjekke om det foreligger en aktiv delegering på Folkeregister-scopet gitt fra Leikanger Kommune til underleverandøren. Altinn returnerer en bekreftelse på dette, og Maskinporten utsteder token til underleverandører, som da kan bruke dette mot Skatteetatens API som om den var Leikanger Kommune.

graph TD subgraph Skattetaten API[Folkeregister-API] end subgraph Maskinporten OIDC[OAuth2-server] end subgraph Leverandør CLI[OAuth2-klient] end subgraph "Delegeringskilde (Altinn)" AA[Altinn Autorisasjon] end CLI --> |1. Forespør token pva. Leikanger kommune|OIDC OIDC -->|2. Sjekker om delegering foreligger|AA OIDC -->|3. Utsteder leverandørtoken|CLI CLI --> |4. Bruker token mot API|API
  • For API-bruker

    Om hvordan du tar i bruk en tilgang til et Maskinporten-sikret API gitt via en Altinn-delegering.

  • For API-eier

    Om hvordan du som API-eier kan registrere ditt API som en delegerbar ressurs i Altinn.

  • For tilgangsstyrer

    Hvordan du som tilgangsstyrer for en virksomhet som har fått tilgang til et API i Maskinporten delegerer denne videre til en leverandør.