Skip to main content
Version: 8.8 (unreleased)

Configuration

As a Spring Boot application, the Orchestration Cluster supports standard Spring configuration methods.

The following configurations apply to all components within the Orchestration Cluster.

Environment variableDescriptionDefault value
CAMUNDA_PERSISTENT_SESSIONS_ENABLEDStores session data in secondary storage so users stay logged in across cluster nodes.true
CAMUNDA_SECURITY_AUTHENTICATION_METHODThe authentication method to use. Options: basic, oidc, none.basic
CAMUNDA_SECURITY_AUTHENTICATION_UNPROTECTEDAPIIf the API can be used without authentication.false
CAMUNDA_SECURITY_AUTHORIZATIONS_ENABLEDIf authorizations are enabled.true
CAMUNDA_SECURITY_MULTITENANCY_CHECKSENABLEDEnables multi-tenancy checks. This requires the API to be protected.false
CAMUNDA_SECURITY_MULTITENANCY_APIENABLEDEnables the multi-tenancy API and UI independently from multi-tenancy checks.true
SPRING_PROFILES_ACTIVENote: This property will be deprecated as additional authentication methods become available.consolidated-auth

Initialization

The following variables are used to initialize users and mappings.

Environment variableDescriptionDefault value
CAMUNDA_SECURITY_INITIALIZATION_USERS[0]_USERNAMEThe username of the first user.
CAMUNDA_SECURITY_INITIALIZATION_USERS[0]_PASSWORDThe password of the first user.
CAMUNDA_SECURITY_INITIALIZATION_USERS[0]_NAMEThe name of the first user.
CAMUNDA_SECURITY_INITIALIZATION_USERS[0]_EMAILThe email address of the first user.
CAMUNDA_SECURITY_INITIALIZATION_DEFAULTROLES_<role>_USERS[0]Users assigned to the <role> role.
CAMUNDA_SECURITY_INITIALIZATION_DEFAULTROLES_<role>_GROUPS[0]Groups assigned to the <role> role.
CAMUNDA_SECURITY_INITIALIZATION_DEFAULTROLES_<role>_CLIENTS[0]Clients assigned to the <role> role.
CAMUNDA_SECURITY_INITIALIZATION_DEFAULTROLES_<role>_MAPPINGS[0]Mappings assigned to the <role> role.

OIDC Configuration

The following variables are used when oidc is selected as the authentication method.

Environment variableDescriptionDefault value
CAMUNDA_SECURITY_AUTHENTICATION_OIDC_CLIENTIDThe client ID for OIDC authentication.
CAMUNDA_SECURITY_AUTHENTICATION_OIDC_CLIENTSECRETThe client secret for OIDC authentication.
CAMUNDA_SECURITY_AUTHENTICATION_OIDC_ISSUERURIThe issuer URI for OIDC authentication.
CAMUNDA_SECURITY_AUTHENTICATION_OIDC_REDIRECTURIThe redirect URI for OIDC authentication.http://localhost:8080/sso-callback
CAMUNDA_SECURITY_AUTHENTICATION_OIDC_USERNAMECLAIMThe claim to use for the username in OIDC authentication.sub
CAMUNDA_SECURITY_AUTHENTICATION_OIDC_GROUPSCLAIMThe claim to use for groups in OIDC authentication.
CAMUNDA_SECURITY_AUTHENTICATION_OIDC_AUDIENCESComma-separated list of audiences to validate in the OIDC token.