Implementere autorisasjonskontroll på detaljvisninger av dialoger for sluttbrukere

[elsand]

Autentiserte sluttbrukere skal kunne hente en dialog for en party som de har en eller annen rettighet for; det vil si at minst en av følgende må stemme:

• De er av party blitt gitt tilgang til en rolle/accessgroup som omfatter tjenesteressursen dialogen tilhører (aka "rolledelegering")
• De er av party blitt gitt tilgang til én eller flere actions (på en eller flere subressurser) for den aktuelle tjenesteressursen (aka "tjenestedelegering")
• De er av party blitt gitt tilgang til én eller flere actions (på en eller flere subressurser) for den aktuelle dialogen (aka "instansdelegering")

Hvis en eller flere av de overstående stemmer, skal altså tilgang gis til å lese dialogen, tilhørende aktivitetshistorikk, actions og dialogelementer. Dette omtales i akseptansekriteriene under som "tilgang til dialogen".

Men Dialogporten skal også vise i dialogen hvilke actions og dialogelementer den aktuelle sluttbrukeren ikke er autorisert for å hente og eller utføre.

Dialogporten har i XACML-arkitekturen her rollen som PEP, altså Policy Enforcement Point, og skal da sørge for at de aktuelle policyene som ligger til grunn blir etterlevd. Altinn.Common.PEP er et bibliotek som tilbyr modeller, en hjelper og en standardimplementasjon av en HTTP-klient som kaller Decision-API-et i Altinn Autorisasjon. Med denne kan det bygges opp en "authorization request" som lar en sjekke om tilgang til en gitt ressurs foreligger.

Tasks

Preview Give feedback

1. Installer Altinn.Common.PEP
2. Konfigurere subscription keys for alle miljøer for bruk av PEP-klient mot Decision-API
3. Konfigurere endepunkter for Decision-API for alle miljøer
4. Bygg en multi-request mot for hver action (inkl evt subressurs), og hvert dialogelement
5. Utvide responsmodell utfra svar fra Decision-API
6. Utvide ContextHandler i PDP til å støtte fnr/dnr som ressurs-attributt digdir/dialogporten#122
   0 of 1
   auth +1
7. Implementer logikk som setter IsAuthorized=false på dialogelelemter og actions

Akseptansekriterier

GITT en autentisert GET-forespørsel fra en sluttbruker for en dialog som eksisterer
NÅR Altinn Autorisasjon indikerer at tilgang til dialogen ikke foreligger
SÅ skal API-et returnere 403 Forbidden og retunere en feilmeldingsmodell som indikerer at man ikke har tilgang til dialogen

GITT en autentisert GET-forespørsel fra en sluttbruker for en dialog som eksisterer
NÅR Altinn Autorisasjon indikerer at tilgang til dialogen foreligger
SÅ skal API-et returnere 200 OK
OG berike responsmodellen med isAuthorized: false for alle actions hvor sluttbrukeren ikke har rettigheten indikert av action, evt for oppgitt autorisasjonsressurs
OG berike responsmodellen med isAuthorized: false for alle dialogelementer hvor sluttbrukeren ikke har rettigheten read, evt for oppgitt autorisasjonsressurs
OG returnere responsmodellen

Implementasjonsnotater

Det skal altså bygges en request basert på hva dialogen inneholder av actions og dialogelementer med tilhørende autorisasjonsattributter, hvis oppgitt. En dialog som inneholder

• Tre actions: read, submit, sign
• Et dialogelement som har definert authorizationAttribute: urn:altinn:subresource:some-subresource (krever da "read")

skal da føre til at det bygges en request ala følgende:

Klikk for å se XACML request i JSON-format

{
  "Request": {
    "ReturnPolicyIdList": false,

    /* 
    AccessSubject inneholder informasjon om autentisert bruker. Her kopierer vi inn alle claims fra tokenet som starter med "urn:altinn"; 
    det mest sentrale her er urn:altinn:userid. Se under for eksempler på claims som kommer fra tokens vi får:
    */
    
    "AccessSubject": [      
      {
        "Id": "s1", // Brukt for multirequests
        "Attribute": [
          {
            "AttributeId": "urn:altinn:userid",
            "Value": 1234
          },
          {
            "AttributeId": "urn:altinn:partyid",
            "Value": 1234
          },
          {
            "AttributeId": "urn:altinn:authenticatemethod",
            "Value": "IDPorten"
          },
          {
            "AttributeId": "urn:altinn:authlevel",
            "Value": "3"
          }
        ]
      }
    ],
    /*
    Action er handlingene som vi ønsker å sjekke om kan autoriseres
    */

    "Action": [
      {
        "Attribute": [
          {
            "Id": "a1",
            "AttributeId": "urn:oasis:names:tc:xacml:1.0:action:action-id",
            "Value": "read"
          },
          {
            "Id": "a2",
            "AttributeId": "urn:oasis:names:tc:xacml:1.0:action:action-id",
            "Value": "submit"
          },
          {
            "Id": "a3",
            "AttributeId": "urn:oasis:names:tc:xacml:1.0:action:action-id",
            "Value": "sign"
          }
        ]
      }
    ],
    /* 
    Resource inneholder informasjon om ressursene vi ønsker å sjekke.
    */
    "Resource": [
      { // Dette er  dialogen i seg selv        
        "Id": "r1", // Brukt for multirequests
        "Attribute": [
          {
            "AttributeId": "urn:altinn:resource", // serviceresource
            "Value": "super-simple-service"
          },
          {
            "AttributeId": "urn:altinn:resourceinstance",
            "Value": "f4e6df3c-7434-44c3-875e-8dca1cdf0b20"
          },
          // Dette er party på dialogen. Støtte kun organisasjonsnummer pt, se #122
          {
            "AttributeId": "urn:altinn:organizationnumber", 
            "Value": "912345678"
          }
        ]
      },
      { // Dette er subressursen
        "Id": "r2",
        "Attribute": [
          {
            "AttributeId": "urn:altinn:resource", // serviceresource
            "Value": "super-simple-service"
          },
          {
            "AttributeId": "urn:altinn:subresource", // authorizationattribute
            "Value": "some-subresource"
          },
          {
            "AttributeId": "urn:altinn:resourceinstance",
            "Value": "f4e6df3c-7434-44c3-875e-8dca1cdf0b20"
          },
          {
            "AttributeId": "urn:altinn:organizationnumber", 
            "Value": "912345678"
          }
        ]
      }
    ],


    /*
    Denne brukes for å konstruere separate forespørsler som PDP besvarer individuelt.
    Ved hjelp av "id"-attributtet på action og resource kan man formulere flere forspørsler 
    som alle kan ha ulike svar basert på hva brukeren vi ønsker å autorisere (her "subject"),
    som det alltid bare er én av i en request som denne.
    */
    "MultiRequests": {
      "RequestReference": [
          {
              "ReferenceId": [ // Kan subject gjøre "read" på denne dialogen?
                  "s1",
                  "r1",
                  "a1"
              ]
          },
          {
            "ReferenceId": [ // Kan subject gjøre "submit" på denne dialogen?
                "s1",
                "r1",
                "a2"
            ]
          },
          {
            "ReferenceId": [ // Kan subject gjøre "sign" på denne dialogen?
                "s1",
                "r1",
                "a3"
            ]
          },
          {
            "ReferenceId": [ // Kan subject gjøre "read" på subressursen "some-subresource" i denne dialogen?
                "s1",
                "a1",
                "r2"
            ]
        }
      ]
   }
}

Klikk for å se eksempel på JWT token payload for en person

{
  "urn:altinn:userid": 1234,
  "urn:altinn:partyid": 1234
  "urn:altinn:authenticatemethod": "IDPorten",
  "urn:altinn:authlevel": "3",
  "client_amr": "virksomhetssertifikat",
  "pid": "12341234123",
  "token_type": "Bearer",
  "client_id": "10988a23-fd47-4811-8938-108f324ca94d",
  "acr": "Level3",
  "scope": "altinn:user",
  "exp": 1689757455,
  "iat": 1689755655,
  "client_orgno": "991825827",
  "consumer": {
    "authority": "iso6523-actorid-upis",
    "ID": "0192:991825827"
  },
  "iss": "https://platform.tt02.altinn.no/authentication/api/v1/openid/",
  "nbf": 1689755655,
  "nameid": 1234,
}

Klikk for å se eksempel på JWT token payload for en systembruker

{
  "scope": "altinn:somescope",
  "token_type": "Bearer",
  "exp": 1689842327,
  "iat": 1689755927,
  "client_id": "6ecbff55-bbfb-45cb-87cc-83b9f5e4f603",
  "consumer": {
    "authority": "iso6523-actorid-upis",
    "ID": "0192:991825827"
  },
  "jti": "L7Ov9Gec56QhOfTNePRYPQS8P1acBXxlpAmSOnbRgfo",
  "urn:altinn:userid": 1234,
  "urn:altinn:username": "someusername",
  "urn:altinn:partyid": 2345,
  "urn:altinn:orgNumber": "991825827",
  "urn:altinn:authenticatemethod": "virksomhetsbruker",
  "urn:altinn:authlevel": 3,
  "iss": "https://platform.tt02.altinn.no/authentication/api/v1/openid/",
  "actual_iss": "altinn-test-tools",
  "nbf": 1689755927
}

Se også

• https://docs.altinn.studio/authorization/architecture/accesscontrol/
• Etablere søke-API for dialoger for sluttbrukere #34
• Implementere full autorisasjonskontroll på dialoger i søke-API for sluttbrukere #42
• Se hvordan events har implementert en PEP som bruker samme bibliotek og multi-requests