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:

• API dokumentasjon
• OpenAPI spesifikasjon
• Kodeeksempler

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.