//
// Licensed to the Apache Software Foundation (ASF) under one
// or more contributor license agreements.  See the NOTICE file
// distributed with this work for additional information
// regarding copyright ownership.  The ASF licenses this file
// to you under the Apache License, Version 2.0 (the
// "License"); you may not use this file except in compliance
// with the License.  You may obtain a copy of the License at
//
//   http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing,
// software distributed under the License is distributed on an
// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
// KIND, either express or implied.  See the License for the
// specific language governing permissions and limitations
// under the License.
//

=== Configuration Parameters

Most run-time configuration options are available as parameters and can be tuned via the admin console:

* `password.cipher.algorithm` - which cipher algorithm shall be used for encrypting password values; supported 
algorithms include `SHA-1`, `SHA-256`, `SHA-512`, `AES`, `S-MD5`, `S-SHA-1`, `S-SHA-256`, `S-SHA-512` and `BCRYPT`;
salting options are available in the `core.properties` file;
[WARNING]
The value of the `security.aesSecretKey` property in the `core.properties` file is used for AES-based encryption /
decryption: besides password values, this is also used whenever reversible encryption is needed, throughout the whole
system. +
The actual length of the `security.aesSecretKey` value is used to drive the AES algorithm variant selection:
16 characters implies `AES-128`, 24 selects `AES-192` and 32 configures `AES-256`. +
When the `security.aesSecretKey` value has length less than 16, between 17 and 23 or between 25 and 31, it is
right-padded by random characters during startup, to reach the nearest option. If the specified value is instead longer
than 32 characters, it is truncated to 32. +
It is *strongly* recommended to provide a value long exactly 16, 24 or 32 characters, in order to avoid unexpected
behaviors at runtime, expecially with high-availability. 
* `jwt.lifetime.minutes` - validity of https://en.wikipedia.org/wiki/JSON_Web_Token[JSON Web Token^] values used for
<<rest-authentication-and-authorization,authentication>> (in minutes);
* `notificationjob.cronExpression` -
https://docs.spring.io/spring-framework/reference/6.2/integration/scheduling.html#scheduling-cron-expression[cron^] expression describing how
frequently the pending <<tasks-notification,notification tasks>> are processed: empty means disabled;
[NOTE]
Restarting the deployment is required when changing value for this parameter.
* `notification.maxRetries` - how many times the delivery of a given notification should be attempted before giving up;
[NOTE]
Restarting the deployment is required when changing value for this parameter.
* `token.length` - the length of the random tokens that can be generated as part of various <<workflow,workflow>>
processes, including <<password-reset,password reset>>;
* `token.expireTime` - the time after which the generated random tokens expire;
* `selfRegistration.allowed` - whether self-registration (typically via the enduser application) is allowed;
* `passwordReset.allowed` - whether the <<password-reset,password reset>> feature (typically via the enduser
application) is allowed;
* `passwordReset.securityQuestion` - whether the <<password-reset,password reset>> feature involves security questions;
* `authentication.attributes` - the list of attributes whose values can be passed as login name for authentication,
defaults to `username`; please note that the related <<plain,plain schemas>> must impose the unique constraint, for this
mechanism to work properly;
* `authentication.statuses` - the list of <<workflow,workflow>> statuses for which users are allowed to authenticate;
[WARNING]
Suspended Users are anyway not allowed to authenticate.
* `log.lastlogindate` - whether the system updates the `lastLoginDate` field of users upon authentication;
* `return.password.value` - whether the hashed password value and the hashed security answer (if any) value shall be 
* `connector.test.timeout` - timeout (in seconds) to check connector connection in <<Admin Console>>;
`0` to skip any check;

[NOTE]
====
This parameter is useful to avoid waiting for the default connector timeout, by setting a shorter value; 
or to completely disable connector connection testing.
====

* `resource.test.timeout` - timeout (in seconds) to check resource connection in <<Admin Console>>;
`0` to skip any check;

[NOTE]
====
This parameter is useful to avoid waiting for the default resource timeout, by setting a shorter value; 
or to completely disable resource connection testing;
====

* `default.workflow.requires.approval` - when using the default <<workflow,user workflow adapter>> (e.g. not
<<flowable-user-workflow-adapter,Flowable>>), this option controls whether an exception shall be raised when any
requested change requires admin approval.

Besides this default set, new configuration parameters can be defined to support <<customization,custom>> code.
