This site contains the documentation that is relevant to older WSO2 product versions and offerings.
For the latest WSO2 documentation, visit https://wso2.com/documentation/.

One Time Passwords

The one time password feature is used to facilitate the users who wish to have a new password each time they login. This increases the security to prevent password theft, since at each login, the user gets a new password. Also this helps users who do not like to remember passwords all the time.

In WSO2 Identity Server when users enable OTP using their profile configuration, each time when the user logs in, a new password is sent to the user’s email. This password can be used next time when the user needs to login.

Configuration

You need to create the following claim and map it with a valid attribute with the underlying datastore. This is used to store the otp feature status for the user. 

  • http://wso2.org/claims/identity/otp

In order to display this in the user profile you need to select the Supported by Default attribute found when creating the claim.

Set the following configuration in the {carbon_home}/repository/conf/security/identity-­mgt.properties file.

Identity.Listener.Enable=true
Notification.Sending.Enable=true
Notification.Expire.Time=7200
Notification.Sending.Internally.Managed=true
Authentication.Policy.Enable=true
Authentication.Policy.Check.OneTime.Password=true

Enabling OTP

Once the configuration is done, restart the server for your changes to take effect. Then login as a user to check the one time password feature. Also ensure that you have filled the necessary profile details including email.

Now when the user logs out and logs in again, a new password is generated and emailed to the user’s email.

Â