Skip to content

Commit

Permalink
Text updates
Browse files Browse the repository at this point in the history
  • Loading branch information
TheTechArch committed Dec 17, 2024
1 parent 82d964f commit 5c3f3e9
Show file tree
Hide file tree
Showing 7 changed files with 74 additions and 57 deletions.
Original file line number Diff line number Diff line change
@@ -1,28 +1,24 @@
---
title: Altinn Authentication - Reference implementations
linktitle: Reference documentation
description: Here you find reference implementations using Altinn Authentication functionality
title: Altinn Authentication - Reference Implementations
linktitle: Reference Documentation
description: Find reference implementations using Altinn Authentication functionality.
weight: 5
---



## Systemuser API

Shows the use of token validation to authenticate a systemuser token from maskinporten and the call to Altinn PDP to authorize access
Demonstrates token validation to authenticate a system user token from Maskinporten and the call to Altinn PDP to authorize access.

[Read more](systemuserapi)

## SmartCloud

## SmartCloud

Smartcloud is a reference implementatoin how a system vendor can use Altinn Systemuser API
SmartCloud is a reference implementation showing how a system vendor can use the Altinn Systemuser API.

[Read more](smartcloud)


## Systemregister Admin

Shows how a system vendor can register and update a system in the system register.
Illustrates how a system vendor can register and update a system in the system register.

[Read more]()
[Read more](systemadmin)
Original file line number Diff line number Diff line change
@@ -1,13 +1,24 @@
---
title: Altinn Authentication - Reference documentation
linktitle: Reference documentation
description: Here you find various reference documentation for Altinn Authentication. Including our Architecture.
title: Altinn Autentisering - Referanseimplementasjoner
linktitle: Referansedokumentasjon
description: Finn referanseimplementasjoner som bruker Altinn Autentiseringsfunksjonalitet.
weight: 5
---

## Systembruker API

## Architecture
Demonstrerer tokenvalidering for å autentisere en systembrukertoken fra Maskinporten og kallet til Altinn PDP for å autorisere tilgang.

See details about the Archtecture for Altinn Authentication
[Les mer](systemuserapi)

## SmartCloud

SmartCloud er en referanseimplementasjon som viser hvordan en systemleverandør kan bruke Altinn Systembruker API.

[Les mer](smartcloud)

## Systemregister Admin

Illustrerer hvordan en systemleverandør kan registrere og oppdatere et system i systemregisteret.

[Les mer](systemadmin)
Original file line number Diff line number Diff line change
@@ -1,36 +1,34 @@
---
title: SmartCloud - Altinn Reference Implementation
linktitle: SmartCloud
description: Here you will find our reference implementation for end-user systems.
description: Reference implementation for integrating System User functionality into end-user systems.
weight: 5
---

SmartCloud is designed to demonstrate how system vendors can integrate System User functionality into their own products, including:
SmartCloud demonstrates how system vendors can integrate System User functionality into their products, including:

- Creating a system user token from Maskinporten
- Using system user tokens from applications to call public APIs
- Using APIs to register requests for creating system users
- Using system user tokens to call public APIs
- Registering requests for creating system users
- Checking the status of system user requests
- Listing all system users for a system

## Creating a system user request
## Creating a System User Request

As part of the SmartCloud application, end users can sign up as users for SmartCloud.
End users can sign up as users for SmartCloud. Depending on the SmartCloud version, different rights will be requested.

Depending on the version of SmartCloud, different rights will be requested.
The request is sent from the [Redirect controller](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/RedirectController.cs#L35). The rights requested vary based on the product.

The request is sent from the [Redirect controller](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/RedirectController.cs#L35). Depending on the product, the rights part of the request differs.
SmartCloud authenticates with Maskinporten and requests a token with the scope **altinn:authentication/systemuser.request.write**.

SmartCloud authenticates with Maskinporten and asks for a token with the scope **altinn:authentication/systemuser.request.write**.
## Creating a Maskinporten System User Token

## Creating a Maskinporten system user token
SmartCloud includes code to generate a Maskinporten token for system users using the "logged in" organization number.

SmartCloud includes code to generate a Maskinporten token for system users.
## Calling APIs with System User Token

It uses the "logged in" organization number to create the Maskinporten token.
With the generated system user token, SmartCloud can call various APIs.

## Calling API with system user token
- The [LogisticController](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/LogisticController.cs) calls the Logistics API, requiring read access for the resource.

With the created system user token, SmartCloud can call various APIs.

- The [LogisticController](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/LogisticController.cs) calls the Logistics API. Requires read access for the resource.
The project can be studied [here](https://github.com/TheTechArch/altinn-systemuser/tree/main/src/SystemUserClientSystem/SuperSystem).
Original file line number Diff line number Diff line change
@@ -1,36 +1,34 @@
---
title: SmartCloud - Altinn Referanseimplementasjon
title: SmartCloud - Altinn Referanseimplementering
linktitle: SmartCloud
description: Her finner du vår referanseimplementasjon for sluttbrukersystemer.
description: Referanseimplementering for integrering av Systembruker-funksjonalitet i sluttbrukersystemer.
weight: 5
---

SmartCloud er designet for å demonstrere hvordan systemleverandører kan integrere Systembruker-funksjonalitet i sine egne produkter, inkludert:
SmartCloud demonstrerer hvordan systemleverandører kan integrere Systembruker-funksjonalitet i sine produkter, inkludert:

- Opprette en systembrukertoken fra Maskinporten
- Bruke systembrukertokens fra applikasjoner for å kalle offentlige API-er
- Bruke API-er for å registrere forespørsler om å opprette systembrukere
- Bruke systembrukertoken for å kalle offentlige API-er
- Registrere forespørsler om å opprette systembrukere
- Sjekke statusen for systembrukerforespørsler
- Liste opp alle systembrukere for et system

## Opprette en systembrukerforespørsel
## Opprette en Systembrukerforespørsel

Som en del av SmartCloud-applikasjonen kan sluttbrukere registrere seg som brukere for SmartCloud.
Sluttbrukere kan registrere seg som brukere for SmartCloud. Avhengig av SmartCloud-versjonen vil forskjellige rettigheter bli forespurt.

Avhengig av versjonen av SmartCloud vil forskjellige rettigheter bli forespurt.

Forespørselen sendes fra [Redirect controller](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/RedirectController.cs#L35). Avhengig av produktet varierer rettighetsdelen av forespørselen.
Forespørselen sendes fra [Redirect controller](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/RedirectController.cs#L35). Rettighetene som forespørres varierer basert på produktet.

SmartCloud autentiserer med Maskinporten og ber om en token med omfanget **altinn:authentication/systemuser.request.write**.

## Opprette en Maskinporten systembrukertoken
## Opprette en Maskinporten Systembrukertoken

SmartCloud inkluderer kode for å generere en Maskinporten-token for systembrukere.
SmartCloud inkluderer kode for å generere en Maskinporten-token for systembrukere ved bruk av det "innloggede" organisasjonsnummeret.

Den bruker det "innloggede" organisasjonsnummeret for å opprette Maskinporten-tokenen.
## Kalle API-er med Systembrukertoken

## Kalle API med systembrukertoken
Med den genererte systembrukertoken kan SmartCloud kalle ulike API-er.

Med den opprettede systembrukertokenen kan SmartCloud kalle ulike API-er.
- [LogisticController](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/LogisticController.cs) kaller Logistics API, som krever leseadgang for ressursen.

- [LogisticController](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserClientSystem/SuperSystem/SuperSystem.Server/Controllers/LogisticController.cs) kaller Logistics API. Krever lesetilgang for ressursen.
Prosjektet kan studeres [her](https://github.com/TheTechArch/altinn-systemuser/tree/main/src/SystemUserClientSystem/SuperSystem).
Original file line number Diff line number Diff line change
@@ -1,9 +1,16 @@
---
title: System Admin - Reference implementations
linktitle: Reference documentation
description: Here you find reference implementations using Altinn Authentication functionality
title: System Admin - Reference Implementations
linktitle: Reference Documentation
description: Reference implementations using Altinn Authentication functionality
weight: 5
---

The System Admin application demonstrates how a system vendor can register and update a system in the Altinn System Register.

To add and update systems, the scope **altinn:authentication/systemregister.write** is required.

The application uses a Maskinporten token exchanged for an Altinn token.

The call is made from the [System Register Service](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemAdmin/Services/SystemRegister.cs) in this application.

See the .NET project [here](https://github.com/TheTechArch/altinn-systemuser/tree/main/src/SystemAdmin).
Original file line number Diff line number Diff line change
@@ -1,13 +1,16 @@
---
title: Altinn Authentication - Reference documentation
linktitle: Reference documentation
description: Here you find various reference documentation for Altinn Authentication. Including our Architecture.
title: Systemadmin - Referanseimplementasjoner
linktitle: Referansedokumentasjon
description: Referanseimplementasjoner som bruker Altinn Autentisering-funksjonalitet
weight: 5
---

Systemadmin-applikasjonen demonstrerer hvordan en systemleverandør kan registrere og oppdatere et system i Altinn Systemregister.

## Architecture
For å legge til og oppdatere systemer, kreves omfanget **altinn:authentication/systemregister.write**.

See details about the Archtecture for Altinn Authentication
Applikasjonen bruker en Maskinporten-token som byttes mot en Altinn-token.

Kallet gjøres fra [Systemregistertjenesten](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemAdmin/Services/SystemRegister.cs) i denne applikasjonen.

Se .NET-prosjektet [her](https://github.com/TheTechArch/altinn-systemuser/tree/main/src/SystemAdmin).
Original file line number Diff line number Diff line change
Expand Up @@ -11,3 +11,7 @@ The SystemUser API reference implementation demonstrates how a service owner can
- [SalaryAPI](https://github.com/TheTechArch/altinn-systemuser/blob/main/src/SystemUserApi/SystemUserApi/Controllers/SalaryController.cs) checks for read access to the resource **ttd_systembruker-salary**

The SystemUser API uses Altinn PDP to authorize access for the system user. It retrieves information about the system user from the authenticated identity and uses that information to call Altinn authorization.



The project can be studied [here](https://github.com/TheTechArch/altinn-systemuser/tree/main/src/SystemUserApi/SystemUserApi).

0 comments on commit 5c3f3e9

Please sign in to comment.