Skip to main content

Systembruker

Bruk av systembruker for Sluttbrukersystemer.

På denne siden sammenfattes stegene som må til for å komme i gang med systembruker.

Steg for steg​

  1. Maskinporten onboarding: For å bruke både Skatteetatens og Digdirs API trenger du tilgang til Maskinporten for autentiseringen. Digdir har laget en side som beskriver hva som må til for å komme i gang i test.

  2. API-tilganger: Så trenger du tilgang til API (scopes) både hos Skatteetaten og Digdir:

  • Skatteetaten må gi tilgang til vårt API f.eks. Krav og betalinger eller Innrapportering Boligselskap, og du kan skaffe deg tilgang her. Du finner informasjon om scope det skal bes om tilgang til i dokumentasjonen for det enkelte API.
  • Digdir(inkl Altinn) må gi tilgang til sine API. Det må bestilles av dem. Sørg for å bestille følgende tilganger:
    • altinn:authentication/systemregister.write
    • altinn:authentication/systemuser.request.read
    • altinn:authentication/systemuser.request.write
    • digdir:dialogporten

  1. Maskinporten klient: Når du har fått tilgang til scopene, må det lages en Maskinporten-klient (også kjent som Integrasjon i Digdirs beskrivelser) – du kan opprette denne enten i Digdirs Samarbeidsportal, Forenklet onboarding (se punkt 1) eller ved bruk av API. Maskinporten-klienten du har satt opp, må få tildelt scopene ovenfor og kan deretter benyttes for å få utstedt token/autentiseringsbevis.

  2. Registrere system i systemregisteret: For å kunne benytte sluttbrukersystemet mot Skatteetatens API må det først registreres i Digdirs systemregister. Dette kan gjøres via API. Systemet må knyttes til Maskinporten-klienten (client id) i punkt 3. Hvilke(n) systemtilgang(er), også kjent som tilgangspakke (accesspackage), som skal oppgis, er beskrevet i API-dokumentasjon hos Skatteetaten.

    Eksempel på registrering:

   {
    "id": "974761076_skatt_demo_system",
    "vendor": {
        "ID": "0192:974761076"
    },
    "name": {
        "nb": "Skatteetatens Test SBS",
    },
    "description": {
        "nb": "En beskrivelse av systemet",
    },
    "accessPackages": [
        {
            "urn": "urn:altinn:accesspackage:regnskapsforer-med-signeringsrettighet"
        },
        {
            "urn": "urn:altinn:accesspackage:skattegrunnlag"
        }
    ],
    "clientId": [
        "e6c868ef-d9d6-4847-ba25-409bbd040540" 
    ],
    "isVisible": true,
    "allowedRedirectUrls": [
        "https://skatteetaten.no/sbs"
    ]
}
  1. Opprette systemtilgang for kunde: Du kan nå opprette en forespørsel om systemtilgang (systembruker) for en kunde gjennom å lage en tilgangsforespørsel. Som svar på tilgangsforespørsel vil du motta en url for godkjenning som kunde må benytte i neste steg. Du kan se skjermbilde av hvordan dette ser ut for kunden nederst på siden.
{
  "externalRef": "min_ref",
  "systemId": "974761076_skatt_demo_system",
  "partyOrgNo": "57623423",
  "accessPackages": [
      {
          "urn": "urn:altinn:accesspackage:regnskapsforer-med-signeringsrettighet"
      }
  ],
  "redirectUrl": "https://skatteetaten.no/sbs"
}

  1. Kunde godkjenner tilgangsforespørsel og knytter systemtilgangen til klienter: Ansvarlig hos kunde må logge inn i portalen via url fra punkt 5. og godkjenne systemtilgangen. Når systemtilgangen er godkjent kan kunde logge inn i Altinn-portalen og knytte klienter til systemtilgangen.

  2. Maskinporten autentisering: Når kunden har opprettet en systemtilgang til deg som systemleverandør, kan du kan du få utstedt et Maskinporten-token med systembruker gjennom klienten som ble opprettet i punkt 3. Token må inneholde Skatteetatens scope og systembrukerinformasjon.

Eksempel på et slikt token (dekodet vha. jwt.io ) - Token skal sendes i sin enkodete form - utpakket her for lesbarhet.

{
  "authorization_details": [
    {
      "type": "urn:altinn:systemuser",
      "systemuser_org": {
        "authority": "iso6523-actorid-upis",
        "ID": "0192:313367002"
      },
      "systemuser_id": [
        "33a0911a-5459-456f-bc57-3d37ef9a016c"
      ],
      "system_id": "974761076_skatt_demo_system"
    }
  ],
  "scope": "skatteetaten:innrapporteringboligselskap",
  "iss": "https://test.maskinporten.no/",
  "client_amr": "virksomhetssertifikat",
  "token_type": "Bearer",
  "exp": 1740737667,
  "iat": 1740737547,
  "client_id": "e6c868ef-d9d6-4847-ba25-409bbd040540",
  "jti": "6vc-gdzU3lC7XkBlR9WLxsyB8QKBwBk_FhwmdsL_6BE",
  "consumer": {
    "authority": "iso6523-actorid-upis",
    "ID": "0192:974761076"
  }
}
  1. Bruke Skatteetatens API: Når dette er gjort, kan du kalle Skatteeatens API med tokenet fra punkt 6. i Authorization-headeren. Merk at et Maskinporten kan gjenbrukes over utløpstiden (som oftest 2 min),

Nyttige ressurser i denne prosessen:​