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 arbeider med å utvikle en løsning som viser hvilke tjenester som er produksjonssatt, og kan integreres. Foreløpig har vi en midlertidig oversikt over produksjonssatte skjematjenester. 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