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 eksternt testmiljø (ET) hvor du som systemleverandør kan teste integrasjonen fra ditt fagsystem mot Persontjenesten.
Tilgang til testmiljøet bestilles her: Webskjema Testmiljø Persontjenesten
Persontjenstens API er beskyttet med HelseID. Tilgang fra ditt fagsystem mot Persontjenesten konfigureres i HelseID Selvbetjeningsløsning.
Følg denne guiden for å konfigurere tilgang: Konfigurerer HelseID for Persontjenesten
Se siden Test og testmiljø for mer informasjon.
Trykk her for å lese mer om hvordan HelseID og Persontjenesten samhandler
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
Når integrasjonen fra et fagsystem er ferdig implementert og testet, må løsningen selvdeklareres slik at NHN har informasjon om hvem som er klare for å tilby Persontjenesten ut til helsevirksomheter. For å bli godkjent som leverandør må integrasjonen fra fagsystemet godkjennes av HelseID. Hensikten er å sikre at at løsninger som produksjonsettes ikke har store feil eller svakheter som går utover informasjonssikkerhet eller personvern.
Se Godkjenningsprosess HelseID
For å starte godkjenningsprosessen, ta kontakt med vårt kundesenter på kundesenter@nhn.no
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.
Godkjenning av integrasjon mot HelseID
Før produksjonssetting må konsumentsystemets integrasjon mot HelseID godkjennes. Når løsningen er godkjent, må leverandøren opprette de nødvendige konfigurasjonene i HelseID selvbetjening for produksjon slik at den er mulig å ta i bruk for sine konsumenter.
Trykk her for å komme til Selvbetjeningsportalen
Etter dette er det klart for at Helsevirksomheter kan ta API'et i bruk. Beskrivelse av hvordan helsevirksomheter kommer i gang finner du her: Helsevirksomheter Kom i gang.