Innledning

Endring i Helsenorge sitt v2 well-known endepunkt (egentlig ment for OIDC, men vi vet at flere andre bruker endepunktet for å lese /jwk url): Vi ser ut i fra loggene våre at noen fortsatt bruke det gamle endepunktet, /v2. Det har nådd sin sluttdato (januar 2024) og det er nødvendig at det implementeres en snarlig overgang til v3-endepunktet hos oss da vi ønsker å skru det helt av, men i og med at det er et åpent endepunkt så er det ikke så enkelt å finne ut hvem det gjelder.

Hva endres

Det er ikke noe breaking change fra v2 til v3 i /.well-known og /jwk, så det skal være å bare erstatte url. Nedenfor finner dere et eksempel på hva som må endres:

Gamle URL-er:
<miljø>/sts/helsenorge-oidc-provider/v2/.well-known/openid-configuration

<miljø>/sts/helsenorge-oidc-provider/v2/jwk

Ny URL-er:
<miljø>/sts/oidcprov/v3/.well-known/openid-configuration

<miljø>/sts/oidcprov/v3/jwk

Hvis dere har en health-check eller lignende, så kan det hende denne feiler (OIDC-url’er fjernes fra responsen). TEST01 har eksempel på oppdatert respons;

https://eksternapi.hn.test.nhn.no/sts/helsenorge-oidc-provider/v2/.well-known/openid-configuration

Vi setter pris på om dere kan sjekke om dere fortsatt bruker v2, og da endre til v3. Eventuelt sjekke at integrasjonen fortsatt fungerer etter endringen i v2, og melde fra til oss om når dere kan endre til v3 på et senere tidspunkt.

Hvorfor gjøres endringen

Endepunktet har nådd sin sluttdato, og det er kommet ny versjon.

Mer informasjon finner dere her:

V3 - OpenID Connect /API-tilgang (IdToken og AccessToken)

Frister

Endring i respons for v2

I Helsenorge-leveranse 25.02.0, den 26. februar 2025 vil responsen i v2 endepunktet endres litt. Som beskrevet i seksjonen over.

TEST01: Oppdatert

TEST02: Mandag 17. februar 2025.

Produksjon: Onsdag. 26. februar 2025.

Avvikling av v2

I Helsenorge-leveranse 25.03.0, den 19. Mars 2025 vil vi avvikle v2.

TEST01: Uke 10 2025.

TEST02: Mandag 10. Mars 2025.

Produksjon: Onsdag 19. Mars 2025.