-
Notifications
You must be signed in to change notification settings - Fork 43
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
82d964f
commit 5c3f3e9
Showing
7 changed files
with
74 additions
and
57 deletions.
There are no files selected for viewing
20 changes: 8 additions & 12 deletions
20
content/authentication/reference/referenceimplementations/_index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
21 changes: 16 additions & 5 deletions
21
content/authentication/reference/referenceimplementations/_index.nb.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
30 changes: 14 additions & 16 deletions
30
content/authentication/reference/referenceimplementations/smartcloud/_index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
30 changes: 14 additions & 16 deletions
30
content/authentication/reference/referenceimplementations/smartcloud/_index.nb.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
13 changes: 10 additions & 3 deletions
13
content/authentication/reference/referenceimplementations/systemadmin/_index.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
13 changes: 8 additions & 5 deletions
13
content/authentication/reference/referenceimplementations/systemadmin/_index.nb.md
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters