Denne siden skal benyttes av virksomhetene som et navigeringsverktøy som gir tilgang til informasjon som er nødvendig for en vellykket etablering av løsningen.

Onboardingsprosessen

For å sikre en god integrasjon med Lånekassen skal virksomhetene følge anbefalte onboardingsprosess i 4 faser slik den er beskrevet under.

Prosess Beskrivelse
A - Forberedelse Lese dokumentasjon og vurdere hvordan dette berører virksomhetenen og hvordan arbeidet skal organiseres - og når.

Igangsette nødvendige tekniske interne bestillinger.
B - Registrering og avtaleinngåelse Virksomheten registrerer seg hos Bits, hvor Bits administrerer signering av avtaler/vilkår.
C - Integrasjon Virksomheten starter implementering av tjeneste og utfører nødvendige interne tester og integrasjonstester mot Lånekassen før overgangen til produksjon.
D - Produksjon Virksomheten går over til produksjon.

I de neste kapitlene er det også presentert anbefalinger om hvem som burde fullføre hvilke oppgaver:

  • IT: IT-spesifikke oppgaver

  • Forretning: Oppgaver for forretningssiden som vil implementere løsningen

  • Alle: Alle de ovenfor nevnte miljøene.

  • Bits: Personale hos Bits gjennomfører oppgaven

A - Forberedelse

I dette kapittelet finner man oversikt over oppgaver som skal/bør utføres før virksomheten går til registrering og avtaleinngåelse (B).

Oppgaver    
A-1 Lese og forstå dokumentasjonen fra Lånekassen. (Alle) Se Saldo på studielån og Informasjonsmodell Sidene forklarer hva tjenesten er og hvilken informasjon som leveres.
A-2 Bestille test- og produksjonsvirksomhetssertifikat for virksomhet (forretning/IT) Det er valgfritt å benytte virksomhetssertifikat mot maskinporten. Enten virksomhetssertifikat eller self-signed.

Virksomheten må ha gyldig test- og produksjons-virksomhetssertifikater fra enten Buypass eller Commfides

Sertifikatene skal brukes for autentisering mot maskinporten.

Det er også mulig å gjenbruke eksisterende test- og produksjonsvirksomhetssertifikat.

Les mer om virksomhetssertifikat her.
A-3 Sette seg inn i integrasjoner og nødvendige forutsetninger for å benytte Maskinporten. (Forretning/IT) Maskinporten brukes til å autorisere tilgang til Lånekassens API. Se:

Slik bruker du Maskinporten som API-konsument
A-4 Lese og forstå dokumentasjonen om Altinns samtykkeløsning. (Forretning/IT) Se Altinns samtykkeløsning.
A-5 Sette seg inn i integrasjonstest som skal fullføres i forkant av prodsetting (IT) Se Integrasjonstest. Oversikt over alle test caser som skal gjennomføres før virksomhet kan gå over til produksjon.
A-6 Tilrettelegge for neste fase ved å bestille nødvendige utviklings- og testmiljøer (IT) Dette er en virksomhet-intern aktivitet.
A-7 Se oversikt over tilgjengelige testbrukere (IT/Kreditt). Testdata
A-8 Tilrettelegge for neste fase ved å bestille nødvendige brannmur-åpninger for både test og produksjon (IT) Dette er en virksomhet-intern aktivitet.
A-9 Design og planlegging internt i virksomheten for tilpasning av saldo på studielån i nettbank og mobilbank (Alle)  

B - Registrering og avtaleinngåelse

I dette kapittelet finner man oversikt over oppgaver som må være gjort før virksomheten går over til integrasjonstesting.

Oppgaver    
B-1 Virksomheten fyller registreringsskjemaet og sender det til Bits (Forretning)

Virksomheter som ikke er deltaker av Bits AS vil bli fakturert for en engangskostnad som del av investeringskostnaden, og årlig forvaltningsavgift for drift av tjenesten. Beløpene er oppgitt i registreringsskjema for ikke-deltaker av Bits.		 Registreringsskjema

Registreringsskjema ikke-deltaker av Bits AS.

Ferdig utfylt skjema sendes til DSOP Support.

Bits vil verifisere innholdet i skjemaet og vil på bakgrunn av godkjent registreringsskjema starte prosess for elektronisk avtaleinngåelse.

Nødvendig input:

- Organisasjonsnummer

- Hovedkontaktperson

- Ulike kontaktpersoner i virksomheten

- Er SBL implementert?

- Domener for test-miljø

- Domener for produksjonsmiljø

- Navn på eventuelle virksomhet som konsumenten signerer på vegne av
B-2 Virksomheten melder seg inn i Maskinporten og signerer bruksvilkår for Maskinporten elektronisk. (IT/Forretning)

Dersom virksomheten har oppgitt tredjepart i registrerringsskjema så skal tredjepart gjøre denne prosessen.		 Følg fremgangsmåte under: Ta i bruk Maskinporten

Dersom tredjepart skal implementere løsningen er det kun deres organisasjon som trenger å signere bruksvilkår og opprette tilgang i Maskinporten sin samarbeidsportal.
B-3 Elektronisk signering av tjenestebeskrivelse (Bits/Forretning) Tjenestebeskrivelsen inneholder bruksvilkårene for tjenestene og underbilag.

Virksomheten blir kontaktet av Bits for å starte elektronisk avtaleinngåelse.
B-4 Bestille tilgang til testmiljø Altinn (Forretning) Virksomheten bestiller tilgang til testmiljø for «Saldo på studielån» via selvbetjeningsskjermbilder i Altinn 3.

Bestillingen gjennomføres ved å:

- Logge inn i Altinn 3
- Navigere til relevant tjeneste/API for «Saldo på studielån»
- Registrere virksomheten og eventuelt tredjepart som skal benyttes
- Bestille nødvendige tilganger (API og Maskinporten scope)

Basert på bestillingen:

- Tildeles virksomheten tilgang til Lånekassens testmiljø (API)
- Tildeles nødvendige scopes i Maskinporten
- Eventuelle API-nøkler og teknisk informasjon gjøres tilgjengelig via Altinn 3 eller oppgitt kontaktpunkt

Ved bruk av tredjepart:

- Tredjepart registreres i bestillingen
- Både virksomheten og tredjepart får tilgang til nødvendige scopes i Maskinporten
- Tredjepart er ansvarlig for å sette opp integrasjonen

Behandlingstid er normalt 1–3 virkedager.
B-5 Bestille tilgang til testmiljø Lånekassen (Bits) Bits bestiller tilgang til testmiljø hos Lånekassen for virksomheten.

Basert på bestillingen gir Lånekassen tilgang til API, Maskinporten og samtykkeløsningen for saldo på studielån.

Lånekassen sender API-nøkler direkte til kontaktperson for integrasjon.

Ved bruk av tredjepart får både virksomheten og tredjepart tilgang til nødvendige scopes i Maskinporten.

Dette kan ta opptil 1–3 virkedager.
B-6 Delegere tilgang til tredjepart/tredjepart i Altinn (IT/Forretning) Dette steget gjelder kun for virksomheter som benytter tredjepart, der tredjepart skal sende forespørsler på vegne av virksomheten.

Virksomheten må delegere nødvendige rettigheter til tredjepart via selvbetjeningsskjermbilder i Altinn (Altinn 3).

Fremgangsmåte:
Logg inn i Altinn 3 med en bruker som har tilstrekkelige rettigheter for virksomheten
Naviger til virksomhetens tilgangs- og rettighetsstyring
Velg aktuell tredjepart (organisasjon) som skal gis tilgang
Deleger følgende rettigheter knyttet til «Saldo på studielån»-tjenesten:
Tilgang til API for å hente saldoopplysninger
Tilgang til å administrere samtykkeforespørsler og samtykketokens

Resultat av delegering:
Tredjepart får nødvendige rettigheter til å sende forespørsler på vegne av virksomheten
Tredjepart kan benytte Maskinporten og samtykkeløsningen i henhold til tildelte rettigheter

Testmiljø:
Delegering gjennomføres i Altinn 3 sitt testmiljø (TT02 eller tilsvarende)
Virksomheten må benytte testbruker med tilstrekkelige rettigheter (f.eks. daglig leder-rolle eller tilsvarende)
Dersom virksomheten mangler testbruker eller tilgang i testmiljøet, må dette opprettes via Altinn 3 eller relevante støttekanaler

Produksjonsmiljø:
Delegering utføres av en bemyndiget representant for virksomheten (f.eks. daglig leder eller person med delegasjonsrettigheter)
Delegering gjøres direkte i Altinn 3 via virksomhetens tilgangsstyring

Merk:
All delegering og administrasjon av rettigheter håndteres nå direkte i Altinn 3, og krever ikke manuell involvering fra Bits

Virksomheten er selv ansvarlig for å tildele og vedlikeholde riktige tilganger til tredjepart

C - Påkobling til test og integrasjonstesting

I dette kapittelet finner man oversikt over oppgaver som må være gjort før virksomheten går over til produksjon.

Oppgaver    
C-1 Tilgang til test (Bits) Bits får bekreftelse fra Lånekassen om tilgang er gitt og informerer dermed virksomheten at de er i test.

Virksomheten mottar en API-key fra Lånekassen som legges i API-key feltet i header-forespørsel mot Lånekassen.
C-2 Samtykkeløsningen (IT) Løsningen skal implementeres slik at det forespørres samtykketoken via maskinporten hver gang kunde logger inn i nettbank, mobilbank og/eller økonomiapp.
C-3 Maskinporten (IT) Token fra Maskinporten har en varighet på 120 sekunder, og bankene må hente nytt maskinportentoken inklusive samtykke for hver kunde. Det kan ikke gjenbrukes token på tvers av kunder. Nytt access token forespørres når token er i ferd med å løpe ut.
C-4 Lånekassen API (IT) Løsningen implementeres slik at det forespørres data fra Lånekassen kun én gang hver gang kunde logger inn i nettbank, mobilbank og/eller økonomiapp. Dette innebærer at virksomhetene må benytte sesjonslagring.
C-5 Gjennomføre integrasjonstesten (IT) Integrasjonstest er et sett med testcaser som virksomheten må utføre før de kan gå i produksjon. Fullført integrasjonstest sendes til DSOP Support i prosess C-8.

For Maskinporten skal virksomhetene benytte TEST-miljø og Samtykkeløsninge skal TT02-miljø benyttes. URLer for miljøene finnes her.
C-6 Legge til Lånekassens logo med saldo på studielån i nettbank og mobilbank (IT) Bruk av logo står beskrevet på siden Logo Lånekassen og i bilag 5 til tjenestebeskrivelsen.
C-7 Abonnere på varsling fra Altinn og Digdir (IT/Forretning) Driftvarsel Altinn og Digdir
C-8 Virksomheten sender bekreftelse til Bits om at virksomheten er klar for produksjon (Forretning/IT) Virksomheten skal bekrefte følgende:

- Prosess C-2 til C-6 er utført

- Domener for produksjonsmiljø

E-posten sendes til DSOP Support.

Bits vil på bakgrunn av godkjent integrasjonstest og bekreftelse på ovvenevnte punkter bestille tilgang til produksjonsmiljø hos Lånekassen.

D - Påkobling til produksjon

I dette kapittelet finner du oversikt over oppgaver som bør gjøres i forbindelse med produksjon.

Oppgaver    
D-1 Motta API-nøkler og bekreftelse fra Lånekassen om at tilgang til Lånekassens produksjonsmiljø er opprettet. (IT) Virksomheten er i produksjon.
D-2 Forvaltningsrutiner (Forretning) Alle feilmeldinger, spørsmål til dokumentasjon og endringsønsker sendes til: DSOP Support

Endringslogg

Dato Endring Link i dokumentasjon
10.04.2026 Oppdatert informasjon om Altinn 3 A - Forberedelse
B - Registrering og avtaleinngåelse