Publisert - 10.11.2026

Autentisering

Ny fødselsmelding bruker HelseID for både autentisering og autorisasjon. APIet krever et gyldig HelseID-access-token (JWT) sendt i Authorization-headeren, med DPoP (Demonstrating Proof of Possession) som sikrer at tokenet ikke kan brukes av en annen part.

Hvordan du setter opp en HelseID-klient og henter et token, er beskrevet i HelseID-dokumentasjonen på Utviklerportalen.

Tilgang (scope)

Hvert kall krever at access-tokenet har det tilsvarende scopet:

Scope Gir tilgang til
nhn:birthsystem/read Status-endepunktene (GET /v1/birth/{messageId}, POST /v1/birth/get-by-hospital-child-identification-number)
nhn:birthsystem/write Registrering av fødsel (POST /v1/birth)

I tillegg krever alle endepunkter at tokenet er knyttet til en organisasjon (at brukerens organisasjonsnummer, orgnr_parent, er oppgitt).

Krav for å registrere en fødsel (write)

For å registrere en fødsel (POST /v1/birth) kreves i tillegg til nhn:birthsystem/write-scopet at den autentiserte personen oppfyller følgende:

  1. Jordmor eller lege – personen identifiseres ved HPR-nummeret i tokenet og må være registrert som jordmor eller lege. Systemet bekrefter dette mot HPR (Helsepersonellregisteret), og bruker userinfo-data fra HelseID dersom HPR ikke er tilgjengelig.
  2. Sikkerhetsnivå 4 – tokenet må ha et sikkerhetsnivå på minst 4.
  3. HPR-nummer – tokenet må inneholde HPR-nummeret.

Disse tre kravene sikrer at kun autorisert helsepersonell (jordmødre og leger) kan registrere fødsler.

Note

Identiteten til jordmor/lege hentes fra tokenet, ikke fra selve fødselsmeldingen. Når en fødsel registreres, slår systemet opp personen bak tokenet og tilknytter navn, fødselsnummer (PID), HPR-nummer og organisasjonsnummer til meldingen. Disse dataene sendes til Folkeregisteret som jordmorEllerForloesendeLege.

DPoP

Med DPoP binder APIet kryptografisk access-tokenet til klienten, slik at tokenet ikke kan brukes av noen andre:

  • Hver forespørsel må inneholde et DPoP-bevis (DPoP-header) generert med den samme privatnøkkelen som ble brukt til å hente tokenet.
  • APIet har replay-deteksjon slått på: et DPoP-bevis kan kun brukes én gang og er gyldig i et lite tidsvindu (5 sekunder).

Det betyr at du som integrator må implementere DPoP i henhold til HelseID-dokumentasjonen: send både Authorization: DPoP <token> og en tilhørende DPoP-header med hvert kall.

Feilkoder knyttet til autentisering

HTTP-status Betydning
401 Unauthorized Access-token mangler, eller tokenet er ugyldig, utløpt eller ikke-gjenkjent. Kan også skyldes at DPoP-beviset ikke kunne bekreftes.
403 Forbidden Tokenet er gyldig, men brukeren mangler den nødvendige scopen, organisasjonstilknytning, eller oppfyller ikke jordmor/lege-kravene (write).

Søk i Utviklerportalen

Søket er fullført!