Documentation

Introduction

Use this guide to enable end-user password reset and / or account unlock via the SecureAuth IdP Identity Management (IdM) Tool.

SecureAuth IdP provides configuration flexibility to allow users to reset known passwords, update forgotten passwords, unlock their own accounts, and / or unlock other users' accounts (help desk) via two methods: Enforce and Administrative.

Enforce Mode is appropriate for most Active Directory and other LDAP use cases and enforces password history requirements (i.e. does not allow passwords to be updated too frequently or to be the same as previous passwords), while Administrative Mode is more suited for SQL-type data stores that do not support / require password history checks and / or are targeted more for help desk utilization.

This guide provides configuration steps for both Enforce and Administrative modes, and for Reset Password Only and Reset Password + Account Unlock.

Prerequisites

1. Create a New Realm(s) for the Password Reset Page / Password Reset + Account Unlock Page

2. The SecureAuth IdP directory Service Account must have the write privileges to modify in order to change user passwords

3. If using Active Directory, then the following Outbound Ports must be open for password reset:

  • 139 – DFSN, NetBIOS Session Service, NetLogon
  • 445 – SMB / CIFS, DFSN, LSARPC, NbtSS, NetLogonR, SamR, SrvSvc
  • 464 – Kerberos Change / Set Password

4. Configure the following tabs in the Web Admin before configuring the Post Authentication tab:

  • Overview – the description of the realm and SMTP connections must be defined
  • Data – an enterprise directory must be integrated with SecureAuth IdP
  • Workflow – the way in which users will access this application must be defined
  • Registration Methods / Multi-Factor Methods – the Multi-Factor Authentication methods that will be used to access this page (if any) must be defined

5. (Optional) If using the Administrative Reset with History Check Password Reset Mode, then the 636 - SSL Outbound Port must be open for password reset

6. (Optional) Configure Google Apps to enable the Google Apps Functions, including directory password synchronization

SecureAuth IdP Configuration Steps

Follow the configuration steps to enable Password Reset Only

Post Authentication


1. In the Post Authentication section, select Password Reset from the Authenticated User Redirect dropdown

Click Save once the configurations have been completed and before leaving the Post Authentication page

Password Reset


2. Click Configure password reset page

Password Reset Functions

Use Enforce Mode for Active Directory / LDAP directory types and if password history check is required

3. Select Enforce Password Change Requirements from the Password Reset Mode dropdown

4. Select Disabled - change own password from the Username Textbox dropdown

5. Select True from the Require Current Password dropdown

6. Select True from the Must Change Password at Next Logon dropdown

7. Select Do not unlock from the Unlock User Account dropdown

8. Select True from the Allow Password Change dropdown

9. Select True from the Validate Password Complexity dropdown to enforce password complexity requirements via SecureAuth IdP; or select False to not enforce additional password complexity requirements

NOTE: These requirements are in addition to the requirements configured in the directory

If the requirements set in SecureAuth IdP are more strict than the rules in the directory, then the IdP rules must be followed to successfully change a password; but if the requirements set in SecureAuth IdP are less strict than the rules in the directory, then the directory rules must be followed to successfully change a password

If the directory rules are not met, then the realm will error out and the password change will not be accepted

10. Select True from the Show Password Complexity Rules dropdown to display the configured password requirements (see the Password Complexity section below) on the Password Reset page

This setting applies only if True is selected in step 9

11. Select the SecureAuth IdP Email Profile Property that is mapped to the directory field containing the user's email address to which notifications of changed passwords are sent from the Send Email dropdown; or select Do not send to disable the email notification feature

12. Select True from the Show Exception on Page dropdown to display the reason(s) why a password change is not accepted

The error displayed is from the directory and based on the directory's password complexity requirements

Use Administrative Mode for SQL directory types and if password history check is not required / supported

3. Select Administrative Password Reset from the Password Reset Mode dropdown

4. Select Disabled - change own password from the Username Textbox dropdown

5. Select False from the Must Change Password at Next Logon dropdown

6. Select Do not unlock from the Unlock User Account dropdown

7. Select True from the Allow Password Change dropdown

8. Select True from the Validate Password Complexity dropdown to enforce password complexity requirements via SecureAuth IdP; or select False to not enforce additional password complexity requirements

NOTE: These requirements are in addition to the requirements configured in the directory

If the requirements set in SecureAuth IdP are more strict than the rules in the directory, then the IdP rules must be followed to successfully change a password; but if the requirements set in SecureAuth IdP are less strict than the rules in the directory, then the directory rules must be followed to successfully change a password

If the directory rules are not met, then the realm will error out and the password change will not be accepted

9. Select True from the Show Password Complexity Rules dropdown to display the configured password requirements (see the Password Complexity section below) on the Password Reset page

This setting applies only if True is selected in step 8

10. Select the SecureAuth IdP Email Profile Property that is mapped to the directory field containing the user's email address to which notifications of changed passwords are sent from the Send Email dropdown; or select Do not send to disable the email notification feature

11. Select True from the Show Exception on Page dropdown to display the reason(s) why a password change is not accepted

The error displayed is from the directory and based on the directory's password complexity requirements

Password Complexity


(OPTIONAL) 12-13. Configure the password complexity requirements that are enforced by SecureAuth IdP in addition to the directory's complexity requirements

These complexity requirements are enforced only if True is selected from the Validate Password Complexity dropdown

If no requirements are configured in SecureAuth IdP, then only the directory's password complexity requirements are enforced

Google Apps / iOS Provisioning

(OPTIONAL) 14. Select True from the Using iOS Provisioning with Google Apps dropdown if directory / Google Apps password synchronization is enabled and to allow password changes to be synchronized

Refer to iOS G Suite Provision Configuration Guide for more information

Click Save once the configurations have been completed and before leaving the Password Reset page to avoid losing changes

Google Apps Functions


(OPTIONAL) 15. Configure the realm for Google Apps provisioning, including password synchronization

Refer to G Suite Provisioning Configuration Guide for more information

Click Save once the configurations have been completed and before leaving the Post Authentication page to avoid losing changes

Forms Auth / SSO Token

16. Click View and Configure Forms Auth Keys / SSO Token to configure the token / cookie settings and to configure this realm for SSO

These are optional configurations

 To configure this realm's token/cookie settings, follow these steps:
Forms Authentication

 

1. If SSL is required to view the token, select True from the Require SSL dropdown

2. Choose whether SecureAuth IdP will deliver the token in a cookie to the user's browser or device:

  • UseCookies enables SecureAuth IdP to always deliver a cookie
  • UseUri disables SecureAuth IdP to deliver a cookie, and instead deliver the token in a query string
  • AutoDetect enables SecureAuth IdP to deliver a cookie if the user's settings allow it
  • UseDeviceProfile enables SecureAuth IdP to deliver a cookie if the browser's settings allow it, no matter the user's settings

3. Set the Sliding Expiration to True if the cookie remains valid as long as the user is interacting with the page

4. Set the Timeout length to determine for how many minutes a cookie is valid

No configuration is required for the Name, Login URL, or Domain fields

Machine Key

 

5. No changes are required in the Validation field, unless the default value does not match the company's requirement

If a different value is required, select it from the dropdown

6. No changes are required in the Decryption field, unless the default value does not match the company's requirement

If a different value is required, select it from the dropdown

No configuration is required for the Validation Key or Decryption Key fields

Authentication Cookies

 

7. Enable the cookie to be Persistent by selecting True - Expires after Timeout from the dropdown

Selecting False - Session Cookie enables the cookie to be valid as long as the session is open, and will expire once the browser is closed or the session expires

No configuration is required for the Pre-Auth Cookie, Post-Auth Cookie, or the Clean Up Pre-Auth Cookie fields

Click Save once the configurations have been completed and before leaving the Forms Auth / SSO Token page to avoid losing changes

To configure this realm for SSO, refer to SecureAuth IdP Single Sign-on Configuration

To configure this realm for Windows Desktop SSO, refer to Windows desktop SSO configuration

Follow the configuration steps to enable Password Reset and Account Unlock

Refer to Unlock Account Configuration Guide for various account unlock configuration options; or Unlock Account (Show Status) Configuration Guide for various account unlock configuration options and for a post-authentication page that displays the account's current status

Data


1. In the Membership Connection Settings section, select False from the Advanced AD User Check dropdown

Click Save once the configurations have been completed and before leaving the Data page to avoid losing changes

Post Authentication


2. In the Post Authentication section, select Password Reset from the Authenticated User Redirect dropdown

Click Save once the configurations have been completed and before leaving the Post Authentication page

Password Reset


3. Click Configure password reset page

Password Reset Functions

Use Enforce Mode for Active Directory / LDAP directory types and if password history check is required

4. Select Enforce Password Change Requirements from the Password Reset Mode dropdown

5. Select Disabled - change own password from the Username Textbox dropdown

6. Select False from the Require Current Password dropdown

7. Select True from the Must Change Password at Next Logon dropdown

8. Select Automatically from the Unlock User Account dropdown to unlock the user's account with the password change; or select Show unlock button to provide the option to unlock the account

9. Select True from the Allow Password Change dropdown

10. Select True from the Validate Password Complexity dropdown to enforce password complexity requirements via SecureAuth IdP; or select False to not enforce additional password complexity requirements

NOTE: These requirements are in addition to the requirements configured in the directory

If the requirements set in SecureAuth IdP are more strict than the rules in the directory, then the IdP rules must be followed to successfully change a password; but if the requirements set in SecureAuth IdP are less strict than the rules in the directory, then the directory rules must be followed to successfully change a password

If the directory rules are not met, then the realm will error out and the password change will not be accepted

11. Select True from the Show Password Complexity Rules dropdown to display the configured password requirements (see the Password Complexity section below) on the Password Reset page

This setting applies only if True is selected in step 10

12. Select the SecureAuth IdP Email Profile Property that is mapped to the directory field containing the user's email address to which notifications of changed passwords are sent from the Send Email dropdown; or select Do not send to disable the email notification feature

13. Select True from the Show Exception on Page dropdown to display the reason(s) why a password change is not accepted

The error displayed is from the directory and based on the directory's password complexity requirements

Use Administrative Mode for SQL directory types and if password history check is not required / supported

4. Select Administrative Password Reset from the Password Reset Mode dropdown

5. Select Disabled - change own password from the Username Textbox dropdown

6. Select False from the Must Change Password at Next Logon dropdown

7. Select Automatically from the Unlock User Account dropdown to unlock the user's account with the password change; or select Show unlock button to provide the option to unlock the account

8. Select True from the Allow Password Change dropdown

9. Select True from the Validate Password Complexity dropdown to enforce password complexity requirements via SecureAuth IdP; or select False to not enforce additional password complexity requirements

NOTE: These requirements are in addition to the requirements configured in the directory

If the requirements set in SecureAuth IdP are more strict than the rules in the directory, then the IdP rules must be followed to successfully change a password; but if the requirements set in SecureAuth IdP are less strict than the rules in the directory, then the directory rules must be followed to successfully change a password

If the directory rules are not met, then the realm will error out and the password change will not be accepted

10. Select True from the Show Password Complexity Rules dropdown to display the configured password requirements (see the Password Complexity section below) on the Password Reset page

This setting applies only if True is selected in step 9

11. Select the SecureAuth IdP Email Profile Property that is mapped to the directory field containing the user's email address to which notifications of changed passwords are sent from the Send Email dropdown; or select Do not send to disable the email notification feature

12. Select True from the Show Exception on Page dropdown to display the reason(s) why a password change is not accepted

The error displayed is from the directory and based on the directory's password complexity requirements

Password Complexity


(OPTIONAL) 13-14. Configure the password complexity requirements that are enforced by SecureAuth IdP in addition to the directory's complexity requirements

These complexity requirements are enforced only if True is selected from the Validate Password Complexity dropdown

If no requirements are configured in SecureAuth IdP, then only the directory's password complexity requirements are enforced

Google Apps / iOS Provisioning

(OPTIONAL) 15. Select True from the Using iOS Provisioning with Google Apps dropdown if directory / Google Apps password synchronization is enabled and to allow password changes to be synchronized

Refer to iOS G Suite Provision Configuration Guide for more information

Click Save once the configurations have been completed and before leaving the Password Reset page to avoid losing changes

Google Apps Functions


(OPTIONAL) 16. Configure the realm for Google Apps provisioning, including password synchronization

Refer to Google Apps Provisioning for more information

Click Save once the configurations have been completed and before leaving the Post Authentication page to avoid losing changes

Forms Auth / SSO Token

17. Click View and Configure Forms Auth Keys / SSO Token to configure the token / cookie settings and to configure this realm for SSO

These are optional configurations

 To configure this realm's token/cookie settings, follow these steps:
Forms Authentication

 

1. If SSL is required to view the token, select True from the Require SSL dropdown

2. Choose whether SecureAuth IdP will deliver the token in a cookie to the user's browser or device:

  • UseCookies enables SecureAuth IdP to always deliver a cookie
  • UseUri disables SecureAuth IdP to deliver a cookie, and instead deliver the token in a query string
  • AutoDetect enables SecureAuth IdP to deliver a cookie if the user's settings allow it
  • UseDeviceProfile enables SecureAuth IdP to deliver a cookie if the browser's settings allow it, no matter the user's settings

3. Set the Sliding Expiration to True if the cookie remains valid as long as the user is interacting with the page

4. Set the Timeout length to determine for how many minutes a cookie is valid

No configuration is required for the Name, Login URL, or Domain fields

Machine Key

 

5. No changes are required in the Validation field, unless the default value does not match the company's requirement

If a different value is required, select it from the dropdown

6. No changes are required in the Decryption field, unless the default value does not match the company's requirement

If a different value is required, select it from the dropdown

No configuration is required for the Validation Key or Decryption Key fields

Authentication Cookies

 

7. Enable the cookie to be Persistent by selecting True - Expires after Timeout from the dropdown

Selecting False - Session Cookie enables the cookie to be valid as long as the session is open, and will expire once the browser is closed or the session expires

No configuration is required for the Pre-Auth Cookie, Post-Auth Cookie, or the Clean Up Pre-Auth Cookie fields

Click Save once the configurations have been completed and before leaving the Forms Auth / SSO Token page to avoid losing changes

To configure this realm for SSO, refer to SecureAuth IdP Single Sign-on Configuration

To configure this realm for Windows Desktop SSO, refer to Windows desktop SSO configuration