.. _eherkenning_oidc: ================================================ Configuration for eHerkenning via OpenID Connect ================================================ Settings Overview ================= Enable/Disable configuration: """"""""""""""""""""""""""""" :: EHERKENNING_OIDC_CONFIG_ENABLE Required: """"""""" :: EHERKENNING_OIDC_OIDC_RP_CLIENT_ID EHERKENNING_OIDC_OIDC_RP_CLIENT_SECRET All settings: """"""""""""" :: EHERKENNING_OIDC_ENABLED EHERKENNING_OIDC_LEGAL_SUBJECT_CLAIM EHERKENNING_OIDC_OIDC_KEYCLOAK_IDP_HINT EHERKENNING_OIDC_OIDC_NONCE_SIZE EHERKENNING_OIDC_OIDC_OP_AUTHORIZATION_ENDPOINT EHERKENNING_OIDC_OIDC_OP_DISCOVERY_ENDPOINT EHERKENNING_OIDC_OIDC_OP_JWKS_ENDPOINT EHERKENNING_OIDC_OIDC_OP_LOGOUT_ENDPOINT EHERKENNING_OIDC_OIDC_OP_TOKEN_ENDPOINT EHERKENNING_OIDC_OIDC_OP_USER_ENDPOINT EHERKENNING_OIDC_OIDC_RP_CLIENT_ID EHERKENNING_OIDC_OIDC_RP_CLIENT_SECRET EHERKENNING_OIDC_OIDC_RP_IDP_SIGN_KEY EHERKENNING_OIDC_OIDC_RP_SCOPES_LIST EHERKENNING_OIDC_OIDC_RP_SIGN_ALGO EHERKENNING_OIDC_OIDC_STATE_SIZE EHERKENNING_OIDC_OIDC_USE_NONCE EHERKENNING_OIDC_USERINFO_CLAIMS_SOURCE Detailed Information ==================== :: Variable EHERKENNING_OIDC_ENABLED Setting enable Description Indicates whether OpenID Connect for authentication/authorization is enabled Possible values True, False Default value False Variable EHERKENNING_OIDC_LEGAL_SUBJECT_CLAIM Setting bedrijfsidenticatie-claim Description Naam van de claim die de identificatie van het ingelogde/vertegenwoordigde bedrijf bevat. Possible values No information available Default value urn:etoegang:core:LegalSubjectID Variable EHERKENNING_OIDC_OIDC_KEYCLOAK_IDP_HINT Setting Keycloak Identity Provider hint Description Specific for Keycloak: parameter that indicates which identity provider should be used (therefore skipping the Keycloak login screen). Possible values string Default value No default Variable EHERKENNING_OIDC_OIDC_NONCE_SIZE Setting Nonce size Description Sets the length of the random string used for OpenID Connect nonce verification Possible values string representing a positive integer Default value 32 Variable EHERKENNING_OIDC_OIDC_OP_AUTHORIZATION_ENDPOINT Setting Authorization endpoint Description URL of your OpenID Connect provider authorization endpoint Possible values string (URL) Default value No default Variable EHERKENNING_OIDC_OIDC_OP_DISCOVERY_ENDPOINT Setting Discovery endpoint Description URL of your OpenID Connect provider discovery endpoint ending with a slash (`.well-known/...` will be added automatically). If this is provided, the remaining endpoints can be omitted, as they will be derived from this endpoint. Possible values string (URL) Default value No default Variable EHERKENNING_OIDC_OIDC_OP_JWKS_ENDPOINT Setting JSON Web Key Set endpoint Description URL of your OpenID Connect provider JSON Web Key Set endpoint. Required if `RS256` is used as signing algorithm. Possible values string (URL) Default value No default Variable EHERKENNING_OIDC_OIDC_OP_LOGOUT_ENDPOINT Setting Logout endpoint Description URL of your OpenID Connect provider logout endpoint Possible values string (URL) Default value No default Variable EHERKENNING_OIDC_OIDC_OP_TOKEN_ENDPOINT Setting Token endpoint Description URL of your OpenID Connect provider token endpoint Possible values string (URL) Default value No default Variable EHERKENNING_OIDC_OIDC_OP_USER_ENDPOINT Setting User endpoint Description URL of your OpenID Connect provider userinfo endpoint Possible values string (URL) Default value No default Variable EHERKENNING_OIDC_OIDC_RP_CLIENT_ID Setting OpenID Connect client ID Description OpenID Connect client ID provided by the OIDC Provider Possible values string Default value No default Variable EHERKENNING_OIDC_OIDC_RP_CLIENT_SECRET Setting OpenID Connect secret Description OpenID Connect secret provided by the OIDC Provider Possible values string Default value No default Variable EHERKENNING_OIDC_OIDC_RP_IDP_SIGN_KEY Setting Sign key Description Key the Identity Provider uses to sign ID tokens in the case of an RSA sign algorithm. Should be the signing key in PEM or DER format. Possible values string Default value No default Variable EHERKENNING_OIDC_OIDC_RP_SCOPES_LIST Setting OpenID Connect scopes Description OpenID Connect scopes that are requested during login. These scopes are hardcoded and must be supported by the identity provider. Possible values string, comma-delimited ('foo,bar,baz') Default value openid, kvk Variable EHERKENNING_OIDC_OIDC_RP_SIGN_ALGO Setting OpenID sign algorithm Description Algorithm the Identity Provider uses to sign ID tokens Possible values string Default value HS256 Variable EHERKENNING_OIDC_OIDC_STATE_SIZE Setting State size Description Sets the length of the random string used for OpenID Connect state verification Possible values string representing a positive integer Default value 32 Variable EHERKENNING_OIDC_OIDC_USE_NONCE Setting Use nonce Description Controls whether the OpenID Connect client uses nonce verification Possible values True, False Default value True Variable EHERKENNING_OIDC_USERINFO_CLAIMS_SOURCE Setting user information claims extracted from Description Indicates the source from which the user information claims should be extracted. Possible values userinfo_endpoint, id_token Default value userinfo_endpoint