Tjenesteeiersystem-integrasjon

Slik kommer du i gang med å sende varsler fra et tjenesteeiersystem

1. Kom i gang som tjenesteeier i Altinn

For å komme i gang med Altinn Varslinger, må din virksomhet være registrert som tjenesteeier i Altinn. For en trinn-for-trinn-guide, se guiden Kom i gang med Altinn.

Dette trinnet er kun nødvendig for nye virksomheter som ennå ikke har etablert seg som tjenesteeiere på Altinn-plattformen. Hvis du allerede er en etablert tjenesteeier, kan du gå direkte videre til de neste trinnene for å begynne å bruke Altinn Varslinger.

2. Registrer din Maskinporten-klient med riktige scopes

For å kunne ta i bruk Altinn Notifications API, må du ha en Maskinporten-klient med riktig scope.

Scope altinn:serviceowner/notifications.create er påkrevd for at klienter skal få tilgang til Varslings-API-et.

Alle registrerte tjenesteeiere har fått delegert dette scopet av Digdir og skal kunne finne det i sin liste over scopes i Samarbeidsportalen.

For en veiledning om hvordan du registrerer en ny Maskinporten-integrasjon i Samarbeidsportalen, se Altinn Autorisasjon

3. Se over policy for relevante ressurser i Altinn Ressursregister

Tilknytning av et varsel til en ressurs resulterer i at policyen for denne ressursen brukes til å identifisere de korrekte mottakerne av varselet. Alle tiltenkte mottakere må ha lese-tilgang gjennom ressursens policy.

En ressurs i dette tilfellet kan være både en Altinn App eller en ressurs (tjenesteeierressurs).

For Altinn Apps må du også sørge for at tilgangssubjektet har lese-tilgang for alle relevante oppgaver og hendelser.

En ny Altinn-ressurs kan registreres i Altinn Studio eller via et API. Vennligst se Altinn Ressursregister for instruksjoner om hvordan du oppretter en ny ressurs.

Policyen for både Altinn Apps og andre Altinn-ressurser kan administreres i Altinn Studio. Vennligst se Altinn Studio-dokumentasjonen for hvordan du gjør dette.

4. Gjør deg kjent med retningslinjene og beste praksis for sending av varsler

For å sikre effektiv kommunikasjon er det viktig å strengt definere hva som kvalifiserer som et varsel og unngå å overvelde brukere med for mange meldinger.

Gjør deg kjent med våre retningslinjer for å forstå hva varsler bør og ikke bør inneholde, for å fremme digital sikkerhet og forhindre varslingstretthet.

5. Integrer mot Varslings-API-et

Du er nå klar til å starte integrasjonen mot Varslings-API-ene, se utviklerguidene for neste trinn.