Setup
Password Reset
Configure Password Reset Instructions
3 min
when a user resets their password, activate displays guidance explaining the password requirements that must be met before the new password will be accepted these instructions are intended to reflect the password policy configured for the organisation the current product behaviour and a recent internal ticket both indicate this area is important, especially where customers use fine grained password policies and the displayed guidance may not match the effective policy seen by the user default instruction text by default, the password reset screen shows the following guidance your password must be at least x characters long your password should not be easy to guess use characters from at least 3 of the following categories uppercase letters, for example a–z lowercase letters, for example a–z numbers, for example 0–9 symbols, for example ! @ # $ in this text, x is derived from the active directory environment how activate determines which instruction text to show activate resolves the password instruction text in the following order user rules override activate first checks for instructions defined in the user rules, using the passwordresetquestions parameter under tasks > passwords localised resource string if no user rule instructions are defined, activate then checks the passwords/instructions string in the en language resource hard coded fallback if neither of the above is available, activate falls back to the built in default instruction text this means administrators can override the text without changing code, but if no configured value exists, users will still see the default guidance where the minimum length comes from the minimum password length shown to the user is based on the password reset information read from active directory in practice, activate reads the minimum password length from the domain password settings and uses that value when building the default instruction text based on the controller behaviour you provided, this is sourced from the password reset information available for the current user context suggested note for admins if a customer reports that the password reset instructions are incorrect, first confirm whether the instruction text has been overridden in tasks > passwords a localised passwords/instructions value is present the environment uses fine grained password policies that differ from the default domain policy