Introduksjon

Eksterne systemer kan integrere seg med Helsenorge for å levere digitale innbyggertjenester. Hvilke integrasjoner som tilbys på Helsenorge baseres på markedsbehov og prosjekter mellom aktører i helse-og omsorgsektoren og Norsk Helsenett (NHN). Forutsetning for at et eksternt system skal kunne integreres er:

• At det eksterne systemet er forhåndsdefinert på Helsenorge som et tiltrodd system, og avtale om tilknytning til Helsenorge eller PVK (Personvernkomponenten) er inngått

• At det eksterne systemet støtter sikkerhetsmodellen som er definert for Helsenorge

• At det eksterne systemet ivaretar innbyggers personvern i henhold til lover, regler og forskrifter

UseCase som støttes

Det støttes 4 UseCases:

1. System til System: Der et eksternt system får tilgang til API’er på Helsenorge eller i PVK uten at det kreves at det er i context av en innlogget bruker. Det eksterne systemet er ansvarlig for å autentisere og autorisere brukerne samt at det eksisterer tjenestelig behov.

2. Innbygger går fra Helsenorge til et eksternt system: Innlogget bruker på Helsenorge gjør “uthopp” til et eksternt system uten ny innlogging.

3. Innbygger skal logges inn i eksternt system eller applikasjon som skal integreres med Helsenorge: Dette er web-applikasjoner/portaler eller mobil-applikasjoner der innbygger er/skal innlogges og skal ha tilgang til API’er/funksjonalitet på Helsenorge på vegne av innbygger

Teknisk dokumentasjon for UseCasene finnes på undersider her: 01 - Sikkerhetsmodell og Helsenorge sikkerhetstjeneste

Overordnet sikkerhetsmodell

1. Eksternt system må alltid autentisere seg mot Helsenorge sikkerhetstjeneste (Innbygger STS) for å få utstedt en sikkerhetsbillett (AccessToken) før API’er kan benyttes:

   1. Usecase 1 (System-til-system): Helsenorge sin Oauth2 autorisasjonsserver (Innbygger STS). Alle systemer som skal benytte API'er på Helsenorge må først autentisere seg mot Helsenorge sin sikkerhetstjeneste

      • Detaljert teknisk dokumentasjon: 01 - System til System

   2. Usecase 2 og 3: Når eksternt system understøtte innbygger (pasient) innlogging, benyttes Helsenorge sin OpenId Connect provider. Systemet får da et ID-token (som identifiserer innlogget og representert innbygger) samt et AksessToken for eventuell bruk av API’er på Helsenorge på vegne av innbygger.

      • Detaljert teknisk dokumentasjon: 03 - Innbygger innlogging - Helsenorge som OpenID Connect provider

2. Sikkerhetsbilletten (AcessToken) skal etterpå være med i alle kall til Helsenorge API'ene.

   • Detaljert teknisk dokumentasjon: 02 - Kall til Helsenorge og PVK API'er og bruk av AccessToken

Hvordan komme i gang

Ta kontakt med NHN for å avtale integrasjon. Se her for detaljer: Hvordan komme i gang