Documentation

Introduction

Use this guide to enable end-user or administrative (help desk) account unlock via the SecureAuth IdP Identity Management (IdM) Password Reset Tool.

This configuration option effectively unlocks a user's account, but does not display the account's current status on the Account Unlock page. Instead, it always shows that the user's account is "normal".

In the other configuration option, administrators or end-users can view the account's current status (locked, normal, etc.) before and after clicking unlock.

Both configuration options effectively unlock user accounts, but only the Show Status setup displays the account's current status on the page.

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, while Administrative Mode is more suited for SQL-type data stores that are targeted more for help desk utilization.

This guide provides configuration steps for both Enforce and Administrative modes, and for Help Desk Account Unlock and End-user Account Unlock. Help Desk Account Unlock allows administrators to unlock any user's account, and End-user Account Unlock allows users to unlock only their own accounts.

SecureAuth IdP also enables Reset Password + Account Unlock options. Refer to Reset Password Configuration Guide for the combined configuration.

Prerequisites

1. Create a New Realm(s) for the Account Unlock Page

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

3. 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
  • Multi-Factor Methods – the Multi-Factor Authentication methods that will be used to access this page (if any) must be defined
SecureAuth IdP Configuration Steps
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

Follow the configuration steps to enable Help Desk Account Unlock

Use Enforce Mode for Active Directory / LDAP directory types

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

5. Select Enabled - change other user passwords from the Username Textbox dropdown

6. Select False from the Require Current Password dropdown

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

8. Select Show unlock button from the Unlock User Account dropdown

9. Select False from the Allow Password Change dropdown

This option disables Password Reset in the Account Unlock process

Refer to Reset Password Configuration Guide for the various password reset configuration options, including Password Reset + Account Unlock

10. Select False from the Validate Password Complexity dropdown

11. Select False from the Show Password Complexity Rules dropdown

12. Select Do not send from the Send Email dropdown

13. Select False from the Show Exception on Page dropdown

Use Administrative Mode for SQL directory types and for more help desk type configurations

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

5. Select Enabled - change other user passwords from the Username Textbox dropdown

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

7. Select Show unlock button from the Unlock User Account dropdown

8. Select False from the Allow Password Change dropdown

This option disables Password Reset in the Account Unlock process

Refer to Reset Password Configuration Guide for the various password reset configuration options, including Password Reset + Account Unlock

9. Select False from the Validate Password Complexity dropdown

10. Select False from the Show Password Complexity Rules dropdown

11. Select Do not send from the Send Email dropdown

12. Select False from the Show Exception on Page dropdown

(no step 13 – skip to step 14)

The Admin Mode with History Check is not supported for eDirectory.

4. Select Administrative Reset with History Check from the Password Reset Mode dropdown

5. Select Enabled - change other user passwords from the Username Textbox dropdown

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

7. Select Show unlock button from the Unlock User Account dropdown

8. Select False from the Allow Password Change dropdown

This option disables Password Reset in the Account Unlock process

Refer to Reset Password Configuration Guide for the various password reset configuration options, including Password Reset + Account Unlock

9. Select False from the Validate Password Complexity dropdown

10. Select False from the Show Password Complexity Rules

11. Select Do not send from the Send Email dropdown

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

(no step 13 – skip to step 14)

Follow the configuration steps to enable End-user Account Unlock

Use Enforce Mode for Active Directory / LDAP directory types

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 upon successful authentication; or select Show unlock button to provide the option to unlock the account

9. Select False from the Allow Password Change dropdown

This option disables Password Reset in the Account Unlock process

Refer to Reset Password Configuration Guide for the various password reset configuration options, including Password Reset + Account Unlock

10. Select False from the Validate Password Complexity dropdown

11. Select False from the Show Password Complexity Rules dropdown

12. Select Do not send from the Send Email dropdown

13. Select False from the Show Exception on Page dropdown

Use Administrative Mode for SQL directory types and for more help desk type configurations

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 False from the Allow Password Change dropdown

This option disables Password Reset in the Account Unlock process

Refer to Reset Password Configuration Guide for the various password reset configuration options, including Password Reset + Account Unlock

9. Select False from the Validate Password Complexity dropdown

10. Select False from the Show Password Complexity Rules dropdown

11. Select Do not send from the Send Email dropdown

12. Select False from the Show Exception on Page dropdown

(no step 13 – skip to step 14)

The Admin Mode with History Check is not supported for eDirectory.

4. Select Administrative Reset with History Check 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 False from the Allow Password Change dropdown

This option disables Password Reset in the Account Unlock process

Refer to Reset Password Configuration Guide for the various password reset configuration options, including Password Reset + Account Unlock

9. Select False from the Validate Password Complexity dropdown

10. Select False from the Show Password Complexity Rules dropdown

11. Select Do not send from the Send Email dropdown

12. Select False from the Show Exception on Page dropdown

(no step 13 – skip to step 14)

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

Forms Auth / SSO Token

14. 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