Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Account locking is a security feature in Identity Server that prevents users from logging in to their account and from authenticating themselves using their IS account. A user account can be locked in one of the following ways:

...

Configuration

Description

Notification.Sending.Enable=true

This property enables the email sending function when the password account is unlocked.

Notification.Expire.Time=7200

The time specified here is in minutes. In this case, the notification expires after 7200 minutes.

Notification.Sending.Internally.Managed=true

This enables the internal email sending module. If this property is set to false, the email sending data is available to the application via a Web service. Thus the application can send the email using its own email sender.

Authentication.Policy.Enable=true

This enables the authentication flow level which checks for the account lock and one time password features. This property must be enabled for the account lock feature to work.

Authentication.Policy.Account.Lock.On.Failure=true

This enables locking the account when authentication fails.

Authentication.Policy.Account.Lock.On.Failure.Max.Attempts=2

This indicates the number of consecutive attempts that a user can try to log in without the account getting locked. In this case, if the login fails twice, the account is locked.

Authentication.Policy.Account.Lock.Time=5

The time specified here is in minutes. In this case, the account is locked for five minutes and authentication can be attempted once this time has passed.

...

  1. Start the IS server if you haven't already and log in to the management console using admin credentials.
  2. Navigate to Claims>List on the Configure menu and select the http://wso2.org/claims claim dialect. For more information about claims, see Claim Management
  3. Select the Account Locked claim and click Edit.

  4. Select the "Supported by Default" checkbox and click Update. This is done to make the "Account Locked" status appear in the user's profile. 
  5. Navigate to Users and Roles>List>Users on the Main menu and click on User Profile of the user you want to lock. 
  6. If it is the first time this particular account is being locked, a textbox will appear in front of the Account Locked field as seen below. To lock the account, type true in the textbox and click Update.

...

The Identity Server can be configured to send an email notification to the user when a user account is unlocked by an admin user. Follow the steps below to configure this. 
 

1. Configure the following parameters in the <IS_HOME>/repository/conf/identity/identity-mgt.properties file.

ConfigurationDescription

Notification.Expire.Time=7200

The time specified here is in minutes. In this case, the notification expires after 7200 minutes.

Notification.Sending.Internally.Managed=true

This enables the internal email sending module. If this property is set to false, the email sending data is available to the application via a Web service. Thus the application can send the email using its own email sender.

Authentication.Policy.Enable=true

This enables the authentication flow level which checks for the account lock and one time password features. This property must be enabled for the account lock feature to work.

Code Block
languagebash
Notification.Sending.Enable=true
Notification.Expire.Time=7200
Notification.Sending.Internally.Managed=true

...

 

 

2. Navigate to the <IS_HOME>/repository/conf/axis2/axis2.xml file and uncomment the following property. Change the parameter values according to your email (see the second code block below for an example of this).  

...