Skip to main content

Kobo Bolig API Maskinporten

Kobo Bolig API kan kun konsumeres når man har et gyldig Maskinporten-token.

Overordnet​

Etter at leverandøren har registrert en klient for Maskinporten i Maskinporten Onboarding, må implementasjonen til leverandøren kalle Maskinporten og be om token.

Husbanken Kobo Bolig API Scope​

I Maskinporten har Husbanken et Maskinporten Scope som har det tekniske navnet "husbanken:kobo/boligapi.write", dette er et Private Scope i Maskinporten og kan kun benyttes etter at Husbanken har tildelt det til kommunen og leverandøren som kommunen ønsker å delegere til.

Testmiljø​

Testmiljøet bruker utelukkende syntetiske data fra Tenor for personer, kommuner og virksomheter.

Det er viktig å merke seg at testdata i Tenor er "levende" og kan endre seg, så hvis feks personen som rår over virksomheten eller kommunen ikke lengre har tilgang til å administrere virksomheten i Altinn test bør man sjekke i Tenor om personen fortsatt er daglig leder feks, eller om virksomheten er avviklet.

Nødvendig informasjon for oppsett​

For å kunne teste trenger man å velge seg ut følgende data og dele med Husbanken.

  • En syntetisk kommune
  • En syntetisk virksomhet som kan være leverandør for kommunen

Prosess for tilkobling​

Dette er overordnet prosessen for å komme i gang med testing av Kobo Bolig API

  1. Velg syntetisk kommune med daglig leder, se syntetisk kommune
  2. Velg syntetisk virksomhet med daglig leder, se syntetisk virksomhet
  3. Logg inn i Altinn test daglig leder for kommunen slik at det blir opprettet en profil der
  4. Logg inn i Altinn test daglig leder for virksomheten slik at det blir opprettet en profil der
  5. Send e-post til brukerservice@husbanken.no og oppgi syntetisk kommune og virksomhet som er valgt, samt liste av IP-adresser som skal kommunisere med APIet.
  6. Etter bekreftelse fra Husbanken om at det er åpnet for gjeldende IPer og at kommune og virksomhet har fått tilgang til i scope: Som daglig leder for kommunen logget inn i Altinn test, deleger API til virksomheten. Se delegering av tilgang til virksomhet i test
  7. Logg inn i Maskinporten Selvbetjening (test) og velg "endre syntetisk org" oppe til høyre for å endre til den syntetiske virksomheten.
  8. Legg til ny maskinporten-klient med scope "husbanken:kobo/boligapi.write". Legg til din nøkkel på den nye klienten.
  9. Denne klienten kan nå brukes til å kommunisere med Kobo Bolig API.

Syntetisk kommune​

Søk frem en kommune i Tenor testdatasøk hos Skatteetaten (krever innlogging via idporten).

Noter ned hvem som er "Daglig leder/administrerende direktør".

Feks for "Rosa Modig Bjørn Kommune" (orgnr: 310150924) er det fødselsnummer "19818899419".

Syntetisk virksomhet​

Søk frem en virksomhet i Tenor testdatasøk hos Skatteetaten (krever innlogging via idporten).

Noter ned hvem som er "Daglig leder/administrerende direktør".

Feks for "Operativ Sammarbeidsvillig Tiger AS" (orgnr: 313116360) er det fødselsnummer "21876199545".

Delegering av tilgang til virksomhet i test​

For å delegere tilgang til API i Altinn (tilsvarende steg gjelder også for produksjon):

  1. Logg inn i Altinn test. Når du blir spurt om innloggingsmetode, velg "TestID på høyt nivå" og fyll inn fødselsnummer for den syntetiske kommunen sin daglig leder før du trykker "autentiser"
  2. Etter innlogging, velg å representere den aktulle kommunen oppe til høyre.
  3. Trykk på "Gå til gamle Altinn". Dette fordi det i skrivende stund (10. mars 2026) ikke er mulig å administrere API-tilganger i nye Altinn. Om du blir bedt om kontaktinfo, kan du fint bare legge inn dummydata.
  4. På profilen i gamle Altinn skal du ha en tjeneste for "Tilgang til programmeringsgrensesnitt - API". Under denne, trykk på "Gi og fjerne API tilganger"
  5. Trykk på "Deleger nytt API" og søk på "kobo" i søkefeltet.
  6. Trykk på + ved siden av bolig-apiet, som burde dukke opp i søkefeltet, og så "Neste"
  7. Velg så den syntetiske virksomheten (via orgnr.) som skal ha tilgang til APIet.