Define the following settings for a password policy on the Password tab.
Table 15: Policy settings
Initial password |
Initial password for newly created user accounts. The initial password is used if a password is not entered when you create a user account or if a random password is not generated. |
Password confirmation |
Reconfirm password. |
Minimum Length |
Minimum length of the password. Specify the number of characters a password must have. If the value is 0, no password is required. |
Max. length |
Maximum length of the password. Specify the number of characters a password can have. The maximum permitted value is 256. |
Max. errors |
Maximum number of errors. Set the number of invalid passwords attempts. The number of failed logins is only taken into account when logging in to One Identity Manager. If the value is 0, the number of failed logins is not taken into account.
This data is only taken into account if the One Identity Manager login was through a system user or identity based authentication module. If a user has exceeded the maximum number of failed logins, the identity or system user will not be able to log in to One Identity Manager.
You can use the Password Reset Portal to reset the passwords of identities and system users who have been locked. For more information, see the One Identity Manager Web Designer Web Portal User Guide. |
Validity period |
Maximum age of the password. Enter the length of time a password can be used before it expires. If the value is 0, then the password does not expire. |
Password history |
Enter the number of passwords to be saved. If, for example, a value of 5 is entered, the user's last five passwords are stored. If the value is 0, then no passwords are stored in the password history. |
Minimum password strength |
Specifies how secure the password must be. The higher the password strength, the more secure it is. The value 0 means that the password strength is not tested. The values 1, 2, 3 and 4 specify the required complexity of the password. The value 1 represents the lowest requirements in terms of password strength. The value 4 requires the highest level of complexity. |
Name properties denied |
Specifies whether name properties are permitted in the password. If this option is set, name properties are not permitted in passwords. The values of these columns are taken into account if the Contains name properties for password check option is set. In the Designer, adjust this option in the column definition. For more information, see the One Identity Manager Configuration Guide. |
You can implement custom scripts for testing and generating passwords if the password requirements cannot be mapped with the existing settings options. Scripts are applied in addition to the other settings.
Detailed information about this topic
You can implement a script if additional policies need to be used for checking a password that cannot be mapped with the available settings.
Syntax of check scripts
Public Sub CCC_CustomPwdValidate( policy As VI.DB.Passwords.PasswordPolicy, spwd As System.Security.SecureString)
With parameters:
policy = password policy object
spwd = password to check
TIP: To use a base object, take the Entity property of the PasswordPolicy class.
Example: Script that checks a password
A password cannot start with ? or ! . The password cannot start with three identical characters. The script checks a given password for validity.
Public Sub CCC_PwdValidate( policy As VI.DB.Passwords.PasswordPolicy, spwd As System.Security.SecureString)
Dim pwd = spwd.ToInsecureArray()
If pwd.Length>0
If pwd(0)="?" Or pwd(0)="!"
Throw New Exception(#LD("Password can't start with '?' or '!'")#)
End If
End If
If pwd.Length>2
If pwd(0) = pwd(1) AndAlso pwd(1) = pwd(2)
Throw New Exception(#LD("Invalid character sequence in password")#)
End If
End If
End Sub
To use a custom script for checking a password
-
In the Designer, create your script in the Script Library category.
-
Edit the password policy.
-
In the Manager, select the OneLogin > Basic configuration data > Password policies category.
-
In the result list, select the password policy.
-
Select the Change main data task.
-
On the Scripts tab, enter the name of the script to be used to check a password in the Check script field.
-
Save the changes.
Related topics
You can implement a generating script if additional policies need to be used for generating a random password, which cannot be mapped with the available settings.
Syntax for generating script
Public Sub CCC_PwdGenerate( policy As VI.DB.Passwords.PasswordPolicy, spwd As System.Security.SecureString)
With parameters:
policy = password policy object
spwd = generated password
TIP: To use a base object, take the Entity property of the PasswordPolicy class.
Example: Script that generates a password
In random passwords, this script replaces the invalid characters ? and ! at the beginning of a password with _.
Public Sub CCC_PwdGenerate( policy As VI.DB.Passwords.PasswordPolicy, spwd As System.Security.SecureString)
Dim pwd = spwd.ToInsecureArray()
' replace invalid characters at first position
If pwd.Length>0
If pwd(0)="?" Or pwd(0)="!"
spwd.SetAt(0, CChar("_"))
End If
End If
End Sub
To use a custom script for generating a password
-
In the Designer, create your script in the Script Library category.
-
Edit the password policy.
-
In the Manager, select the OneLogin > Basic configuration data > Password policies category.
-
In the result list, select the password policy.
-
Select the Change main data task.
-
On the Scripts tab, enter the name of the script to be used to generate a password in the Generating script field.
-
Save the changes.
Related topics