BEA Systems, Inc.

weblogic.management.security.authentication
Interface UserPasswordEditorMBean

All Superinterfaces:
weblogic.descriptor.DescriptorBean, weblogic.descriptor.SettableBean, weblogic.management.commo.StandardInterface
All Known Subinterfaces:
UserEditorMBean

public interface UserPasswordEditorMBean
extends weblogic.management.commo.StandardInterface, weblogic.descriptor.DescriptorBean

Provides two methods for changing a user's password. An Authentication provider MBean can optionally implement this MBean. The WebLogic Server Administration Console detects when an Authentication provider implements this MBean and automatically provides a tab for using these methods.

Deprecation of MBeanHome and Type-Safe Interfaces

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.


Method Summary
 void changeUserPassword(String userName, String oldPassword, String newPassword)
          Used by a user to change his or her password.
 void resetUserPassword(String userName, String newPassword)
          Used by an administrator to change a user's password.
 
Methods inherited from interface weblogic.management.commo.StandardInterface
getName, 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

changeUserPassword

void changeUserPassword(String userName,
                        String oldPassword,
                        String newPassword)
                        throws NotFoundException,
                               InvalidParameterException
Used by a user to change his or her password.

Parameters:
userName - - The name of an existing user.
oldPassword - - The current password for the user.
newPassword - - The new password for the user. The Authentication provider determines the syntax requirements for passwords.
Throws:
NotFoundException
InvalidParameterException

resetUserPassword

void resetUserPassword(String userName,
                       String newPassword)
                       throws NotFoundException,
                              InvalidParameterException
Used by an administrator to change a user's password.

Parameters:
userName - - The name of an existing user.
newPassword - - The new password for the user. The Authentication provider determines the syntax requirements for passwords.
Throws:
NotFoundException
InvalidParameterException

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