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
- Velg syntetisk kommune med daglig leder, se syntetisk kommune
- Velg syntetisk virksomhet med daglig leder, se syntetisk virksomhet
- Logg inn i Altinn test daglig leder for kommunen slik at det blir opprettet en profil der
- Logg inn i Altinn test daglig leder for virksomheten slik at det blir opprettet en profil der
- 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.
- 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
- Logg inn i Maskinporten Selvbetjening (test) og velg "endre syntetisk org" oppe til høyre for å endre til den syntetiske virksomheten.
- Legg til ny maskinporten-klient med scope "husbanken:kobo/boligapi.write". Legg til din nøkkel på den nye klienten.
- 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):
- 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"
- Etter innlogging, velg å representere den aktulle kommunen oppe til høyre.
- 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.
- På profilen i gamle Altinn skal du ha en tjeneste for "Tilgang til programmeringsgrensesnitt - API". Under denne, trykk på "Gi og fjerne API tilganger"
- Trykk på "Deleger nytt API" og søk på "kobo" i søkefeltet.
- Trykk på + ved siden av bolig-apiet, som burde dukke opp i søkefeltet, og så "Neste"
- Velg så den syntetiske virksomheten (via orgnr.) som skal ha tilgang til APIet.