Integrere Altinn-app med Meldingstjenesten
Slik integrerer du en Altinn-app med Meldingstjenesten.
Slik integrerer du meldingstjenesten med en Altinn-app. Med en slik integrasjon kan appen sende digitale meldinger og vedlegg sikkert til både organisasjoner og enkeltpersoner.
Forutsetninger
Du trenger en Altinn-ressurs. Meldingsklienten er innebygd i alle v9-apper, så du trenger ikke installere eller registrere noe.
Altinn-ressurs
Hver melding du sender, må høre til en Altinn-ressurs. Policyen til ressursen bestemmer hvem som får lese meldingene.
Se veiledningen for ressursregistrering for hvordan du oppretter ressursen.
Policyen til ressursen må tillate
read, slik at mottakerne kan åpne og lese meldingensubscribe, hvis du skal abonnere på hendelser for ressursen i Altinn Events
Mottakerne gir du tilgang med rollekoder eller tilgangspakker. Sender du meldinger til personer, bruker du rollekoden priv. Det er rollen Privatperson, som alle innbyggere har fra Folkeregisteret.
Sender du til virksomheter, velger du tilgangspakkene eller rollene som passer best for mottakeren. De gamle Altinn 2-rollene slutter å gi tilgang 1. januar 2027. Bruk derfor tilgangspakker eller roller fra Enhetsregisteret, for eksempel daglig leder. Se Altinn Autorisasjon – detaljert konsept.
Eier virksomheten din ressursen, trenger policyen ingen write-regel for at appen skal kunne sende. Meldingstjenesten slipper gjennom tjenesteeieren som eier ressursen. Det gjelder når appen bruker CorrespondenceAuthenticationMethod.Default(), fordi tokenet da har scopet altinn:serviceowner og viser hvilken virksomhet appen tilhører. Bruker du en ressurs en annen virksomhet eier, må policyen gi virksomheten din write.
Sende meldinger fra appen
Appen sender meldinger på vegne av tjenesteeieren og henter tokenet via Maskinporten. Se Sende meldinger med Maskinporten-autorisasjon for hvordan du setter det opp og skriver koden.