Sist endret: 26. nov. 2024

Autentisering med Maskinporten

Altinn støtter bruk av Maskinporten-token i flere API-er

  • API for tjenesteeiere i sammenheng med data for Altinn Apps
  • API for systemleverandører i sammenheng med systembruker

Beskrivelse av hvordan tjenesteeieres systemer kan benytte Maskinporten for å få tilgang til API-er.

Samarbeidsportalen

I Min profil i Samarbeidsportalen har du tilgang til selvbetjening for Maskinporten, hvor du kan opprette nye integrasjoner (klienter).

Miljøer i Maskinporten
Miljøer i Maskinporten

Tilgang som tjenesteeier

For å kunne hente data fra Storage i Altinn 3 via API som tjenesteeier, må du opprette en integrasjon (klient) i Maskinporten med nødvendige scopes.

Følgende scopes er opprettet av Altinn og delegert til tjenesteeier. Disse scopene er nødvendige for å benytte API-ene relatert til instanser som tjenesteeier:

altinn:serviceowner/instances.read
altinn:serviceowner/instances.write

Klienter med write scope kan blant annet instansiere apper på vegne av brukere via appens eget API, laste opp data, oppdatere metadata og prosess-status. Klienter med read scope kan kun lese data, metadata og hendelser.

I de fleste tilfeller vil en klient for tjenesteeier ha behov for begge scopene.

Oppretting av klient kan gjøres via API eller i Samarbeidsportalen.

POST https://integrasjon.difi.no/clients/
{
    "integration_type": "maskinporten",
    "client_name": "DIHE testklient for instanser",
    "client_type": "CONFIDENTIAL",
    "description": "Klient for å hente data fra mine apper",
    "scopes": [ "altinn:serviceowner/instances.read", "altinn:serviceowner/instances.write" ],
    "token_reference": "SELF_CONTAINED"
}

Ny integrasjon
Opprette ny integrasjon (klient) i Samarbeidsportalen. Husk å velge riktig miljø.

Veksle til Altinn-token

Altinn godtar ikke Maskinporten-token direkte. Disse må veksles inn i Altinn-token. Se detaljer i scenarioet under.

Mer informasjon