Maskinporten klient

Hvordan sette opp Maskinporten klient i selvbetjeningsportalen

Maskinporten klienter opprettes i selvbetjeningsportalen.

For produksjonsmiljøet opprettes klienter fra: https://sjolvbetjening.samarbeid.digdir.no/.

For testmiljøet opprettes klienter fra: https://sjolvbetjening.test.samarbeid.digdir.no/.

1. Start med å logge inn på din konto med din valgte metode.
2. Når du er logget inn på din konto, vises organisasjonen du representerer i toppmenyen til høyre.

   

   Hvis du logget inn for å representere en syntetisk organisasjon, vil du også kunne endre den syntetiske organisasjonen du representerer i nedtrekksmenyen på det elementet.

   

3. Velg ‘Opprett klient’-knappen for å begynne å opprette en ny klient for organisasjonen du representerer.
4. På ‘Legg til klient’-siden velg Maskinporten.
5. På ‘Legg til Maskinporten klient’-siden fyll inn visningsnavn, beskrivelse og legg til dine nødvendige scopes (Visningsnavnet, beskrivelsen og scopes kan også endres etter klientopprettelse). Deretter velg opprett.

   

6. Du har nå opprettet en Maskinporten klient for din organisasjon. For å bruke denne klienten må du legge til en nøkkel. Klienten støtter JWK og PEM-nøkler. Start med å generere/opprette en JWK eller PEM (Du kan bruke Altinn JWKS-verktøyet https://github.com/Altinn/altinn-authorization-utils/tree/main/src/Altinn.Cli eller finne andre JWK-generatorer for dette). Gå så til nøkkelseksjonen på klientens side og velg ‘Legg til’.

   

   I feltet ‘JWK eller PEM-format’ lim inn din offentlige nøkkel og velg ‘Lagre’. Nøkkelen er nå lagt til i klienten. Lagre din private nøkkel fra din JWK eller PEM et sikkert sted, den brukes til å autorisere bruk av denne klienten. Hvis du bruker Azure Keyvault for å lagre dine private nøkler, må denne være base 64-kodet før den legges til i hemmelighetene.

   

Du kan nå bruke din klient med din nøkkel for å hente Maskinporten tokens. En detaljert beskrivelse av hvordan du autentiserer din klient med JWT Grant er beskrevet her.

Et Maskinporten token kan byttes mot et Altinn-token. Dette er beskrevet her.

Et Altinn-token er nødvendig for å autentisere mot Altinn API (som f.eks Correspondence API). Autentiseringen mot Altinn API krever også at du har de nødvendige scopes på klienten og at du bruker en ressurs hvor din organisasjon har tillatelse til disse scopesene.

Hvis du bruker .Net kan du bruke dette Altinn-biblioteket for å håndtere autentisering med Maskinporten i din applikasjon. Biblioteket gir extension methods for å konfigurere HttpClients til å autentisere med Maskinporten gitt en Maskinporten klientdefinisjon.