Kom i gang med integrasjon mot Altinn 3!
Leverandører av sluttbrukersystemer som ønsker å få tilgang til funksjonalitet og tjenester i test- og produksjonsmiljø, må følge denne onboarding-prosessen.
Denne guiden viser hvordan leverandører av sluttbrukersystemer kan koble sine systemer til Altinn.
Et sluttbrukersystem er et system som brukes av virksomheter til å sende inn data, hente meldinger eller utføre oppgaver i Altinn via API-er.
For å integrere et system mot Altinn må du:
· Signer relevante bruksvilkår
· Få tilgang til relevante API-scopes
· Autentisere systemet via Maskinporten eller ID-porten
· Utvikle integrasjon mot ønskede API-er
0 - Forutsetninger
| Aktivitet | Ansvarlig | |
|---|---|---|
| 0.1 | Velg autentiseringsmetode: Se punkt 1.4 for hvordan du oppretter tilgang og klient. Altinn støtter innlogging med Maskinporten (inkludert bruk av systembruker) og ID-porten. For leverandører som skal tilby sitt system til flere kunder, anbefales Maskinporten i kombinasjon med systembruker. Dette gjør det enklere for virksomheter å gi systemet riktige tilganger til å utføre oppgaver på deres vegne. | SBS-leverandør |
| 0.2 | Bruksvilkår for autentisering: Merk at vi skiller mellom bruksvilkår for offentlige og private kunder: · Bruksvilkår for offentlige kunder · Bruksvilkår for private virksomheter Lurer du på om din virksomhet har signert bruksvilkår? Logg deg inn på samarbeidsportalen her for å sjekke. | SBS-leverandør |
| 0.3 | Bruksvilkår: Godkjenn bruksvilkår for sluttbrukersystemleverandør. | SBS-leverandør |
1 - Få tilgang til scopes og API-nøkler
| Aktivitet | Ansvarlig | |
|---|---|---|
| 1.1 | Fyll ut registreringsskjema: Fyll ut registreringsskjemaet for sluttbrukersystem. Her oppgir du blant annet hvilke API-er og scopes systemet trenger tilgang til. Se oversikt over hvilke scopes som gjelder for de ulike produktene og funksjonsområdene i Altinn: Scopeoversikt per produkt og funksjonsområde. Merk at enkelte tjenester også krever at man har scopes fra etaten som eier tjenesten. Disse må man få tildelt fra den enkelte etaten. | SBS-leverandør |
| 1.2 | Motta e-post om at tilganger er tildelt:
Denne informasjonen brukes når systemet settes opp mot Altinn 3 API-er. | Digdir |
| 1.3 | Motta e-post om at tilganger er tildelt:
Denne informasjonen brukes når systemet settes opp mot Altinn 3 API-er. | SBS-leverandør |
| 1.4 | Opprett klient i Maskinporten eller ID-porten: Opprett klient for autentisering i Maskinporten eller ID-porten. Hvis løsningen bruker Maskinporten, må du først få tilgang som konsument og deretter opprette en klient i Maskinporten:
Hvis løsningen bruker ID-porten, følger du veiledningen for å autentisere med ID-porten og registrere en klient der. | SBS-leverandør |
| 1.5 | Legg til scopes på klienten: Legg til de scopene klienten skal bruke. Disse må samsvare med tilgangene som ble tildelt i registreringsskjemaet. Bruk selvbetjeningsfunksjonaliteten for å registrere hvilke av scopene du har tilgang til som er relevant for ditt system. Se oversikt over hvilke scopes som gjelder for de ulike produktene og funksjonsområdene i Altinn: Scopeoversikt per produkt og funksjonsområde. | |
| 1.6 | Registrer systemet i systemregisteret: Hvis integrasjonen bruker systembruker, må systemet registreres i systemregisteret via API. Se veiledning her: Registrering av system – Altinn. Når systemet er registrert, må du også huske å legge til nødvendige tilgangspakker på systemet og på systembrukeren, slik at systemet får tilgang til de tjenestene det skal bruke. Se også Veiledning for oppsett av systembrukere. Hvis integrasjonen ikke bruker systembruker, er dette steget ikke nødvendig. Merk. For integrasjoner som skal registrere system i systemregisteret, må klienten ha scopet altinn:authentication/systemregister.write. |
2 - Integrasjon med funksjonalitet og tjenester i Altinn
| Aktivitet | Ansvarlig | |
|---|---|---|
| 2.1 | Utvikle grensesnitt mot Altinn: Sjekk funksjonell dokumentasjon for aktuelle produkter. Dokumentasjon for fellesfunksjonalitet og for tjenesteproduktene ligger på Altinn Docs. | SBS-leverandør |
| 2.2 | Følg API-dokumentasjonen for ønsket funksjonalitet: Alle API-er tilgjengelig detaljert teknisk dokumentasjon for hvordan API-ene er bygd opp. Denne viser relevante kall og responser. | SBS-leverandør |
| 2.3 | Koble systemet opp mot en tjeneste: Vi har laget en oversikt over apper i produksjon. Den enkelte tjenesteeier må kontaktes direkte for tjenestespesifikk dokumentasjon. | SBS-leverandør |
3 - Forvaltning
| Aktivitet | Ansvarlig | |
|---|---|---|
| 3.1 | Registrer og vedlikeholde varslingspunkt | SBS-leverandør |
Kontakt
Altinn servicedesk
Bli inspirert av brukscase:
For noen vanlige brukscase på tvers av produkter finnes det ende-til-ende-beskrivelser av hvordan man kan kombinere API-er for å løse caset. Disse vil vi jobbe videre mer fremover.
Se våre brukscase her!
Se også opptak av webinar fra 13. mars 2025 - her presenterte Brønnøysundregistrene en brukscase som også kan være til inspirasjon.