Siter dette som: Apier.no — Altinn 3-overgang for utviklere v1.0

Altinn 3-overgang for utviklere

Kort oppsummert. Altinn 2 stenger for nye rolletildelinger og delegeringer 19. juni 2026 klokken 23:59:59 Europe/Oslo. Eksisterende Altinn 2-rettigheter overføres ikke automatisk til Altinn 3. Hver integrasjon som leverer MVA-melding, A-melding, eller annen regulert innsending på vegne av en norsk virksomhet må opprette Altinn 3-systembrukere, tildele tilsvarende tilgangspakker, og teste alt ende-til-ende før fristen. Denne guiden går gjennom modellskiftet fra navngitte roller til tilgangspakker, sjekklisten for utviklere, og en innebygd live-oppslag mot Altinn 2-koder.

Estimert lesetid: 9 minutter.

Hva endrer seg 19. juni 2026

19. juni 2026 er datoen Altinn og DigDir har annonsert som formell sluttdato for Altinn 2 sin delegeringsflate. To operative konsekvenser følger fra den ene datoen.

For det første: Altinn 2 stenger for nye rolletildelinger og delegeringer. En integrasjon som ikke har migrert sine systembrukere og tilgangspakker innen det øyeblikket kan ikke opprette nye delegeringer mot Altinn 2 — det finnes ingen Altinn 2-portal igjen å opprette dem i. For det andre: eksisterende rettigheter gitt under Altinn 2 flyter ikke stille over til Altinn 3. Identitetslaget er teknisk forskjellig: Altinn 3 utsteder skopede tilgangstokener via Maskinporten og autoriserer mot et ressursregister, mens Altinn 2 brukte en navngitt rollemodell knyttet til den eldre portalen.

Praktisk konsekvens for en integrasjon: hvis du har en produksjonsflyt som leverer MVA-melding for en kunde i dag, og den flyten bygger på en Altinn 2-rolle som Regnskapsmedarbeider, slutter den flyten å virke 20. juni 2026. Kundens rettigheter eksisterer fortsatt rettslig — kundens styre vil fortsatt at regnskapsføreren skal levere MVA — men den tekniske delegeringskjeden som oversatte den intensjonen til et Altinn-API-kall er erstattet.

Fra roller til tilgangspakker

Altinn 2 modellerte myndighet som navngitte roller. En person hadde en rolle på en virksomhet — Daglig leder, Innehaver, Regnskapsmedarbeider, Revisor — og rollen bar en implisitt knippe med rettigheter til å handle i bestemte tjenester. Knippet var ugjennomsiktig: du visste at en Regnskapsmedarbeider kunne levere MVA, men den nøyaktige tilgangen lå inne i Altinn sin tjeneste-for-tjeneste-konfigurasjon.

Altinn 3 erstatter dette med tilgangspakker: eksplisitte, skopede tildelinger knyttet til en systembruker eller en personlig bruker. En tilgangspakke grupperer relaterte rettigheter — retten til å lese en virksomhets skatteopplysninger, retten til å levere MVA-meldinger, retten til å lese NAVs Aa-registerdata — i en navngitt, siterbar enhet. Der den gamle modellen sa «du er Regnskapsmedarbeider på denne virksomheten, slutt deg til hva det betyr», sier den nye modellen «denne systembrukeren har tilgangspakken ‘Skatteforhold for privatpersoner’ på denne virksomheten».

Sammenhengen mellom de to er N:M. En Altinn 2-rolle dekomponeres ofte til flere Altinn 3-tilgangspakker (en Regnskapsmedarbeider trenger distinkte tildelinger for MVA, arbeidsgiverrapportering, og skattekonto-lesetilgang). Motsatt kan én enkelt Altinn 3-tilgangspakke dekke det som før krevde to eller tre forskjellige Altinn 2-roller. Planlegg overgangen rundt operasjonene integrasjonen utfører, ikke rundt rollenavnene du husker.

Prøv det — Altinn 2-kode → Altinn 3-tilgangspakke-oppslag

Velg en Altinn 2-tjenestekode nedenfor for å se tilsvarende Altinn 3-tilkobling, migrasjonsnotatene, og antall dager igjen til fristen 19. juni 2026. Dataene kommer fra Apier sitt offentlige oppslags-endepunkt /api/v1/tools/altinn-migration.

Det utviklere må gjøre

Behandle dette som en sjekkliste, ikke et råd. Hvert trinn blokkerer det neste; å hoppe over er hvordan en fungerende integrasjon 18. juni blir en 403-storm 20. juni.

1. Inventér gjeldende Altinn 2-rettigheter. For hver norsk virksomhet integrasjonen leverer for, list opp Altinn 2-tjenestene koden kaller i dag og rollenavnet virksomhetens signaturberettigede har gitt. Uten denne listen kan du ikke dimensjonere overgangen.
2. Opprett Altinn 3-systembrukere. En systembruker representerer integrasjonen som handler på vegne av en bestemt virksomhet. Oppsettet går gjennom Maskinporten pluss Altinn 3 System Register; Apier-bloggen Maskinporten Guide for Developers går gjennom hele oppsettet med kodeeksempler.
3. Tildel tilgangspakker. For hver systembruker, fest tilgangspakken(e) som dekker operasjonene integrasjonen utfører. Bruk oppslagswidgeten over til å oversette fra Altinn 2-tjenestekoder — og respekter verified: false-flagget, som betyr at oppslaget er en beste-innsats-referanse og må krysssjekkes mot DigDir før produksjonsbruk.
4. Test i Altinn 3-sandkasse. Lever en ekte MVA-melding eller A-melding mot Altinn 3 testmiljø med den nye systembrukeren og den nye tilgangspakken. En vellykket sandkasse-innsending er ingen produksjonsgaranti, men en feilet er en hard blokker.
5. Verifiser ende-til-ende før fristen. For hver virksomhet på inventarlisten, bekreft at en ekte forpliktelse (neste MVA-termin, neste månedlige A-melding) flyter gjennom den nye kjeden vellykket. Ikke vent til uken før 19. juni — Altinns supportkø komprimeres skarpt i de siste dagene.

Vanlige feller

• Anta at roller migreres automatisk. Det gjør de ikke. Altinn 2 → Altinn 3-modellskiftet er en ny-delegering, ikke en datakopiering.
• Over-skopere tilgangspakker.Fristelsen til å feste hver tilgangspakke «for sikkerhets skyld» underkjenner hele poenget med den nye modellen. Minst-privilegium gjelder fortsatt — og en kundes signaturberettigede kan nekte en over-skopet delegering.
• Glemme å rotere systembruker-sertifikater. Sertifikatet bak systembrukeren har sin egen livssyklus, uavhengig av tilgangspakke-tildelingene. En sertifikatrotasjon som overser én kundes systembruker produserer en ugjennomsiktig feil på neste innsending.
• Bomme på fristen 19. juni 2026. Altinn tilbyr ingen overgangsperiode. Planlegg overgangen til å fullføres minst to måneder før fristen så det er rom for uventede DigDir-dokumentasjonsoppdateringer.

Videre lesning

• altinn.no — offisiell Altinn-portal, inkludert annonseringer om Altinn 3-overgangen.
• docs.digdir.no — DigDir sin utviklerdokumentasjon for Maskinporten, Altinn 3 systembrukere, og tilgangspakke-modellen.
• apier.no/use-cases/altinn-migration — Apier sin bruksområde-side for overgangen, med live days_remaining-teller og kodeeksempler.
• apier.no/blog/maskinporten-guide — følgesvenn-guide som dekker Maskinporten, virksomhetssertifikat, JWK-opplasting, og JWT client-credentials-flyten som ligger under Altinn 3 systembrukere.

Publisert 2026-05-14. Sist oppdatert 2026-05-14.