00 - Introduksjon og Brukerhistorier som støttes

Owned by sven.christiansen (Unlicensed)
Last updated: Aug 09, 2022 by sven.christiansen

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: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1389330656

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

    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.

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

    • Detaljert teknisk dokumentasjon:

Hvordan komme i gang

Ta kontakt med NHN for å avtale integrasjon. Se her for detaljer: