Configure password complexity rules

Enable password complexity rules and configure minimum password length.

Redis Enterprise Software provides optional password complexity rules that meet common requirements. When enabled, these rules require the password to have:

  • At least 8 characters
  • At least one uppercase character
  • At least one lowercase character
  • At least one number
  • At least one special character

These requirements reflect v6.2.12 and later. Earlier versions did not support numbers or special characters as the first or the last character of a password. This restriction was removed in v6.2.12.

In addition, the password:

  • Cannot contain the user's email address or the reverse of the email address.
  • Cannot have more than three repeating characters.

Password complexity rules apply when a new user account is created and when the password is changed. Password complexity rules are not applied to accounts authenticated by an external identity provider.

Enable password complexity rules

To enable password complexity rules, use one of the following methods:

  • Cluster Manager UI:

    1. Go to Cluster > Security > Preferences, then select Edit.

    2. In the Password section, enable Complexity rules.

    3. Select Save.

  • Update cluster REST API request:

    PUT https://[host][:port]/v1/cluster
    { "password_complexity": true }
    

Change minimum password length

When password complexity rules are enabled, passwords must have at least 8 characters by default.

If you change the minimum password length, the new minimum is enforced for new users and when existing users change their passwords.

To change the minimum password length, use one of the following methods:

  • Cluster Manager UI:

    1. Go to Cluster > Security > Preferences.

    2. Click Edit.

    3. In the Password section, enable Complexity rules.

    4. Set the number of characters for Minimum password length.

      The minimum password length setting appears in the password section of the cluster security preferences screen when complexity rules are enabled.
    5. Click Save.

  • Update cluster REST API request:

    PUT https://[host][:port]/v1/cluster
    { "password_min_length": <integer between 8-256> }
    

Deactivate password complexity rules

To deactivate password complexity rules, use one of the following methods:

  • Cluster Manager UI:

    1. Go to Cluster > Security > Preferences, then select Edit.

    2. In the Password section, turn off Complexity rules.

    3. Select Save.

  • Update cluster REST API request:

    PUT https://[host][:port]/v1/cluster
    { "password_complexity": false }
    
RATE THIS PAGE
Back to top ↑