Password Reset
#Overview
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:
- Provide the SMTP Server configuration
- Enable password reset on oxTrust adminUI
- Test
#Prerequisites
The following are requirements to use this feature:
- An active Gluu Server instance with oxTrust accessible via the web
- 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.
Log into the Gluu Server as a user with admin privileges
Navigate to
Configuration>Organization ConfigurationSelect the
SMTP Server Configurationtab
Fill the form with correct values according to your SMTP Server settings

Click the
Test Configurationbutton to ensure the SMTP server is working: If the configuration is correct, then you will see a successful message like this:
Click the
Updatebutton to save changes
#Enable Password Reset on OxTrust
Navigate to
Configuration>Organization ConfigurationSelect the
System ConfigurationtabEnable
Self-Service Password Reset
Click the
Updatebutton to save changes
#Test
Create a test user in the Gluu Server
Go to the Gluu Server login page
Click the
Forgot your Password?link
Fill the form with the user email and click the
Send Mailbutton
You'll get the following result:

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.
