idporten-oidc-demo-client

Innlogging med ID-porten

ID-porten testklient demonstrerer innlogging med ID-portens OpenID Connect-grensesnitt. Brukeren kan justere enkelte parametere på autorisasjonsforespørselen, autentisere seg i ID-porten og se resultatet. Interaksjonene med ID-porten samles opp på resultatsider og feilsider.

Applikasjonen støtter innlogging med ID-porten med:

• OpenID Connect Discovery for å lese konfigurasjon fra ID-porten - https://openid.net/specs/openid-connect-discovery-1_0.html

• JSON Web Keys leses fra ID-porten for validering av tokens - https://tools.ietf.org/html/rfc7517

• OpenID Connect Authorization code flow for innlogging - https://openid.net/specs/openid-connect-core-1_0.html#CodeFlowAuth

  • klientautentisering med client_secret basic, client_secret_post eller private_keyt_jwt for uthenting av tokens
  • PKCE ved klientautentisering - https://tools.ietf.org/html/rfc7636
  • Validering av state og nonce
  • Validering av ID-token

• OpenID Connect RP-Initiated Logout for utlogging - https://openid.net/specs/openid-connect-rpinitiated-1_0.html

Applikasjonen støtter også query-params for følgende felt

• scope
• authorization_details
• acr
• locale
• prompt

Dersom disse feltene sendes med så preutfylles skjemaet for autorisasjonsforespørselen. For å generere en slik lenke (som regel for å gi til andre) så er det letteste å preutfylle feltene selv og trykk på knappen for å generere permlenka. Denne legger seg på clipboard.

En typiske lenke vil se slik ut: http://demo-client.idporten.dev/idporten-oidc-demo-client?scopes=openid+profile+difitest%3Akrrrctrigger&acrValues=idporten-loa-substantial&uiLocales=nb

Begrensninger

Applikasjonen er ikke et startpunkt for å integrere med ID-porten

Applikasjonen er ikke et eksempel på hvordan en Spring Boot-basert applikasjon kan integreres med ID-porten. Applikasjonen samler opp interaksjonene og viser hva som skjer under en autentisering. Integrasjon mot ID-porten fra en kundeapplikasjon, gjøres best med kjente biblioteker på den plattformen kunden selv foretrekker.

Applikasjonen kan ikke brukes til å teste ID-portens grensesnitt i detalj

Applikasjonen tilbyr for lite funksjonalitet til å teste ID-porten i detalj. Det blir begrenset av mengden parametere som benyttes av applikasjonen, muligheten til å manipulere dette, samt at applikasjonen bruker biblioteker som gjør sjekker før interaksjon med ID-porten. Til detaljert testing har vi andre og mer egnede verktøy internt.

Bygge og kjøre lokalt

For å bygge og kjøre applikasjonen lokalt trenger du:

• Java 25
• Maven Og kjør følgende kommando frå rot-mappa:

mvn spring-boot:run -Dspring-boot.run.profiles=<profile>

Lokal bygging med Docker

Byggast og køyrast lokalt med docker compose

Frå rot-mappa kan ein køyre følgande kommando: docker-compose up --build

Prerequisite

Installert Docker desktop på maskina Legg til denne linja i host-fila: 127.0.0.1 democlient