Sist endret: 11. sep. 2024

Kom i gang med Altinn Melding som tjenesteeier

Hvordan komme i gang med Altinn 3 Melding, for tjenesteeiere

    Denne prosessen vil forenkles gjennom en fremtidig oppdatering i Altinn Studio.

    Spesielt vil trinn 4-6 utføres via GUI i stedet for å kreve direkte API-kall.

    Denne veiledningen er for deg som er tjenesteeier og ønsker å bruke Altinn Melding. Her finner du trinnvise instruksjoner for registrering, opprettelse av ressurs, konfigurering av tilganger og autentisering, integrasjon med Formidling API-et, samt oppsett av varsler. Veiledningen hjelper deg med å sette opp og administrere formidlingstjenesten.

    1. Kom i gang som tjenesteeier i Altinn

    For å komme i gang med Altinn Melding må virksomheten din være registrert som en tjenesteeier i Altinn. For en trinnvis veiledning, se Kom i gang med Altinn-guiden.

    Dette trinnet er bare nødvendig for nye virksomheter som ennå ikke har etablert seg som tjenesteeiere på Altinn-plattformen. Som en eksisterende tjenesteeier kan du gå direkte videre til de neste trinnene for å begynne å bruke Altinn Formidling.

    2. Nødvendige steg for alle roller

    Utfør steg 1 og 2 i Felles kom i gang-steg hvis du ikke allerede har gjort det.

    3. Opprett ny ressurs

    For at filer skal kunne sendes med Altinn Formidling, må de være tilknyttet en ressurs. En ressurs representerer en spesifikk funksjon eller et sett av funksjoner som brukes til å administrere tilgang og regler for filoverføring. 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.
    4. Tilgangsregler må for ressursen må konfigureres slik at de tillater følgende handlinger:
      • “see” for å se metadata om en melding
      • “open” for å åpne en melding
      • “send” for å sende en melding
      • “subscribe” for å registrere hendelsesabonnement i Altinn Events

    Alternativt, for å sette opp en ressurs som fungerer raskt, kan du bruke vår Postman-samling og kjøre forespørslene “Create resource” og “Create resource policy” med en token som har scopet “altinn:resourceregistry/resource.write”.

    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).