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:
- 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.
- Sikkerhetsnivå 4 – tokenet må ha et sikkerhetsnivå på minst 4.
- 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). |