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

V2-endepunktet blir ikke skrudd av før det må, men i Helsenorge-leveranse 25.02.0, den 26. februar vil responsen endres litt.

TEST01: Oppdatert

TEST02: Mandag 17. februar.

Produksjon: Onsdag. 26. februar.

Avvikling av v2

Her vil det komme oppdatering når tidspunkt for avvikling av v2 endepunktet er avklart.

TEST01: TBA

TEST02: TBA

Produksjon: TBA