Hopp til hovedinnhold

Kom i gang i testmiljøet (TT02)

Sluttbrukersystemer som ønsker å få tilgang til funksjonalitet og tjenester i testmiljø må følge denne onboarding-prosessen.

Merk at prosessen for tilgang til produksjonsmiljøet vil være noe annerledes, og inneholde noen flere steg (deriblant godkjenning av bruksvilkår).

0 - Forutsetninger

AktivitetAnsvarlig
0.1Velg autentiseringsmetode*:
Se punkt 2.1 for hvordan du oppretter tilgang og klient.
Altinn støtter innlogging med Maskinporten (inkludert systembruker) og ID-porten. For leverandører som skal tilby sitt system til flere kunder, anbefaler vi Maskinporten og systembruker.
*Har du allerede tilgang til Maskinporten, kan du se bort fra dette steget.
SBS-leverandør
0.2Bruksvilkår for autentisering:
Inngå avtale og godkjenn bruksvilkår for ID-porten/Maskinporten om din virksomhet ikke allerede har gjort dette.
SBS-leverandør

1 - Registrere sluttbrukersystem

AktivitetAnsvarlig
1.1Fyll ut registreringsskjema:
Vær spesielt oppmerksom på at felt 2, 4 og 7 er korrekt utfylt, da innholdet her styrer hvilke tilganger dere får og hvem som blir varslet når det er klart.
SBS-leverandør
1.2Tildel scopes (og API-nøkler):
Med grunnlag i hva som ble fylt ut i registreringsskjemaet, får leverandør tilgang til scope i Maskinporten/ID-porten, samt API-nøkler for produkter som krever det.
Digdir
1.3Motta e-post om at tilganger er tildelt:
Informasjonen i denne e-posten skal brukes når du tar i bruk API-ene.
SBS-leverandør

2 - Integrasjon med Maskinporten/ID-porten

AktivitetAnsvarlig
2.1Opprett tilgang og klient:
Følg framgangsmåten for å ta i bruk Maskinporten som konsument (alternativt registrere api-klient i ID-porten)
SBS-leverandør
2.2Legg til scopes på klienten:
Bruk selvbetjeningsfunksjonaliteten for å registrere hvilke av scopene du har tilgang til som er relevant for ditt system. Hvilke scopes som kreves for det enkelte API går (som hovedregel) fram av API-dokumentasjonen.
SBS-leverandør

3 - Integrasjon med funksjonalitet og tjenester i Altinn

AktivitetAnsvarlig
3.1Utvikle grensesnitt mot Altinn:
Sjekk funksjonell dokumentasjon for aktuelle produkter.
Dokumentasjon for fellesfunksjonalitet og for tjenesteproduktene ligger på Altinn Docs.
SBS-leverandør
3.2Fø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
3.3Bli 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.
Lese melding via Dialogporten
Se også opptak av webinar fra 13. mars 2025 - her presenterte Brønnøysundregistrene en brukscase som også kan være til inspirasjon.
SBS-leverandør
3.4Koble 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

4 - Forvaltning

AktivitetAnsvarlig
4.1Registrer og vedlikeholde varslingspunktSBS-leverandør

Kontakt

Erling Laugen

Seniorrådgiver, Digitaliseringsdirektoratet
Telefon: 97 78 75 15