BEA Systems, Inc.

Type-Safe Access to BEA WebLogic Server 9.2 MBeans (Deprecated)

(Methods marked with @since 9.0.0.0 are not available through the deprecated MBeanHome interface.)


weblogic.security.providers.authentication
Interface SQLAuthenticatorMBean

All Superinterfaces:
AuthenticationProviderMBean, AuthenticatorMBean, DBMSAuthenticatorMBean, weblogic.descriptor.DescriptorBean, GroupEditorMBean, GroupMemberListerMBean, GroupMembershipHierarchyCacheMBean, GroupReaderMBean, GroupRemoverMBean, ListerMBean, MemberGroupListerMBean, NameListerMBean, ProviderMBean, ReadOnlySQLAuthenticatorMBean, weblogic.descriptor.SettableBean, weblogic.management.commo.StandardInterface, UserEditorMBean, UserPasswordEditorMBean, UserReaderMBean, UserRemoverMBean

public interface SQLAuthenticatorMBean
extends weblogic.management.commo.StandardInterface, weblogic.descriptor.DescriptorBean, ReadOnlySQLAuthenticatorMBean, GroupMemberListerMBean, MemberGroupListerMBean, UserPasswordEditorMBean, UserEditorMBean, GroupEditorMBean

This MBean contains configuration information for the SQL Authentication 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. For more information, see "Developing Manageable Applications with JMX" on http://www.oracle.com/technology/documentation/index.html.


Method Summary
 String getName()
          The name of this configuration.
 String getPasswordAlgorithm()
          The message digest algorithm used to hash passwords for storage.
 String getPasswordStyle()
          Indicates the password style that is used when storing passwords for users that are created and for changing the user's password if Password Style Retained is disabled.
 String getProviderClassName()
          The name of the Java class for the SQL Authentication provider.
 String getSQLAddMemberToGroup()
          The SQL statement used to add a specific member to a group.
 String getSQLCreateGroup()
          The SQL statement requirements depend on the value of Descriptions Supported.
 String getSQLCreateUser()
          The SQL statement used to create a new user record The SQL statement requirements depend on the value of Descriptions Supported.
 String getSQLListGroupMembers()
          The SQL statement used to list groups that have a group name with a list of wildcarded member names.
 String getSQLRemoveGroup()
          The SQL statement used to remove a member from a group.
 String getSQLRemoveGroupMember()
          The SQL statement used to remove a member from a group.
 String getSQLRemoveGroupMemberships()
          The SQL statement used to delete a group member (either a user or group) from all groups to which it belongs.
 String getSQLRemoveMemberFromGroup()
          The SQL statement used to remove a member from a group.
 String getSQLRemoveUser()
          The SQL statement used for deleting a user.
 String getSQLSetGroupDescription()
          The SQL statement used to specify a description for a group.
 String getSQLSetUserDescription()
          The SQL statement used to specify description for a user.
 String getSQLSetUserPassword()
          The SQL statement used to set the password for a user.
 boolean isPasswordStyleRetained()
          Controls how a password is stored in the database when updating an existing user's password.
 void setPasswordAlgorithm(String newValue)
          The message digest algorithm used to hash passwords for storage.
 void setPasswordStyle(String newValue)
          Indicates the password style that is used when storing passwords for users that are created and for changing the user's password if Password Style Retained is disabled.
 void setPasswordStyleRetained(boolean newValue)
          Controls how a password is stored in the database when updating an existing user's password.
 void setSQLAddMemberToGroup(String newValue)
          The SQL statement used to add a specific member to a group.
 void setSQLCreateGroup(String newValue)
          The SQL statement requirements depend on the value of Descriptions Supported.
 void setSQLCreateUser(String newValue)
          The SQL statement used to create a new user record The SQL statement requirements depend on the value of Descriptions Supported.
 void setSQLListGroupMembers(String newValue)
          The SQL statement used to list groups that have a group name with a list of wildcarded member names.
 void setSQLRemoveGroup(String newValue)
          The SQL statement used to remove a member from a group.
 void setSQLRemoveGroupMember(String newValue)
          The SQL statement used to remove a member from a group.
 void setSQLRemoveGroupMemberships(String newValue)
          The SQL statement used to delete a group member (either a user or group) from all groups to which it belongs.
 void setSQLRemoveMemberFromGroup(String newValue)
          The SQL statement used to remove a member from a group.
 void setSQLRemoveUser(String newValue)
          The SQL statement used for deleting a user.
 void setSQLSetGroupDescription(String newValue)
          The SQL statement used to specify a description for a group.
 void setSQLSetUserDescription(String newValue)
          The SQL statement used to specify description for a user.
 void setSQLSetUserPassword(String newValue)
          The SQL statement used to set the password for a user.
 
Methods inherited from interface weblogic.management.commo.StandardInterface
setName, wls_getDisplayName, wls_getInterfaceClassName, wls_getObjectName
 
Methods inherited from interface weblogic.descriptor.DescriptorBean
addBeanUpdateListener, addPropertyChangeListener, createChildCopy, createChildCopyIncludingObsolete, getDescriptor, getParentBean, isEditable, removeBeanUpdateListener, removePropertyChangeListener
 
Methods inherited from interface weblogic.descriptor.SettableBean
isSet, unSet
 
Methods inherited from interface weblogic.security.providers.authentication.ReadOnlySQLAuthenticatorMBean
getDescriptionsSupported, getSQLGetGroupDescription, getSQLGetUserDescription, getSQLGetUsersPassword, getSQLGroupExists, getSQLIsMember, getSQLListGroups, getSQLListMemberGroups, getSQLListUsers, getSQLUserExists, setDescriptionsSupported, setSQLGetGroupDescription, setSQLGetUserDescription, setSQLGetUsersPassword, setSQLGroupExists, setSQLIsMember, setSQLListGroups, setSQLListMemberGroups, setSQLListUsers, setSQLUserExists
 
Methods inherited from interface weblogic.security.providers.authentication.DBMSAuthenticatorMBean
getDataSourceName, getDescription, getGroupMembershipSearching, getMaxGroupMembershipSearchLevel, getVersion, isPlaintextPasswordsEnabled, setDataSourceName, setGroupMembershipSearching, setMaxGroupMembershipSearchLevel, setPlaintextPasswordsEnabled
 
Methods inherited from interface weblogic.management.security.authentication.AuthenticatorMBean
getControlFlag, setControlFlag
 
Methods inherited from interface weblogic.management.security.ProviderMBean
getRealm
 
Methods inherited from interface weblogic.management.security.authentication.GroupMembershipHierarchyCacheMBean
getEnableGroupMembershipLookupHierarchyCaching, getGroupHierarchyCacheTTL, getMaxGroupHierarchiesInCache, setEnableGroupMembershipLookupHierarchyCaching, setGroupHierarchyCacheTTL, setMaxGroupHierarchiesInCache
 
Methods inherited from interface weblogic.management.security.authentication.UserReaderMBean
getUserDescription, listUsers, userExists
 
Methods inherited from interface weblogic.management.utils.NameListerMBean
getCurrentName
 
Methods inherited from interface weblogic.management.utils.ListerMBean
advance, close, haveCurrent
 
Methods inherited from interface weblogic.management.security.authentication.GroupReaderMBean
getGroupDescription, groupExists, isMember, listGroups
 
Methods inherited from interface weblogic.management.security.authentication.GroupMemberListerMBean
listGroupMembers
 
Methods inherited from interface weblogic.management.security.authentication.MemberGroupListerMBean
listMemberGroups
 
Methods inherited from interface weblogic.management.security.authentication.UserPasswordEditorMBean
changeUserPassword, resetUserPassword
 
Methods inherited from interface weblogic.management.security.authentication.UserEditorMBean
createUser, setUserDescription
 
Methods inherited from interface weblogic.management.security.authentication.UserRemoverMBean
removeUser
 
Methods inherited from interface weblogic.management.security.authentication.GroupEditorMBean
addMemberToGroup, createGroup, removeMemberFromGroup, setGroupDescription
 
Methods inherited from interface weblogic.management.security.authentication.GroupRemoverMBean
removeGroup
 

Method Detail

getName

public 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 weblogic.management.commo.StandardInterface

getPasswordAlgorithm

public String getPasswordAlgorithm()

The message digest algorithm used to hash passwords for storage. The name must be recognized by a Java Cryptography Extension (JCE) provider that is available at runtime.


getPasswordStyle

public String getPasswordStyle()

Indicates the password style that is used when storing passwords for users that are created and for changing the user's password if Password Style Retained is disabled.


getProviderClassName

public String getProviderClassName()

The name of the Java class for the SQL Authentication provider.

Specified by:
getProviderClassName in interface ReadOnlySQLAuthenticatorMBean

getSQLAddMemberToGroup

public String getSQLAddMemberToGroup()

The SQL statement used to add a specific member to a group. The SQL statement requires two parameters: the group name and the group member being added.


getSQLCreateGroup

public String getSQLCreateGroup()

The SQL statement requirements depend on the value of Descriptions Supported. There is a minimum of one parameter, the group name. If Descriptions Supported is true, the group's description is required. The default SQL is based on the default setting of Descriptions Supported. The setting of Create Group must be updated manually if the setting of Descriptions Supported changes.


getSQLCreateUser

public String getSQLCreateUser()

The SQL statement used to create a new user record The SQL statement requirements depend on the value of Descriptions Supported. There are a minimum of two parameters: a username and its associated password. If Descriptions Supported is true, the user's description is required. The default SQL is based on the default setting of Descriptions Supported. The setting of Create User must be updated manually if the setting of Descriptions Supported changes.


getSQLListGroupMembers

public String getSQLListGroupMembers()

The SQL statement used to list groups that have a group name with a list of wildcarded member names. The SQL statement requires two parameters: the group name and the wildcarded member name.


getSQLRemoveGroup

public String getSQLRemoveGroup()

The SQL statement used to remove a member from a group. The SQL statement requires a single parameter: the group name being removed.


getSQLRemoveGroupMember

public String getSQLRemoveGroupMember()

The SQL statement used to remove a member from a group. The SQL statement requires a single parameter: the username or group name being removed.


getSQLRemoveGroupMemberships

public String getSQLRemoveGroupMemberships()

The SQL statement used to delete a group member (either a user or group) from all groups to which it belongs. The SQL statement requires 2 parameters.Both parameters refer to the specific username or group name being removed.


getSQLRemoveMemberFromGroup

public String getSQLRemoveMemberFromGroup()

The SQL statement used to remove a member from a group. The SQL statement requires two parameters: the group name and the group member being deleted from the group.


getSQLRemoveUser

public String getSQLRemoveUser()

The SQL statement used for deleting a user. The SQL statement requires a single parameter, the username.


getSQLSetGroupDescription

public String getSQLSetGroupDescription()

The SQL statement used to specify a description for a group. Only valid if Descriptions Supported attribute is enabled. The SQL statement requires two parameters: the group description and the group name.


getSQLSetUserDescription

public String getSQLSetUserDescription()

The SQL statement used to specify description for a user. Only valid if Descriptions Supported is true. The SQL statement requires two parameters: the username description and the username.


getSQLSetUserPassword

public String getSQLSetUserPassword()

The SQL statement used to set the password for a user. The SQL statement requires two parameters: the password for the user and the username.


isPasswordStyleRetained

public boolean isPasswordStyleRetained()

Controls how a password is stored in the database when updating an existing user's password.


setPasswordAlgorithm

public void setPasswordAlgorithm(String newValue)
                          throws InvalidAttributeValueException

The message digest algorithm used to hash passwords for storage. The name must be recognized by a Java Cryptography Extension (JCE) provider that is available at runtime.

Parameters:
newValue - - new value for attribute PasswordAlgorithm
Throws:
InvalidAttributeValueException

setPasswordStyle

public void setPasswordStyle(String newValue)
                      throws InvalidAttributeValueException

Indicates the password style that is used when storing passwords for users that are created and for changing the user's password if Password Style Retained is disabled.

Parameters:
newValue - - new value for attribute PasswordStyle
Throws:
InvalidAttributeValueException

setPasswordStyleRetained

public void setPasswordStyleRetained(boolean newValue)
                              throws InvalidAttributeValueException

Controls how a password is stored in the database when updating an existing user's password.

Parameters:
newValue - - new value for attribute PasswordStyleRetained
Throws:
InvalidAttributeValueException

setSQLAddMemberToGroup

public void setSQLAddMemberToGroup(String newValue)
                            throws InvalidAttributeValueException

The SQL statement used to add a specific member to a group. The SQL statement requires two parameters: the group name and the group member being added.

Parameters:
newValue - - new value for attribute SQLAddMemberToGroup
Throws:
InvalidAttributeValueException

setSQLCreateGroup

public void setSQLCreateGroup(String newValue)
                       throws InvalidAttributeValueException

The SQL statement requirements depend on the value of Descriptions Supported. There is a minimum of one parameter, the group name. If Descriptions Supported is true, the group's description is required. The default SQL is based on the default setting of Descriptions Supported. The setting of Create Group must be updated manually if the setting of Descriptions Supported changes.

Parameters:
newValue - - new value for attribute SQLCreateGroup
Throws:
InvalidAttributeValueException

setSQLCreateUser

public void setSQLCreateUser(String newValue)
                      throws InvalidAttributeValueException

The SQL statement used to create a new user record The SQL statement requirements depend on the value of Descriptions Supported. There are a minimum of two parameters: a username and its associated password. If Descriptions Supported is true, the user's description is required. The default SQL is based on the default setting of Descriptions Supported. The setting of Create User must be updated manually if the setting of Descriptions Supported changes.

Parameters:
newValue - - new value for attribute SQLCreateUser
Throws:
InvalidAttributeValueException

setSQLListGroupMembers

public void setSQLListGroupMembers(String newValue)
                            throws InvalidAttributeValueException

The SQL statement used to list groups that have a group name with a list of wildcarded member names. The SQL statement requires two parameters: the group name and the wildcarded member name.

Parameters:
newValue - - new value for attribute SQLListGroupMembers
Throws:
InvalidAttributeValueException

setSQLRemoveGroup

public void setSQLRemoveGroup(String newValue)
                       throws InvalidAttributeValueException

The SQL statement used to remove a member from a group. The SQL statement requires a single parameter: the group name being removed.

Parameters:
newValue - - new value for attribute SQLRemoveGroup
Throws:
InvalidAttributeValueException

setSQLRemoveGroupMember

public void setSQLRemoveGroupMember(String newValue)
                             throws InvalidAttributeValueException

The SQL statement used to remove a member from a group. The SQL statement requires a single parameter: the username or group name being removed.

Parameters:
newValue - - new value for attribute SQLRemoveGroupMember
Throws:
InvalidAttributeValueException

setSQLRemoveGroupMemberships

public void setSQLRemoveGroupMemberships(String newValue)
                                  throws InvalidAttributeValueException

The SQL statement used to delete a group member (either a user or group) from all groups to which it belongs. The SQL statement requires 2 parameters.Both parameters refer to the specific username or group name being removed.

Parameters:
newValue - - new value for attribute SQLRemoveGroupMemberships
Throws:
InvalidAttributeValueException

setSQLRemoveMemberFromGroup

public void setSQLRemoveMemberFromGroup(String newValue)
                                 throws InvalidAttributeValueException

The SQL statement used to remove a member from a group. The SQL statement requires two parameters: the group name and the group member being deleted from the group.

Parameters:
newValue - - new value for attribute SQLRemoveMemberFromGroup
Throws:
InvalidAttributeValueException

setSQLRemoveUser

public void setSQLRemoveUser(String newValue)
                      throws InvalidAttributeValueException

The SQL statement used for deleting a user. The SQL statement requires a single parameter, the username.

Parameters:
newValue - - new value for attribute SQLRemoveUser
Throws:
InvalidAttributeValueException

setSQLSetGroupDescription

public void setSQLSetGroupDescription(String newValue)
                               throws InvalidAttributeValueException

The SQL statement used to specify a description for a group. Only valid if Descriptions Supported attribute is enabled. The SQL statement requires two parameters: the group description and the group name.

Parameters:
newValue - - new value for attribute SQLSetGroupDescription
Throws:
InvalidAttributeValueException

setSQLSetUserDescription

public void setSQLSetUserDescription(String newValue)
                              throws InvalidAttributeValueException

The SQL statement used to specify description for a user. Only valid if Descriptions Supported is true. The SQL statement requires two parameters: the username description and the username.

Parameters:
newValue - - new value for attribute SQLSetUserDescription
Throws:
InvalidAttributeValueException

setSQLSetUserPassword

public void setSQLSetUserPassword(String newValue)
                           throws InvalidAttributeValueException

The SQL statement used to set the password for a user. The SQL statement requires two parameters: the password for the user and the username.

Parameters:
newValue - - new value for attribute SQLSetUserPassword
Throws:
InvalidAttributeValueException

Documentation is available at
http://download.oracle.com/docs/cd/E13222_01/wls/docs92
Copyright 2006 BEA Systems Inc.