|
BEA Systems, Inc. | |||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Lists and manages lockouts on user accounts.
In addition to being used as
a base class that provides functionality to security provider
MBeans, JMX applications can use this class directly as a type-safe
interface. When used as a type-safe interface, a JMX application
imports this class and accesses it through
weblogic.management.MBeanHome
. As of 9.0, the
MBeanHome
interface and all type-safe interfaces for
WebLogic Server MBeans are deprecated. Instead, JMX applications 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.
The methods to manage currently locked out users and to get lockout statistics have been deprecated in 9.0.0.0 and moved to ServerRuntime.getServerSecurityRuntime().getDefaultRealmRuntime().getUserLocoutManagerRuntime().
Method Summary | |
void |
clearLockout(String userName)
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.clearLockout(String) |
long |
getInvalidLoginAttemptsTotalCount()
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getInvalidLoginAttemptsTotalCount() |
long |
getInvalidLoginUsersHighCount()
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getInvalidLoginUsersHighCount() |
long |
getLastLoginFailure(String userName)
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getLastLoginFailure(String) |
long |
getLockedUsersCurrentCount()
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getLockedUsersCurrentCount() |
long |
getLockoutCacheSize()
Returns the number of invalid login records that the server places in a cache. |
long |
getLockoutDuration()
Returns the number of minutes that a user account is locked out. |
long |
getLockoutGCThreshold()
Returns the maximum number of invalid login records that the server keeps in memory. |
long |
getLockoutResetDuration()
The number of minutes within which consecutive invalid login attempts cause the user account to be locked out. |
long |
getLockoutThreshold()
Returns the maximum number of consecutive invalid login attempts before account is locked out. |
long |
getLoginAttemptsWhileLockedTotalCount()
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getLoginAttemptsWhileLockedTotalCount() |
long |
getLoginFailureCount(String userName)
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getLoginFailureCount(String) |
String |
getName()
The name of this configuration. |
RealmMBean |
getRealm()
Returns the realm that contains this user lockout manager. |
long |
getUnlockedUsersTotalCount()
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getUnlockedUsersTotalCount() |
long |
getUserLockoutTotalCount()
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.getUserLockoutTotalCount() |
boolean |
isLockedOut(String userName)
Deprecated. 9.0.0.0 Replaced by ServerSecurityRuntimeMBean.isLockedOut(String) |
boolean |
isLockoutEnabled()
Returns whether the server locks out users when there are invalid login attempts. |
void |
setLockoutCacheSize(long lockoutCacheSize)
Sets the number of invalid login records that the server places in a cache. |
void |
setLockoutDuration(long lockoutDuration)
Sets the number of minutes that a user account is locked out. |
void |
setLockoutEnabled(boolean lockoutEnabled)
Sets whether the server locks out users when there are invalid login attempts. |
void |
setLockoutGCThreshold(long lockoutGCThreshold)
Sets the maximum number of invalid login records that the server keeps in memory. |
void |
setLockoutResetDuration(long newValue)
The number of minutes within which consecutive invalid login attempts cause the user account to be locked out. |
void |
setLockoutThreshold(long lockoutThreshold)
Sets the maximum number of consecutive invalid login attempts before account is locked out. |
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 |
Method Detail |
public void clearLockout(String userName)
ServerSecurityRuntimeMBean.clearLockout(String)
userName
- - A user name. If the user does not exist, this method returns false
.public long getInvalidLoginAttemptsTotalCount()
ServerSecurityRuntimeMBean.getInvalidLoginAttemptsTotalCount()
public long getInvalidLoginUsersHighCount()
ServerSecurityRuntimeMBean.getInvalidLoginUsersHighCount()
LockoutResetDuration
.
This count is useful in determining whether the LockoutCacheSize
needs to be modified.
public long getLastLoginFailure(String userName)
ServerSecurityRuntimeMBean.getLastLoginFailure(String)
userName
- - A user name. If the user does not exist, this method returns false
.public long getLockedUsersCurrentCount()
ServerSecurityRuntimeMBean.getLockedUsersCurrentCount()
public long getLockoutCacheSize()
public long getLockoutDuration()
public long getLockoutGCThreshold()
The lower the threshold, the more often the server uses its resources to collect garbage.
public long getLockoutResetDuration()
public long getLockoutThreshold()
LockoutThreshold
value, the user is locked out. For example,
with the default setting of 1
, the user is locked out on the
second consecutive invalid login. With a setting of 2
, the user
is locked out on the third consecutive invalid login.
public long getLoginAttemptsWhileLockedTotalCount()
ServerSecurityRuntimeMBean.getLoginAttemptsWhileLockedTotalCount()
public long getLoginFailureCount(String userName)
ServerSecurityRuntimeMBean.getLoginFailureCount(String)
userName
- - A user name. If the user does not exist, this method returns false
.public String getName()
getName
in interface weblogic.management.commo.StandardInterface
public RealmMBean getRealm()
public long getUnlockedUsersTotalCount()
ServerSecurityRuntimeMBean.getUnlockedUsersTotalCount()
public long getUserLockoutTotalCount()
ServerSecurityRuntimeMBean.getUserLockoutTotalCount()
public boolean isLockedOut(String userName)
ServerSecurityRuntimeMBean.isLockedOut(String)
userName
- - A user name. If the user does not exist, this method returns false
.public boolean isLockoutEnabled()
true
value for this attribute causes the server to consider
the other attributes of this MBean. A false
value causes the server
to ignore the other attributes of this MBean."
public void setLockoutCacheSize(long lockoutCacheSize) throws InvalidAttributeValueException
lockoutCacheSize
- - the new lockout cache size
InvalidAttributeValueException
getLockoutCacheSize()
public void setLockoutDuration(long lockoutDuration) throws InvalidAttributeValueException
lockoutDuration
- - the new lockout duration in minutes
InvalidAttributeValueException
getLockoutDuration()
public void setLockoutEnabled(boolean lockoutEnabled) throws InvalidAttributeValueException
lockoutEnabled
- - the new lockout enabled value
InvalidAttributeValueException
isLockoutEnabled()
public void setLockoutGCThreshold(long lockoutGCThreshold) throws InvalidAttributeValueException
lockoutGCThreshold
- - the new lockout garbage collection threshold
InvalidAttributeValueException
getLockoutGCThreshold()
public void setLockoutResetDuration(long newValue) throws InvalidAttributeValueException
newValue
- - new value for attribute LockoutResetDuration
InvalidAttributeValueException
getLockoutResetDuration()
public void setLockoutThreshold(long lockoutThreshold) throws InvalidAttributeValueException
lockoutThreshold
- - the new lockout threshold
InvalidAttributeValueException
getLockoutThreshold()
|
Documentation is available at http://download.oracle.com/docs/cd/E13222_01/wls/docs90 Copyright 2005 BEA Systems Inc. |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |