Password policy

Size

Set minimal and maximal length in $pwd_min_length and $pwd_max_length:

$pwd_min_length = 4;
$pwd_max_length = 8;

Tip

Set 0 in $pwd_max_length to disable maximal length checking.

You can set the minimal number of lower, upper, digit and special characters:

$pwd_min_lower = 3;
$pwd_min_upper = 1;
$pwd_min_digit = 1;
$pwd_min_special = 1;

Special characters are defined with a regular expression, by default:

$pwd_special_chars = "^a-zA-Z0-9";

This means special characters are all characters except alphabetical letters and digits.

You can check that these special characters are not at beginning or end of the password:

$pwd_no_special_at_ends = true;

You can also disallow characters from being in password, with $pwd_forbidden_chars:

$pwd_forbidden_chars = "@%";

This means that @ and % could not be present in a password.

You can define how many different class of characters (lower, upper, digit, special) are needed in the password:

$pwd_complexity = 2;

Allows to check if the password was already compromised, using https://haveibeenpwned.com/ database:

$use_pwnedpasswords = true;

Give a list of forbidden words that the password should not contain:

$pwd_forbidden_words = array("azerty", "qwerty", "password");

Give a list of LDAP fields which values should not be present in the password:

$pwd_forbidden_ldap_fields = array('cn', 'givenName', 'sn', 'mail');

Password policy can be displayed to user by configuring $pwd_show_policy. Three values are accepted:

always: policy is always displayed
never: policy is never displayed
onerror: policy is only displayed if password is rejected because of it, and the user provided his old password correctly.

$pwd_show_policy = "never";

You can also configure if the policy will be displayed above or below the form:

$pwd_show_policy_pos = "above";

When the user is typing his new password, you can enable an entropy bar, showing the strength of the password.

$pwd_display_entropy = true;

You can also require the entropy bar to hit a minimum level for the password to be accepted:

# enforce password entropy check
$pwd_check_entropy = true;

# minimum entropy level required (when $pwd_check_entropy enabled)
$pwd_min_entropy = 3;

$pwd_min_entropy must be an integer between 0 (very risky) and 4 (very strong).

Tip

The entropy check is computed by the zxcvbn library