Use the Character classes tab to specify which characters are permitted for a password.
Table 34: Character classes for passwords
Required number of character classes |
Number of rules for character classes that must be fulfilled so that a password adheres to the password policy. The following rules are taken into account for Min. number letters, Min. number lowercase, Min. number uppercase, Min. number digits, and Min. number special characters.
That means:
-
Value 0: All character class rules must be fulfilled.
-
Value >0: Minimum number of character class rules that must be fulfilled. At most, the value can be the number of rules with a value >0.
NOTE: Generated passwords are not tested for this. |
Min. number letters |
Specifies the minimum number of alphabetical characters the password must contain. |
Min. number lowercase |
Specifies the minimum number of lowercase letters the password must contain. |
Min. number uppercase |
Specifies the minimum number of uppercase letters the password must contain. |
Min. number digits |
Specifies the minimum number of digits the password must contain. |
Min. number special characters |
Specifies the minimum number of special characters the password must contain. |
Permitted special characters |
List of permitted special characters. |
Max. identical characters in total |
Specifies the maximum number of identical characters that can be present in the password in total. |
Max. identical characters in succession |
Specifies the maximum number of identical character that can be repeated after each other. |
Denied special characters |
List of special characters that are not permitted. |
Do not generate lowercase letters |
Specifies whether a generated password can contain lowercase letters. This setting only applies when passwords are generated. |
Do not generate uppercase letters |
Specifies whether a generated password can contain uppercase letters. This setting only applies when passwords are generated. |
Do not generate digits |
Specifies whether a generated password can contain digits. This setting only applies when passwords are generated. |
Do not generate special characters |
Specifies whether a generated password can contain special characters. If this option is set, only letters, numbers, and spaces are allowed in passwords. This setting only applies when passwords are generated. |
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 Employees > 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 Employees > 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