Administration Guide

Password Policy

On this page

The password policy is a set of rules that a new password has to meet: a minimum length and the kinds of characters it must contain. The policy also has a scope: all users, technicians only, or Self Service Portal customers only. The policy is off until you turn it on, and when it is off no rule is applied at all.

The policy is stored in the database. You edit the same settings on the Password Policy page of the Admin Center or in the password policy settings of the Users & Security group in the Settings App.

Policy settings

Rule Values What it requires
Enforce on or off Off means no rule is applied.
Minimum length 3 to 15 The password has at least this many characters.
Upper case on or off At least one upper case letter.
Lower case on or off At least one lower case letter.
Digit on or off At least one digit.
Special character on or off At least one special character from a fixed set of 32 characters.
Scope all users, technicians only, or SSP customers only Which accounts the rules apply to.

With the scope set to technicians only, the password of an account that is not a technician account is not checked. With the scope set to SSP customers only, the password of an account that is not a customer account is not checked.

The policy checks a password only when it is set on one of the paths listed under Where the policy is enforced, not afterward. It does not check passwords that are already stored, so turning the policy on does not invalidate them.

In the Admin Center

Set the password policy

  1. Open Users & Security > Password Policy.
  2. Select Enforce Password Policy. While it is cleared, the length field, the check boxes, and the scope choice are disabled.
  3. In Minimum Password Length, enter a number from 3 to 15. A value outside that range is refused with "Value must be between 3 and 15". An empty field is refused too.
  4. Select the Must have at least one ... check boxes that you want to require: upper case letter, lower case letter, digit, special character.
  5. Under Apply these rules for, choose All users, Technicians only, or SSP Customers only.
  6. Save your changes.

When no policy has been saved yet, the page shows Enforce Password Policy cleared, a minimum length of 8, all four check boxes cleared, and All users.

In the Settings App

Password policy settings

The password policy is in the Users & Security group. It holds the same rules as the Admin Center page: enforce the policy, a minimum length from 3 to 15, the four character rules, and the scope (all users, technicians only, or SSP customers only).

The Settings App shows the Users & Security group only to a user who holds the administrative right that governs the group; see Work in the Settings App.

Where the policy is enforced

The policy is checked where a password is chosen in these places:

  • In the Admin Center, when an administrator enters a password at the Credentials step of the account-creation wizard or in the Change Password drawer.
  • In the Web App, when a technician changes their own password.
  • In the Web App, when a technician sets the password of a Self Service Portal customer account.
  • In the Settings App, in the new-account wizard and when an administrator sets or changes a password in the account editor.
  • In the Self Service Portal, when a customer registers and when a customer changes their password.

In the Admin Center

In Accounts and Roles, when an administrator types a password in the account-creation wizard or the Change Password drawer, the password is checked against the policy. The scope applies here too: when the policy is off, or the account is outside the policy's scope, any password passes.

  • Account-creation wizard. With Allow password authentication turned on at the Credentials step, Next checks the password before the wizard moves on. A password that breaks the rules opens an error dialog with OK and Help, and the wizard stays at Credentials.
  • Change Password drawer. When nothing was typed, OK closes the drawer without a change. A new password is checked the same way as in the wizard, with the same error dialog.

In both places, when the rules the password breaks are named, the message for a refused password begins "Specified password does not meet complexity requirements." and "Requirements are:", then has one line for each rule the password breaks, and ends with "Please choose another password." When no rule is named, the dialog shows the server's own message instead. The rule lines are:

  • "- Minimum Password Length: " followed by the required length and a period
  • "- Must have at least one upper case letter."
  • "- Must have at least one lower case letter."
  • "- Must have at least one digit."
  • "- Must have at least one special character" followed by the allowed characters and a period

In the Admin Center, a double quote does not count as the required special character. A password whose only special character is a double quote breaks the special-character rule, even though the message lists the double quote among the allowed characters.

In the Web App

Change your own password. A technician opens Settings from the profile menu and, in the Password panel of the Settings page, clicks Change Password. The Change Password dialog shows Login:, filled with the signed-in name and read-only, then Old Password:, New Password:, and Confirm New Password:. When the two new values differ, the answer is "The new password does not match the confirm password." Otherwise the Web App checks the old password as a full sign-in, checks the new password against the policy, and only then saves it. A refusal is shown as an alert and the dialog stays open. After a successful change the dialog closes and the Settings page shows "Password has been changed successfully."

The Password panel is not shown when the Web App is configured for Windows authentication, or when the session was signed in with Windows authentication or single sign-on.

Set a customer's password. When a technician creates or updates a Self Service Portal customer account in the Web App and supplies a password, or changes the account's password, the password is checked against the policy as a customer password. A password that breaks the rules is refused with a message that begins "Specified password does not meet complexity requirements." and "Requirements are:", then has one line for each rule the password breaks, and ends with "Please choose another password." The rule lines are:

  • "-Minimum Password Length: " followed by the required length
  • "-Must have at least one upper case letter"
  • "-Must have at least one lower case letter"
  • "-Must have at least one digit"
  • "-Must have at least one special character" followed by the allowed characters

In the Settings App

When you set or change a password in the account editor, the new password is checked against the policy for the account's type, whenever the password field was actually edited. The new-account wizard checks the password too.

On an existing account, Change Password is offered for every login that is not a Windows domain login. The new password is checked against the policy before it is saved to the account.

In the Self Service Portal

The policy is checked when a customer registers on the portal and when a customer changes their password on the portal. How customers sign in to the portal is described in Sign In to the Portal.