Autentisering med Maskinporten

Maskinporten er en tjeneste fra Digitaliseringsdirektoratet (DigDir) som tilbyr en enkel modell for API-sikring. Den underliggende teknologien er OAuth2-protokollen og bruk av JWT (JSON Web Token)-bearer grants.

API-tilgang i Fellestjenester Plan og Bygg vil etter hvert kreve at API-brukere blir autentisert via Maskinporten. Figuren under er en forenklet representasjon.

Open

Tilgang til FtPB API-er blir autentisert gjennom Maskinporten

Dokumentasjon

• DigDir har dokumentasjon for Maskinporten her: https://docs.digdir.no/docs/Maskinporten/

• Den tekniske dokumentasjonene starter her: https://docs.digdir.no/docs/Maskinporten/

Teknisk sammendrag

Fellestjenester Plan og Bygg har mange API-er tilgjengelige på tjenestene. Disse brukes til valideringer av data, oppsett av erklæringer, status på innsendinger, nedlasting av dokumenter, etc. DiBK er en tilbyder av disse API-ene.

Søknadssystemene eller sak-/arkivsystemene som bruker API-ene er konsumenter.

Autentisering for tilgang til FtPB API-ene ble opprinnelig satt opp med “basic authentication” som er et brukernavn/passord som blir lagt med i headeren på kall mot API-ene.

Ved autentiseringen gjennom Maskinporten blir prosessen slik at konsument går til Maskinporten og ber om tilgang til et API, eller mer korrekt, de ber om tilgang til en ressursgruppe eller et “scope”. Maskinporten utsteder en nøkkel (“token“) som blir lagt ved kallet mot API-et for å få tilgang til ressursen. Dette er illustrert i dokumentasjonen til Maskinporten under.

Open

Illustrasjon fra Maskinporten (docs.digdir.no)

• Mer informasjon om prosessen https://docs.digdir.no/docs/Maskinporten/maskinporten_auth_server-to-server-oauth2

Ta i bruk Maskinporten som konsument

Før en virksomhet registreres i Maskinporten må det bestilles virksomhetssertifikat for både test- og prod-miljøer. Informasjon om dette finnes her: https://docs.digdir.no/docs/Maskinporten/maskinporten_virksomhetssertifikat

Videre må virksomheten registreres i Samarbeidsportalen hos DigDir. Informasjon om dette er her: https://docs.digdir.no/docs/Maskinporten/maskinporten_guide_apikonsument

Skatteetaten har også dokumentert prosessen: https://skatteetaten.github.io/folkeregisteret-api-dokumentasjon/maskinporten/

DiBK som tilbyder

DiBK administrerer tilgangen til API ved å konfigurerer tilgang til “scopes” for de forskjellige konsumentene. Konsumenter er identifisert ved organisasjonsnummer. Disse blir satt opp ved å kontakte oss på service desk.

Scopes

Følgende scopes er satt og for FtPB: