Enforce Password Policy

A Password Policy defines a set of rules to determine whether a new password is valid or not.

For Subscription editions only.


By default, no password policy is set for users of Bonita. It is therefore highly recommended to set a policy to protect your data.

There are three options:

  • Leave the default setting as is: "non-protected".

  • Apply our ready-to-use policy to a tenant. This requires a password to contain the following:

    • at least 10 characters long

    • at least 2 special characters

    • at least 2 upper case characters

    • at least 2 lower case characters

    • at least 3 digits

To apply this policy edit initial configuration in <TOMCAT_HOME>/setup/platform_conf/initial/tenant_template_portal/security-config.properties if you have never started the platform yet, and current configuration in <TOMCAT_HOME>/setup/platform_conf/current/tenants/1/tenant_portal/security-config.properties if the platform has been already started using the platform setup tool and change DefaultPasswordValidator to RobustnessPasswordValidator.

  • Create a custom password policy by following the tutorial below.

How to create a custom password policy

This will enable the System administrator to create a custom class and define the characteristics for a particular password policy. It will be applied to all users.


You should have Maven installed and setup to access the Bonita Artifact Repository.

How to create a Java class containing your own password validation characteristics

Here are the steps to create and add a custom password validator:

  1. Create a new Maven Project in your favorite IDE.

  2. Add a new dependency in the pom.xml to bonita-web-server artifact.

              <!-- Version can be omitted when bonita-runtime-bom is imported -->
    <!-- Add required additional repositories -->
  3. Create your class, eg. PasswordLengthValidator with a name for the package, eg. org.bonitasoft.ext.password.validator.

    package org.bonitasoft.ext.password.validator;
    import static org.bonitasoft.web.toolkit.client.common.i18n.AbstractI18n.t_;
    import org.bonitasoft.web.toolkit.client.common.i18n.AbstractI18n;
    import org.bonitasoft.web.toolkit.client.common.i18n.AbstractI18n.LOCALE;
    import org.bonitasoft.web.toolkit.client.data.item.attribute.validator.AbstractStringValidator;
    public class PasswordLengthValidator extends AbstractStringValidator {
        protected void _check(String password) {
            LOCALE Locale = AbstractI18n.stringToLocale(locale);
            // Check number of length
            int minimalLength = 10;
            if (password.length() < minimalLength) {
                    addError(t_("Password is not long enough", Locale));
  4. Then, build and install the project. Using a terminal, type mvn install at the root of the project.

  5. The built artifact can now be added in a Bonita project extension.[1]

  6. Build the Bonita project as a bundle or a docker image using Maven.

  7. Using the setup tool modify the security-config.properties file to add your new password validator:

    # content of the file
    security.password.validator org.bonitasoft.ext.password.validator.PasswordLengthValidator
  8. Start the application

  9. Create a new user and check that your password policy has been set. To check that the validation is correct, you can type a password to force an error. An exception will be displayed listing all the non-filled criteria.

If the password complies with the criteria in the new password policy, no exception error message will be displayed.

The default error message shown on the default admin user list page is Password must be at least 10 characters long containing at least 3 digits, 2 upper case characters, and 2 special characters.. If you configured a custom password policy, you might need to create a custom page to change the error message.

1. When using the deprecated platform mode, consult 2023.1 documentation version.