Samtykkeløsningen

Altinns dokumentasjon om Samtykkeløsningen: Autorisasjon

Tjenestens løsning baserer seg på Altinn 3 sitt TT02-system. Tilganger gis via maskinporten.

Detaljer for å få ut tokens fra samtykkeløsning via Maskinporten:

  • Endpoint: https://test.maskinporten.no hvor samtykkets id plasseres i authorizationdetails under feltet id.
  • ApiKey angis i header
  • Accept = application/hal+json angis også i header
  • Virksomheten må legge til følgende scopes for å få utstedt Maskinporten-token (dersom de ønsker å bruker Maskinporten-token istedenfor virksomhetssertifikat for autentisering mot samtykkeløsningen):
    • altinn:consentrequests.read
    • altinn:consentrequests.write
    • altinn:consenttokens

Scopene er åpne og finanforetakene kan legge til scopene selv.

Metadata

Når man skal gjøre en request mot Altinn må man sende med metadata-feltet “Navn”. Her skal man sette inn navnet på banken/virksomheten som kunden gir samtykke til. Kallet vil feile dersom parameteren er utelatt. Dersom verdien er blank vil kallet lykkes, og på samtykkesiden vises da ingenting for bankens navn.

Virksomheten må her oppgi navnet til den organisasjonen kunden skal samtykke til. Merk at det ikke gjenbrukes det navnet som utledes fra coveredBy. Enkelte virksomheter kan ha et “markedsføringsnavn” eller “bruksnavn” som er forskjellig fra det offsielle navnet i enhetsregisteret. Virksomheten bør oppgi navnet likt med det den har registrert i enhetsregisteret.

Altinn-samtykke

Samtykket til lånekassen har identifikasjon slk-samtykke i altinn 3. Detaljer kan ses på: platform.tt02.altinn.no/resourceregistry/api/v1/resource/slk-samtykke

Hvordan opprette autorisasjonskode

Slik opprettes det en autorisasjonskode (samtykke) hos Altinn 3. Eksempel forespørsel mot https://platform.tt02.altinn.no/accessmanagement/api/v1/enterprise/consentrequests

{
  "id": "14ed8698-e619-4066-9eb4-5c1eb3f165a1",
  "from": "urn:altinn:person:identifier-no:03866697050",
  "to": "urn:altinn:organization:identifier-no:960885406",
  "validTo": "2026-07-18T06:18:12.2597103+00:00",
  "consentRights": [
    {
      "action": ["consent"],
      "resource": [
        {
          "type": "urn:altinn:resource",
          "value": "slk-samtykke"
        }
      ],
      "metaData": {
        "navn": "BankenMin"
      }
    }
  ],
  "redirectUrl": "https://bankenmin.no/lan/?consentId=77ed8698-e619-4066-9eb4-5c1eb3f165a1",
  "portalViewMode": "show"
}

Eksempel retur:

{
    "id": "14ed8698-e619-4066-9eb4-5c1eb3f165a1",
    "from": "urn:altinn:person:identifier-no:03866697050",
    "requiredDelegator": null,
    "to": "urn:altinn:organization:identifier-no:960885406",
    "handledBy": null,
    "validTo": "2026-07-18T06:18:12.25971+00:00",
    "consentRights": [
        {
            "action": [
                "consent"
            ],
            "resource": [
                {
                    "type": "urn:altinn:resource",
                    "value": "slk-samtykke",
                    "version": "3601"
                }
            ],
            "metadata": {
                "navn": "BankenMin"
            }
        }
    ],
    "requestMessage": null,
    "consentRequestStatus": "Accepted",
    "consented": "2026-03-13T13:16:02.30504+00:00",
    "consentRequestEvents": [
        {
            "consentEventID": "019ce676-f6ed-733b-a793-d69ef2c771ae",
            "created": "2026-03-13T09:11:22.084956+00:00",
            "performedBy": "urn:altinn:party:uuid:cfbab94d-a868-44ae-a949-52b53ebd48c7",
            "eventType": "Created",
            "consentRequestID": "14ed8698-e619-4066-9eb4-5c1eb3f165a1"
        },
        {
            "consentEventID": "019ce756-f783-78a1-8359-5e0b1d53cf7f",
            "created": "2026-03-13T13:16:02.30504+00:00",
            "performedBy": "urn:altinn:party:uuid:95545ea9-9fe0-4505-af1c-bec6fba95245",
            "eventType": "Accepted",
            "consentRequestID": "14ed8698-e619-4066-9eb4-5c1eb3f165a1"
        }
    ],
    "redirectUrl": "https://bankenmin.no/lan/?consentId=77ed8698-e619-4066-9eb4-5c1eb3f165a1",
    "viewUri": "https://am.ui.tt02.altinn.no/accessmanagement/ui/consent/request?id=14ed8698-e619-4066-9eb4-5c1eb3f165a1",
    "templateId": "default",
    "templateVersion": 1,
    "portalViewMode": "Show"
}

Endringslogg

Dato Endring Link i dokumentasjon
10.4.26 Oppdatert dokumentasjon Integrasjon samtykke