Kom i gang med integrasjon mot Altinn 3

Bruksvilkår for autentisering:
Inngå avtale og godkjenn bruksvilkår for ID-porten/Maskinporten om din virksomhet ikke allerede har gjort dette.

Lurer du på om din virksomhet har signert bruksvilkår? Logg deg inn på samarbeidsportalen her for å sjekke. Informasjon ligger under "Bruksvilkår > Virksomhetens bruksvilkår".

Merk at vi skiller mellom bruksvilkår for offentlige og private kunder:

· Bruksvilkår for offentlige kunder

· Bruksvilkår for private virksomheter

Bruksvilkår:
Godkjenn bruksvilkår for sluttbrukersystemleverandør.

Kunder av SBS-leverandør trenger ikke utføre dette steget.

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.

Motta e-post om at tilganger er tildelt:
Når tilgangene er opprettet mottar leverandøren en e-post med informasjon om:

• hvilke scopes som er tildelt
• eventuelle API-nøkler
• hvilke tjenester systemet kan integrere mot

Denne informasjonen brukes når systemet settes opp mot Altinn 3 API-er.

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:

• Se veiledning for å ta i bruk Maskinporten som konsument.
• Se hvordan du oppretter og administrerer klienter i Maskinportens selvbetjeningsløsning.

Hvis løsningen bruker ID-porten, følger du veiledningen for å autentisere med ID-porten og registrere en klient der.

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.

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.

Sett opp integrasjon mot tilgangsstyrings-API-ene for å:

• få tilgang til aktørliste
• hente/endre/slette fullmaktshavere/fullmakter
• gjøre klientadministrasjon
• håndtere tilgangsforespørsler

Sett opp integrasjon mot Dialogporten-API-ene for å:

• søke etter pågående dialoger (mottatte skjema / skjema under arbeid / mottatte meldinger / mottatte forsendelser)
• hente dialogdetaljer og få tilgang til spesifikke dialoger

Sett opp integrasjon mot tjenesteproduktenes grensesnitt

• Apps - se også brukscase instansiere og sende en app
• Melding - se også brukscase hente melding gjennom Dialogporten
• Formidling

Merk at en del tjenester er realisert utenfor Altinn. For disse må du finne dokumentasjon hos den enkelte tjenesteeier.