API Dokumentasjon
Om Persontjenesten
Persontjenesten er helsetjenestens sannhetskilde for folkeregisterinformasjon, og vil gi helsetjenesten rask tilgang til oppdaterte personopplysninger. Persontjenesten skal erstatte dagens Personregister (PREG), hvor hovedinformasjonskilden vil være det moderniserte Folkeregisteret fra Skatteetaten.
Slik går du frem for å utvikle integrasjon
NB! Persontjenesten er beskyttet med HelseID's nye løsning med JWK / Nøkkelpar. Denne løsningen takler pr.i dag 07.04.2022, ikke multitenant webløsninger. Dersom ditt system er multitenant og du ønsker å utvikle integrasjon mot Persontjenesten, ta kontakt med kundesenter@nhn.no for avklaring om når dette er klart.
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
Persontjenesten kan i produksjon kun nås i helsenettet, på endepunkt:
https://api.persontjenesten.nhn.no (IP: 83.118.132.0, Port: 443)
Alle nye tjenester som tilgjengeliggjøres fra NHNs private sky vil bli publisert på
IP-range: 83.118.132.0/22
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.