Hjem > Kontaktregisteret

Opprette og sette opp klient

For å gjøre en forespørsel mot et eller flere av KRR sine endepunkt, må virksomheten sette opp en klient ved selvbetjening web eller selvbetjening api. Her beskriver vi hvordan du kan opprette klient ved selvbetjening web, men tilsvarende kan gjøres ved selvbetjenings api.

Registrer ny bruker på Min Side

Bruk av selvbetjening forutsetter at din virksomhet har fått tilgang til Samarbeidsportalen, og at du er registrert bruker. Registrer ny bruker på Min side.

Note: For å kunne registrere ny bruker må du bruke epost-domenet til din virksomhet!

Opprette klient

Logg inn på Min side og gå til “Integrasjoner” i menyen til venstre.
Trykk på “Selvbetjening” og velg miljøet du vil opprette klienten i.
Velg “Legg til ny”.

Sette opp klient

a. Ved oppslagstjenesten REST

Velg “Maskinporten & KRR”.
Under “Scope”, velg scope-pakken “KRR”. Da vil du automatisk få tildelt de riktige scopene.
For oppslag i KRR er krr:global/kontaktinformasjon.read relevant.
Integrasjonsidentifikator: Genereres automatisk og skal brukes i jwt_claims.
Navn på integrasjon: Egendefinert, unikt navn på integrasjonen.
Beskrivelse: Egendefinert beskrivelse av hva integrasjonen skal brukes til.

b. Oppslag ved brukerinnlogging (brukerstyrt datadeling)

Velg “ID-porten & API-klient”.
Under “Skal klienten benytte eksterne scope?”, velg “Ja”.
Du må manuelt legge til scopet: krr:user/kontaktinformasjon.read.

Lenke til mer detaljert beskrivelse av scopene.

Fullfør registreringen ved å trykke på “Opprett”.

Note: Ved opprettelse får du en integrasjonsID (klientID) som må brukes i forespørselen mot ID-porten.

For leverandører

Leverandører som gjør oppslag på vegne av en kunde, bruker delegering i Altinn.

Opprett klienten på leverandørens eget organisasjonsnummer.
Legg til delegeringsscopene på klienten.
Kunden gir leverandøren fullmakt i Altinn.
Ved forespørsel av access-token fra Maskinporten settes consumer_org til kundens organisasjonsnummer.

Se Oppslag på vegne av annen virksomhet for delegeringsscopene og fremgangsmåten.

Legge til nøkkel i klient

Public-nøkkelen skal legges til i klienten, struktuert som JWK. Mer beskrivelse om hvordan nøkkelen skal registreres her.

Kom i gang med koden

Dette repoet kan være til hjelp for å komme i gang med koden.