Sist endret: 7. mar. 2025

Hvordan komme i gang

Lær om hvordan komme i gang med Altinn 3 Melding, for tjenesteeiere, avsendere og mottakere

Før du går i gang med spesifikke oppgaver som avsender, mottaker, eller tjenesteeier i Altinn Melding, er det noen grunnleggende forberedelser og krav som gjelder for alle brukere. Denne seksjonen dekker de nødvendige stegene du må gjennomføre for å sikre en smidig og effektiv oppstart. Her vil du finne veiledning om generelle systemkrav, påloggingsprosedyrer, og grunnleggende oppsett som må være på plass før du kan begynne å bruke tjenesten fullt ut. Det er viktig at alle brukere følger disse instruksjonene nøye for å unngå problemer senere i prosessen.

I samhandling med Altinn Melding kan en virksomhet ha tre ulike roller:

  • ServiceOwner/Tjenesteeier
  • Sender/Avsender
  • Recipient/Mottaker

En virksomhet kan ha en eller flere av disse rollene. De fleste virksomheter vil ha sender og/eller mottaker, mens en tjenesteeier ofte vil ha alle tre. Å være tjenesteeier innebærer ansvaret for konfigurasjon og tilgangsstyring av tjenesten. Dette medfører at en tjenesteeier må sette opp og definere løsningen før man kan ta den i bruk.

1. Registrer deg som tjenesteeier hos Altinn

For å sette opp en meldingstjeneste i Altinn Melding, må virksomheten din være registrert som en tjenesteeier hos Altinn. Step by step guide finnes her: Kom i gang med Altinn.

Dette steget er kun nødvendig for nye virksomheter som ikke er etablert som en tjenesteeier i Altinn.

2. Opprett eller få tilgang til ressurs

For å kunne sende meldinger over med Altinn Melding, må de først være tilknyttet en ressurs. En ressurs representerer en spesifikk funksjon eller et sett av funksjoner som brukes til å administrere tilgang og regler for overføring av meldinger.

2a. For tjenesteiere

Ressurser registreres via Altinn Studio og brukes til å definere tilgangsregler og tilgangslister, som sikrer at bare autoriserte brukere kan utføre bestemte handlinger.

  1. Logg inn på Altinn Studio og naviger til ressursdashboardet, Se Ressursregister for en detaljert veiledning.
  2. Opprett ny ressurs, følg veiledningen og fyll inn nødvendig informasjon og detaljer om tjenesten.
  3. Angi tilgangsregler for ressursen. Tilgangsregler må for ressursen må konfigureres slik at de tillater følgende handlinger:
    • “read” ment for mottakere å åpne og lese en melding
    • “write” ment for avsendere å sende en melding
    • “subscribe” for å registrere hendelsesabonnement i Altinn Events

Her er en eksempelpolicy.

Merk at denne eksempelpolicyen angir en påkrevd brukerrolle “DAGL(daglig leder)” for brukeren som har tilgang til ressursen, og krever bruk av Ressursrettighetsregister (gå til engelsk språk for å se dokumentasjon for RRR) for å gi tilgang til spesifikke organisasjoner. En bruker med denne tilgangen kan deretter delegere tilgangen til virksomhetsbrukeren/systembrukeren

TIPS: Verifiser konfigurasjonene dine ved hjelp av Postman-samlingen, og erstatt testtokenene med dine egne Altinn-token (Se forespørselen “Logg inn i Maskinporten (Initialiser)” i Authenticator-mappen).

2b. For avsender eller mottaker som ikke er tjenesteeier

Kontakt eieren av Meldingsressursen og spør om å få tilgang til ressursen. Oppgi følgende informasjon:

  • Organisasjonsnummer
  • System bruker

3. Skaff Altinn API-nøkkel og tilgang til scopes

For å bruke Altinn Melding må man ha en abonnementsnøkkel. Teknisk sett er dette en API-nøkkel som må inkluderes i forespørselens Ocp-Apim-Subscription-Key header for å verifisere at du har rett til å bruke Meldings API-et. Uten denne nøkkelen vil forespørselen din bli avvist. For å kunne autentisere og sikre at du kan utføre operasjoner via meldings-APIet, må Altinn gi deg tilgang på de scopes du trenger. Dette sikrer at kun autoriserte klienter kan sende og motta filer, og opprettholder dermed sikkerheten i tjenesten. Følgende scopes brukes for å sende og/eller motta meldinger:

  • altinn:correspondence.write
  • altinn:correspondence.read

For å få Altinn API-nøkkel og scopes må du sende en forespørsel til: servicedesk@altinn.no Forespørselen må inneholde de scopes du trenger. Vær obs på at du kan trenge flere enn kun read/write for melding, Utfyllende liste over scopes finner du her: https://docs.altinn.studio/nb/api/authentication/digdirscopes/

4. Registrer Maskinporten-klient med nødvendige scopes.

For å autentisere mot meldings-APIet, må du registrere Maskinporten-klienten(e) din med nødvendige scopes for om du skal sende og/eller motta meldinger: Scopene vedlikeholdes av Altinn og må være autorisert for de riktige API-operasjonene, og er derfor uavhengige av tilgangen satt av tjenesteeiere i steg 2 for den spesifikke meldingstjenesten.

Bruk Samarbeidsportalen for selvbetjent registrering. Følg den detaljerte guiden som er tilgjengelig der. Her er en detaljert guide.

5. Integrer mot meldings-APIet

Siden Altinn Melding er åpen kildekode, kan du få tilgang til koden vår i vårt offentlige GitHub-repo og bygge en lokal Docker-instans for å teste mot.

Vi ønsker bidrag til løsningen velkommen.

Se Readme-filen på GitHub for en introduksjon til Altinn 3 Melding, og hvordan du bygger og kjører den i din utviklermiljø.

Repoet inneholder også en Postman-samling med eksempler.

Swagger for filoverførings-APIet er vert her.

6. Sett opp hendelsesabonnementer

For å kunne motta varsler om endringer eller hendelser knyttet til dine meldingstjenester, må du sette opp et abonnement for den aktuelle tjenesten. Dette trinnet er spesielt viktig for deg som ønsker å få automatiserte varsler om hendelser fra meldingstjenesten. Hvis du ikke trenger varsler, kan du hoppe over dette trinnet. Se utviklerveiledningen for events for detaljerte instruksjoner om hvordan du setter opp abonnementet.