Hopp til innhold

Veiledning for utviklere

Maskinporten API

Norsk autentisering mellom maskiner: hva Maskinporten er, hvem det er for, og hvordan en virksomhet setter det opp selv hos Digdir.

Apier formidler ikke Maskinporten. Kjernen i Apier er selskapsfakta og signaturrett for AI-agenter, med kilde og tidspunkt på hvert svar, og det trenger ingen Maskinporten-tilgang. Les mer om Apier.

Hva er Maskinporten?

Maskinporten er Digdirs autorisasjonsserver for tilgang mellom maskiner, bygget på OAuth2. En virksomhet som skal kalle et offentlig API (Altinn 3, Skatteetaten, Nav og andre) henter et tilgangstoken ved å presentere en signert client assertion (en JWT) som er forankret i et virksomhetssertifikat eller i en offentlig nøkkel virksomheten har registrert. Tokenet bærer de scopene API-leverandøren har gitt klienten, og API-et stoler på tokenet fordi det er utstedt av Maskinporten.

Maskinporten identifiserer virksomheten, ikke en person. Hvem i virksomheten som kan handle i Altinn, styres av Altinn Autorisasjon (roller, tilgangspakker og delegeringer), som er en egen tjeneste med egne vilkår. Les mer om det skillet på Altinn API.

Hvem er Maskinporten for?

For virksomheter som løser egne offentlige oppgaver gjennom et API: et regnskapssystem som sender inn på vegne av kundene sine som registrert sluttbrukersystem, en kommune som henter data fra en statlig etat, eller en bedrift som rapporterer egne tall. Tilgangen settes opp i virksomhetens eget navn, og bruksvilkårene hos Digdir avgrenser den til offentlig oppgaveløsning.

  • Virksomhetssertifikat eller nøkkelpar. Et virksomhetssertifikat fra en godkjent utsteder, eller et eget nøkkelpar der den offentlige nøkkelen (JWK) registreres i Samarbeidsportalen.
  • Klient og scopes. En Maskinporten-klient per integrasjon, med scopes som den aktuelle etaten gir, først i testmiljøet og så i produksjon.
  • Nøkkelrotasjon og tokenhåndtering. Signeringsnøkler roteres etter virksomhetens egen plan, og tokens mellomlagres så lenge de varer. Tokens må aldri logges.

Hvordan får en virksomhet tilgang til Maskinporten?

  1. Registrer virksomheten i Samarbeidsportalen hos Digdir og godta bruksvilkårene.
  2. Opprett en klient i testmiljøet, registrer nøkkel eller sertifikat, og test tokenflyten mot testmiljøet til etaten.
  3. Be API-leverandøren (etaten) om scopene klienten trenger. Hvert scope eies av etaten, ikke av Digdir.
  4. Opprett produksjonsklienten og flytt over når test er grønn. Skal systemet handle i Altinn på vegne av kunder, oppretter hver kunde selv en systembruker for systemet i Altinn.

Hele den tekniske flyten, med fallgruvene, står i Maskinporten-guiden (på engelsk).

Hva tilbyr Apier i stedet?

Maskinverifiserbar norsk signaturrett: selskapets registrerte signaturregler, kodet som rollekombinasjoner, med klausulteksten ordrett, kilde og verifiseringsdato. Dataene kommer fra Brønnøysundregistrene under Norsk lisens for offentlige data (NLOD), så ingen Maskinporten-tilgang, ingen systembruker og ingen Altinn-tilgang er nødvendig. Apier formidler ikke Maskinporten eller Altinn på vegne av andre, og leser ikke Altinn Autorisasjon.

# No key at all: zero-auth sandbox against synthetic org 999999999.
curl https://www.apier.no/api/v1/sandbox/public/company/999999999/authority
# What Apier offers needs no Maskinporten at all: signaturrett and
# prokura from Brønnøysund (NLOD), behind one Bearer API key.
curl -H "Authorization: Bearer apr_free_<your_key_here>" \
  "https://www.apier.no/api/v1/company/999999999/authority"

Hvor finner jeg API-referansen?

Hvordan håndterer jeg feil?

Alle feil fra Apier følger Compliance Explainer-formatet med error_code, en norsk forklaring og konkrete fix_steps. Endepunkter som tidligere tilbød formidling via Maskinporten eller Altinn svarer nå med 410 CAPABILITY_WITHDRAWN og peker videre til signaturrett. Hver respons bærer en X-Correlation-ID du kan oppgi til support.

Vanlige spørsmål

Hva er Maskinporten?

Maskinporten er Norges OAuth2-baserte autorisasjonsserver for tilgang mellom maskiner, driftet av Digdir. Norske offentlige API-er (Altinn 3, Skatteetaten og andre) krever et Maskinporten-tilgangstoken, hentet ved å presentere en signert client assertion (en JWT) forankret i et virksomhetssertifikat eller en registrert offentlig nøkkel. Det er autentiseringslaget under de fleste maskinintegrasjoner mot norsk offentlig sektor.

Trenger jeg Maskinporten eller et virksomhetssertifikat for å bruke Apier?

Nei. Det Apier tilbyr, selskapsfakta, roller og kodet signaturrett fra Brønnøysundregistrene, er åpne registerdata under Norsk lisens for offentlige data (NLOD) og trenger ingen Maskinporten-tilgang. Integrasjonen din autentiserer mot Apier med én Bearer-API-nøkkel. Apier formidler ikke Maskinporten for andre: en virksomhet som trenger Maskinporten til egne offentlige oppgaver, setter det opp selv hos Digdir.

Hvordan får en virksomhet tilgang til Maskinporten?

Virksomheten registrerer seg i Samarbeidsportalen hos Digdir, godtar bruksvilkårene, oppretter en klient i testmiljøet og deretter i produksjon, laster opp den offentlige nøkkelen (JWK) eller bruker et virksomhetssertifikat, og ber API-leverandøren om de scopene klienten trenger. Hvert scope gis av den etaten som eier API-et, ikke av Digdir. Nøkkelrotasjon og tokenhåndtering er virksomhetens eget ansvar.

Hvilke Maskinporten-scopes bruker Apier?

Apier bruker ingen Maskinporten-scopes på vegne av kunder, og leser ikke Altinn Autorisasjon. API-nøkkelen din bærer scopes på Apier-nivå (read:brreg, read:rulebook, read:changes og så videre) som styrer hvilke av de egne lesende endepunktene til Apier nøkkelen får kalle. Altinn Servicedesk bekreftet skriftlig 21. oktober 2026 at opplysninger fra Altinn Autorisasjon ikke kan brukes som grunnlag for en kommersiell tjeneste, og Apier formidler derfor verken Maskinporten eller Altinn.

Jeg vil kjøre Maskinporten-flyten selv. Hvor er den dype guiden?

Innlegget /blog/maskinporten-guide går gjennom den rå flyten fra ende til ende: virksomhetssertifikat, JWK-opplasting, JWT-vekslingen i flyten for client credentials, systembrukere og de ti fallgruvene som hver koster en dag. Denne siden forklarer hva Maskinporten er og hvor grensen går; guiden viser hvordan du gjør alt selv, i virksomhetens eget navn.

Les mer

Kom i gang

Sandkassen kan kjøres med curl uten registrering, og dokumentasjonen dekker endepunktene, scopes og hva som ikke tilbys.