Skip to content

Password Reset#


As a privileged user, the administrator can configure the password reset feature built into the Gluu Server. This feature gives users the ability to reset their password.

Enable Password Reset#

Below are the steps to configure that feature:

  1. Provide the SMTP Server configuration
  2. Enable password reset on oxTrust adminUI
  3. Test


The following are requirements to use this feature:

  1. An active Gluu Server instance with oxTrust accessible via the web
  2. A working SMTP Server

Provide the SMTP Server Configuration#

The Gluu Server requires an SMTP server to be able to send password reset emails to the user's mailbox. A suitable UI is provided to gather the SMTP server configuation on Gluu OxTrust AdminUI.

  1. Log into the Gluu Server as a user with admin privileges

  2. Navigate to Configuration > Organization Configuration

  3. Select the SMTP Server Configuration tab here

  4. Fill the form with correct values according to your SMTP Server settings here

  5. Click the Test Configuration button to ensure the SMTP server is working: If the configuration is correct, then you will see a successful message like this: here

  6. Click the Update button to save changes

Enable Password Reset on OxTrust#

  1. Navigate to Configuration > Organization Configuration

  2. Select the System Configuration tab

  3. Enable Self-Service Password Reset enable

  4. Click the Update button to save changes


  1. Create a test user in the Gluu Server

  2. Go to the Gluu Server login page

  3. Click the Forgot your Password? link login

  4. Fill the form with the user email and click the Send Mail button form

  5. You'll get the following result: form

  6. Check the user's mailbox

Enforce Password Complexity#

If required, the userPassword attribute can be modified to implement a password policy with set requirements. \

In this example, the password requirements are:

  • It contains at least 8 characters and at most 20 characters
  • It contains at least one digit
  • It contains at least one upper case alphabet
  • It contains at least one lower case alphabet
  • It contains at least one special character which includes !@#$%&*()-+=^.
  • It doesn't contain any white space

Apply a regular expression to impose these requirements in the userPassword attribute.

The regular expression for this example is:

  • Regex Pattern: ^(?=.*[0-9])(?=.*[a-z])(?=.*[A-Z])(?=.*[!@#&()--[{}]:;',?/*~$^+=<>]).{8,20}$

This regular expression can be modified to support different strong password policies as needed.