Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02

com.bea.security.providers.authentication.passwordvalidator
Interface SystemPasswordValidatorMBean

All Superinterfaces:
PasswordValidatorMBean, ProviderMBean

public interface SystemPasswordValidatorMBean
extends ProviderMBean, PasswordValidatorMBean

This MBean represents configuration information for the System Password Validator provider.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime.


Method Summary
 String getDescription()
          A short description of the System Password Validator provider.
 int getMaxConsecutiveCharacters()
          Specifies the maximum instances that a specific character may appear consecutively in the password.
 int getMaxInstancesOfAnyCharacter()
          Specifies the maximum instances that any one character may appear in the password.
 int getMaxPasswordLength()
          Specifies the maximum number of characters that the password may contain.
 int getMinAlphabeticCharacters()
          Specifies the minimum number of alphabetic characters that a password must contain.
 int getMinLowercaseCharacters()
          Specifies the minimum number of lowercase characters that a password must contain.
 int getMinNonAlphanumericCharacters()
          Specifies the minimum number of non-alphanumeric characters (also known as special characters, such as %, *, #, or }) that a password must contain.
 int getMinNumericCharacters()
          Specifies the minimum number of numeric characters that a password must contain.
 int getMinNumericOrSpecialCharacters()
          Specifies the minimum number of numeric or special characters (such as %, *, #, or }) that a password must contain.
 int getMinPasswordLength()
          Specifies the minimum number of characters that the password must contain.
 int getMinUppercaseCharacters()
          Specifies the minimum number of uppercase characters that a password must contain.
 String getName()
          The name of this configuration.
 String getProviderClassName()
          The Java class used to load the System Password Validator provider.
 boolean getRejectEqualOrContainReverseUsername()
          Specifies whether the password may contain, or be set to, the reverse of the username.
 boolean getRejectEqualOrContainUsername()
          Specifies whether the password may contain, or be set to, the username.
 String getVersion()
          The version number of the System Password Validator provider.
 void setMaxConsecutiveCharacters(int newValue)
          Specifies the maximum instances that a specific character may appear consecutively in the password.
 void setMaxInstancesOfAnyCharacter(int newValue)
          Specifies the maximum instances that any one character may appear in the password.
 void setMaxPasswordLength(int newValue)
          Specifies the maximum number of characters that the password may contain.
 void setMinAlphabeticCharacters(int newValue)
          Specifies the minimum number of alphabetic characters that a password must contain.
 void setMinLowercaseCharacters(int newValue)
          Specifies the minimum number of lowercase characters that a password must contain.
 void setMinNonAlphanumericCharacters(int newValue)
          Specifies the minimum number of non-alphanumeric characters (also known as special characters, such as %, *, #, or }) that a password must contain.
 void setMinNumericCharacters(int newValue)
          Specifies the minimum number of numeric characters that a password must contain.
 void setMinNumericOrSpecialCharacters(int newValue)
          Specifies the minimum number of numeric or special characters (such as %, *, #, or }) that a password must contain.
 void setMinPasswordLength(int newValue)
          Specifies the minimum number of characters that the password must contain.
 void setMinUppercaseCharacters(int newValue)
          Specifies the minimum number of uppercase characters that a password must contain.
 void setRejectEqualOrContainReverseUsername(boolean newValue)
          Specifies whether the password may contain, or be set to, the reverse of the username.
 void setRejectEqualOrContainUsername(boolean newValue)
          Specifies whether the password may contain, or be set to, the username.
 
Methods inherited from interface weblogic.management.security.ProviderMBean
getRealm
 
Methods inherited from interface weblogic.management.security.ProviderMBean
getRealm
 

Method Detail

getProviderClassName

String getProviderClassName()

The Java class used to load the System Password Validator provider.

Default Value:
"com.bea.security.providers.authentication.passwordvalidator.SystemPasswordValidatorProviderImpl"

getDescription

String getDescription()

A short description of the System Password Validator provider.

Specified by:
getDescription in interface ProviderMBean
Default Value:
"Password composition checks"

getVersion

String getVersion()

The version number of the System Password Validator provider.

Specified by:
getVersion in interface ProviderMBean
Default Value:
"1.0"

getRejectEqualOrContainUsername

boolean getRejectEqualOrContainUsername()

Specifies whether the password may contain, or be set to, the username. The system evaluation of this password rule is case insensitive. If this rule is set to true, the password must not contain, or be set to, the username.

To secure your system, set this value to true.

Changes take effect after you redeploy the module or restart the server.
Default Value:
false

setRejectEqualOrContainUsername

void setRejectEqualOrContainUsername(boolean newValue)
                                     throws InvalidAttributeValueException

Specifies whether the password may contain, or be set to, the username. The system evaluation of this password rule is case insensitive. If this rule is set to true, the password must not contain, or be set to, the username.

To secure your system, set this value to true.

Parameters:
newValue - - new value for attribute RejectEqualOrContainUsername
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
false

getRejectEqualOrContainReverseUsername

boolean getRejectEqualOrContainReverseUsername()

Specifies whether the password may contain, or be set to, the reverse of the username. The system evaluation of this password rule is case insensitive. If this rule is set to true, the password must not contain, or be set to, the reverse of the username.

To secure your system, set this value to true.

Changes take effect after you redeploy the module or restart the server.
Default Value:
false

setRejectEqualOrContainReverseUsername

void setRejectEqualOrContainReverseUsername(boolean newValue)
                                            throws InvalidAttributeValueException

Specifies whether the password may contain, or be set to, the reverse of the username. The system evaluation of this password rule is case insensitive. If this rule is set to true, the password must not contain, or be set to, the reverse of the username.

To secure your system, set this value to true.

Parameters:
newValue - - new value for attribute RejectEqualOrContainReverseUsername
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
false

getMaxPasswordLength

int getMaxPasswordLength()

Specifies the maximum number of characters that the password may contain. To be accepted, the password may not contain a greater number of characters than the value specified. Specifying 0 results in no restriction on password length.

The recommended value is 12.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMaxPasswordLength

void setMaxPasswordLength(int newValue)
                          throws InvalidAttributeValueException

Specifies the maximum number of characters that the password may contain. To be accepted, the password may not contain a greater number of characters than the value specified. Specifying 0 results in no restriction on password length.

The recommended value is 12.

Parameters:
newValue - - new value for attribute MaxPasswordLength
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMinPasswordLength

int getMinPasswordLength()

Specifies the minimum number of characters that the password must contain. To be accepted, the password must contain at least as many characters as the value specified.

The recommended value is 6.

Note: If the Default Authentication provider is configured in the realm, make sure that the minimum password length specified for the Password Validation provider is the same as for the Default Authentication provider.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMinPasswordLength

void setMinPasswordLength(int newValue)
                          throws InvalidAttributeValueException

Specifies the minimum number of characters that the password must contain. To be accepted, the password must contain at least as many characters as the value specified.

The recommended value is 6.

Note: If the Default Authentication provider is configured in the realm, make sure that the minimum password length specified for the Password Validation provider is the same as for the Default Authentication provider.

Parameters:
newValue - - new value for attribute MinPasswordLength
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMaxInstancesOfAnyCharacter

int getMaxInstancesOfAnyCharacter()

Specifies the maximum instances that any one character may appear in the password. For example, if this value is set to 2, the password alabaster is rejected. Specifying 0 results in no restriction.

The recommended value is 4.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMaxInstancesOfAnyCharacter

void setMaxInstancesOfAnyCharacter(int newValue)
                                   throws InvalidAttributeValueException

Specifies the maximum instances that any one character may appear in the password. For example, if this value is set to 2, the password alabaster is rejected. Specifying 0 results in no restriction.

The recommended value is 4.

Parameters:
newValue - - new value for attribute MaxInstancesOfAnyCharacter
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMaxConsecutiveCharacters

int getMaxConsecutiveCharacters()

Specifies the maximum instances that a specific character may appear consecutively in the password. For example, if you specify a value of 2, the password baaag is rejected.

The value you specify must be greater than or equal to 0. A value of 0 results in no restriction.

The recommended value is 3.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMaxConsecutiveCharacters

void setMaxConsecutiveCharacters(int newValue)
                                 throws InvalidAttributeValueException

Specifies the maximum instances that a specific character may appear consecutively in the password. For example, if you specify a value of 2, the password baaag is rejected.

The value you specify must be greater than or equal to 0. A value of 0 results in no restriction.

The recommended value is 3.

Parameters:
newValue - - new value for attribute MaxConsecutiveCharacters
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMinAlphabeticCharacters

int getMinAlphabeticCharacters()

Specifies the minimum number of alphabetic characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMinAlphabeticCharacters

void setMinAlphabeticCharacters(int newValue)
                                throws InvalidAttributeValueException

Specifies the minimum number of alphabetic characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Parameters:
newValue - - new value for attribute MinAlphabeticCharacters
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMinNumericCharacters

int getMinNumericCharacters()

Specifies the minimum number of numeric characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMinNumericCharacters

void setMinNumericCharacters(int newValue)
                             throws InvalidAttributeValueException

Specifies the minimum number of numeric characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Parameters:
newValue - - new value for attribute MinNumericCharacters
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMinLowercaseCharacters

int getMinLowercaseCharacters()

Specifies the minimum number of lowercase characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMinLowercaseCharacters

void setMinLowercaseCharacters(int newValue)
                               throws InvalidAttributeValueException

Specifies the minimum number of lowercase characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Parameters:
newValue - - new value for attribute MinLowercaseCharacters
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMinUppercaseCharacters

int getMinUppercaseCharacters()

Specifies the minimum number of uppercase characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMinUppercaseCharacters

void setMinUppercaseCharacters(int newValue)
                               throws InvalidAttributeValueException

Specifies the minimum number of uppercase characters that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Parameters:
newValue - - new value for attribute MinUppercaseCharacters
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMinNonAlphanumericCharacters

int getMinNonAlphanumericCharacters()

Specifies the minimum number of non-alphanumeric characters (also known as special characters, such as %, *, #, or }) that a password must contain.

The value you specify must be greater than or equal to 0.

The recommended value is 1.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMinNonAlphanumericCharacters

void setMinNonAlphanumericCharacters(int newValue)
                                     throws InvalidAttributeValueException

Specifies the minimum number of non-alphanumeric characters (also known as special characters, such as %, *, #, or }) that a password must contain.

The value you specify must be greater than or equal to 0.

The recommended value is 1.

Parameters:
newValue - - new value for attribute MinNonAlphanumericCharacters
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getMinNumericOrSpecialCharacters

int getMinNumericOrSpecialCharacters()

Specifies the minimum number of numeric or special characters (such as %, *, #, or }) that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

setMinNumericOrSpecialCharacters

void setMinNumericOrSpecialCharacters(int newValue)
                                      throws InvalidAttributeValueException

Specifies the minimum number of numeric or special characters (such as %, *, #, or }) that a password must contain. The value you specify must be greater than or equal to 0.

The recommended value is 1.

Parameters:
newValue - - new value for attribute MinNumericOrSpecialCharacters
Throws:
InvalidAttributeValueException
Changes take effect after you redeploy the module or restart the server.
Default Value:
0
Minimum Value:
0

getName

String getName()
Description copied from interface: ProviderMBean
The name of this configuration. WebLogic Server uses an MBean to implement and persist the configuration.

Specified by:
getName in interface ProviderMBean
Default Value:
"SystemPasswordValidator"

Documentation is available at
http://download.oracle.com/docs/cd/E12839_01/web.1111/wls.htm
Copyright 1996, 2009, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server 10.3.1 MBean API Reference
11g Release 1 (10.3.1)

Part Number E13945-02