Om Persontjenesten
Persontjenesten er helsetjenestens sannhetskilde for folkeregisterinformasjon fra Skatteetaten, og vil gi helsesektoren rask tilgang til oppdaterte personopplysninger. Persontjenesten erstatter tidligere Personregister (PREG).
Persontjenesten tilbyr et testmiljø hvor du som systemleverandør kan teste integrasjonen fra ditt fagsystem mot Persontjenesten.
Registrer tilgang for din virksomhet gjennom Webskjema Testmiljø Persontjenesten. Dette skjemaet benyttes kun for å holde en oversikt over hvilke aktører som har bedt om tilgang, og du trenger ikke vente på tilbakemelding før du går videre.
Videre konfigurerer du tilgang til Persontjenesten i HelseID's selvbetjeningsløsning. Start med å opprette et nytt klientsystem hvis din virksomhet ikke allerede har opprettet dette for fagsystemet du skal utvikle en integrasjon for.
For mer informasjon om testmiljøet, se siden Test og testmiljø.
For mer informasjon om hvordan HelseID og Persontjenesten samhandler, se HelseID og Persontjenesten.
OBS!
Dersom ditt produkt allerede er koblet til en annen tjeneste fra Norsk helsenett som er beskyttet av HelseID som benytter Client ID og Client Secret (sikkherhetsnivå 2) må du sikre at ditt produkt kan håndtere begge nivåene av HelseID for å sikre at du fortsatt har tilgang til alle aktuelle tjenester fra NHN.
Når man har fått tilgang på Persontjenstens eksterne testmiljø og har konfigurert en HelseID klient, er man klar til å utvikle og teste en integrasjon mot Persontjenestens API.
Se følgende lenker for mer informasjon:
Testmiljøet kan brukes til:
- Funksjonell testing av en integrasjon fra et fagsystem mot Persontjenesten
- Autentisering og autorisasjon med HelseID fra fagsystemet
Testmiljøet kan ikke brukes til:
- Ytelsestesting av et fagsystems integrasjon mot Persontjenesten
Godkjenning av integrasjon mot HelseID
Før produksjonssetting må konsumentsystemets integrasjon mot HelseID godkjennes. Dette gjøres ved å bruke "Start produksjonssetting" knappen i HelseID selvbetjening for klientsystemet som skal produksjonssettes. Når dette gjøres vil dere bli kontaktet av HelseID for en gjennomgang.
Etter at løsningen er godkjent, er det klart for at helsevirksomheter kan ta fagsystemet i bruk. Beskrivelse av hvordan helsevirksomheter kommer i gang finner du her: Helsevirksomheter Kom i gang.
Tilgang til Persontjenesten på helsenettet
Persontjenestens produksjonsmiljø nås kun over helsenettet på https://api.persontjenesten.nhn.no. Tjenesten er tilgjengelig innenfor nettsegment 83.118.132.0/22 og det forutsettes at man har åpnet for utgående trafikk over port 443 i sin lokale brannmur til dette nettsegmentet.
Det gjøres oppmerksom på at dette er et annet IP‑segment enn enkelte andre NHN‑tjenester. Hvis din organisasjon allerede bruker tjenester via helsenettet, må dere kanskje likevel legge til nye brannmur‑regler for Persontjenesten eller andre tjenester på NHN privat sky.
Viktig informasjon om automatisk failover
Persontjenesten kan, ved vedlikehold eller driftsforstyrrelser, automatisk fail‑over til alternative servere som kan bruke andre IP‑adresser innenfor samme /22‑range. Dersom du har konfigurert brannmuren med kun én enkelt IP‑adresse fra dette segmentet i stedet for å tillate hele 83.118.132.0/22‑området, vil du kunne miste tilgangen på de tidspunktene når failover skjer og tjenesten benytter en annen adresse i området.
Anbefaling:
Åpne utgående trafikk for hele IP‑området 83.118.132.0/22 (ikke bare en enkelt IP) på port 443.
Kontroller regelmessig at brannmur‑reglene fortsatt dekker hele området, spesielt etter oppdateringer eller endringer i nettverket.
Ved å legge til hele IP‑range sikrer du at tilgangen til Persontjenesten forblir stabil også ved automatiske failover‑hendelser.