Description

Open ID Connect configuration.

Usages

Configuration options

KeyKindTypeDefault ValueDescription
access-token-ip-checkVALUEBooleantrueWhether to check if current IP address matches the one access token was issued for
audienceVALUEString Audience of issued tokens
authorization-endpoint-uriVALUEURI URI of an authorization endpoint used to redirect users to for logging-in
base-scopesVALUEStringopenidConfigure base scopes
check-audienceVALUEBooleantrueConfigure audience claim check
client-credentials-configVALUEi.h.s.p.o.c.ClientCredentialsConfig Set the configuration related to the client credentials flow
client-idVALUEString Client ID as generated by OIDC server
client-secretVALUEString Client secret as generated by OIDC server
client-timeout-millisVALUEDuration30000Timeout of calls using web client
cookie-domainVALUEString Domain the cookie is valid for
cookie-encryption-enabledVALUEBooleanfalseWhether to encrypt token cookie created by this microservice
cookie-encryption-id-enabledVALUEBooleantrueWhether to encrypt id token cookie created by this microservice
cookie-encryption-nameVALUEString Name of the encryption configuration available through Security#encrypt(String, byte[) and Security#decrypt(String, String)]
cookie-encryption-passwordLISTString Master password for encryption/decryption of cookies
cookie-encryption-refresh-enabledVALUEBooleantrueWhether to encrypt refresh token cookie created by this microservice
cookie-encryption-state-enabledVALUEBooleantrueWhether to encrypt state cookie created by this microservice
cookie-encryption-tenant-enabledVALUEBooleantrueWhether to encrypt tenant name cookie created by this microservice
cookie-http-onlyVALUEBooleantrueWhen using cookie, if set to true, the HttpOnly attribute will be configured
cookie-max-age-secondsVALUELong When using cookie, used to set MaxAge attribute of the cookie, defining how long the cookie is valid
cookie-nameVALUEStringJSESSIONIDName of the cookie to use
cookie-name-id-tokenVALUEStringJSESSIONID_2Name of the cookie to use for id token
cookie-name-refresh-tokenVALUEStringJSESSIONID_3The name of the cookie to use for the refresh token
cookie-name-stateVALUEStringJSESSIONID_3The name of the cookie to use for the state storage
cookie-name-tenantVALUEStringHELIDON_TENANTThe name of the cookie to use for the tenant name
cookie-pathVALUEString/Path the cookie is valid for
cookie-same-siteVALUEi.h.h.S.SameSiteLAXWhen using cookie, used to set the SameSite cookie value
cookie-secureVALUEBooleanfalseWhen using cookie, if set to true, the Secure attribute will be configured
cookie-useVALUEBooleantrueWhether to use cookie to store JWT between requests
corsVALUEi.h.c.CrossOriginConfig Assign cross-origin resource sharing settings
decryption-keys.resourceVALUEi.h.c.c.Resource A resource pointing to JWK with private keys used for JWE content key decryption
force-https-redirectsVALUEBooleanfalseForce HTTPS for redirects to identity provider
frontend-uriVALUEString Full URI of this application that is visible from user browser
header-tokenVALUEi.h.s.u.TokenHandler A TokenHandler to process header containing a JWT
header-useVALUEBooleantrueWhether to expect JWT in a header field
id-token-signature-validationVALUEBooleantrueWhether id token signature check should be enabled
identity-uriVALUEURI URI of the identity server, base used to retrieve OIDC metadata
introspect-endpoint-uriVALUEURI Endpoint to use to validate JWT
issuerVALUEString Issuer of issued tokens
max-redirectsVALUEInteger5Configure maximal number of redirects when redirecting to an OIDC provider within a single authentication attempt
oidc-metadata-well-knownVALUEBooleantrueIf set to true, metadata will be loaded from default (well known) location, unless it is explicitly defined using oidc-metadata-resource
oidc-metadata.resourceVALUEi.h.c.c.Resource Resource configuration for OIDC Metadata containing endpoints to various identity services, as well as information about the identity server
optional-audienceVALUEBooleanfalseAllow audience claim to be optional
outbound-typeVALUEi.h.s.p.o.c.OidcOutboundTypeUSER_JWTType of the OIDC outbound
pkce-challenge-methodVALUEi.h.s.p.o.c.PkceChallengeMethodS256Proof Key Code Exchange (PKCE) challenge creation method
pkce-enabledVALUEBooleanfalseWhether this provider should support PKCE
proxy-portVALUEInteger80Proxy port
query-id-token-param-nameVALUEStringid_tokenName of a query parameter that contains the JWT id token when parameter is used
query-param-nameVALUEStringaccessTokenName of a query parameter that contains the JWT access token when parameter is used
query-param-tenant-nameVALUEStringh_tenantName of a query parameter that contains the tenant name when the parameter is used
query-param-useVALUEBooleanfalseWhether to use a query parameter to send JWT token from application to this server
redirectVALUEBooleanfalseBy default, the client should redirect to the identity server for the user to log in
redirect-attempt-paramVALUEStringh_raConfigure the parameter used to store the number of attempts in redirect
redirect-uriVALUEString/oidc/redirectURI to register web server component on, used by the OIDC server to redirect authorization requests to after a user logs in or approves scopes
scope-audienceVALUEString Audience of the scope required by this application
server-typeVALUEString@defaultConfigure one of the supported types of identity servers
sign-jwk.resourceVALUEi.h.c.c.Resource A resource pointing to JWK with public keys of signing certificates used to validate JWT
tenantsVALUEi.h.s.p.o.c.TenantConfig Configurations of the tenants
token-endpoint-authVALUEi.h.s.p.o.c.O.ClientAuthenticationCLIENT_SECRET_BASICType of authentication to use when invoking the token endpoint
token-endpoint-uriVALUEURI URI of a token endpoint used to obtain a JWT based on the authentication code
token-signature-validationVALUEBooleantrueWhether access token signature check should be enabled
validate-jwt-with-jwkVALUEBooleantrueUse JWK (a set of keys to validate signatures of JWT) to validate tokens
webclientVALUEi.h.w.a.WebClient WebClient configuration used for outbound requests to the identity server. This configuration sets the values to the OIDC WebClient default configuration

Deprecated Options

KeyKindTypeDefault ValueDescription
proxy-hostVALUEString Proxy host to use
proxy-protocolVALUEStringhttpProxy protocol to use when proxy is used
relative-urisVALUEBooleanfalseCan be set to true to force the use of relative URIs in all requests, regardless of the presence or absence of proxies or no-proxy lists

See the manifest for all available types.