Bakgrunn

Norsk helsenett (NHN) avvikler versjon 1 og 2 av Person API for Persontjenesten. For at oppslag mot Persontjenesten fortsatt skal fungere i Opus etter 31. mars 2026, må HelseID-klienten deres oppdateres med nytt scope.

Før du starter

Sjekk at dere har:

• Opus versjon 7.1.683
• tilgang til HelseID selvbetjeningsportalen https://selvbetjening.nhn.no/
• tilgang til å laste ned / oppdatere HelseID-konfigurasjonen som brukes av Opus
  (se evt. punktet Tilgangsstyring i oppsett for persontjenesten her: https://help.v7.opusdental.com/opus-dental-teknisk/persontjenesten)
• mulighet til å restarte Opus-tjenestene / serveren etterpå

Hvilket scope / API skal dere velge?

Bruk kun ett av disse, avhengig av virksomhetstype:

Offentlige virksomheter

For eksempel fylkeskommuner, universiteter og andre offentlige aktører:

• nhn:hgd-persontjenesten-api/full-access

Private virksomheter

For eksempel private tannklinikker og kjeder: 

• nhn:hgd-persontjenesten-api/restricted-access 
  Viktig: NHN har opplyst at private virksomheter kun har lov til å bruke restricted-access.

Slik gjør dere det

1. Logg inn i HelseID selvbetjeningsportalen

Gå til HelseID selvbetjeningsportalen og logg inn med en bruker som har rettigheter til å administrere klienten deres.

2. Finn klienten som brukes av Opus Dental

Åpne klienten som brukes for Opus Dental / Persontjenesten.
Hvis dere er usikre på hvilken klient dette er (f.eks. ved flere klienter) må det avklares før dere gjør endringer.

3. Oppdater scopes

Finn området for scopes / API-tilganger i klienten.

Legg til riktig nytt scope:

• offentlig virksomhet: nhn:hgd-persontjenesten-api/full-access
• privat virksomhet: nhn:hgd-persontjenesten-api/restricted-access

De gamle scope-verdiene ser slik ut:

• nhn:hgd-persontjenesten-api/read-with-legal-basis
• nhn:hgd-persontjenesten-api/read-no-legal-basis

Disse er under utfasing og vil slutte å fungere.

4. Lagre endringen

Lagre klientoppsettet i HelseID-portalen.

5. Last ned oppdatert konfigurasjon

Last ned oppdatert HelseID-konfigurasjon / klientfil på samme måte som dere har gjort tidligere.

6. Legg inn ny konfigurasjon hos dere

Legg inn den nye HelseID-konfigurasjonen der den eksisterende brukes av Opus i dag.

Da kommer dette bildet opp, og du henter filen vha knappen med tre prikker.

7. Restart Opus-tjenestene / serveren

Restart tjenestene slik at ny konfigurasjon og nye scopes tas i bruk.

Hvordan tester dere at det fungerer?

Når restart er gjort:

1. Åpne Opus
2. Gjør et vanlig oppslag mot Persontjenesten / personsøk
3. Kontroller at oppslaget fungerer som forventet

Hvis oppslaget fungerer som normalt, er HelseID-oppsettet oppdatert riktig.

Hvis noe ikke virker

Ta kontakt med Opus Teknisk Support og ha gjerne dette klart (tastevalg 2):

• navn på virksomheten
• om dere er offentlig eller privat
• hvilken Opus-versjon dere kjører
• tidspunkt for når dere gjorde endringen
• skjermbilde / feilmelding hvis dere får feil
• navn på HelseID-klienten dere oppdaterte