com.ibm.commerce.security.commands

Class ResetPasswordAdministratorCmdImpl

java.lang.Object

com.ibm.websphere.command.TargetableCommandImpl

com.ibm.websphere.command.CacheableCommandImpl

com.ibm.commerce.command.MeasuredCacheableCommandImpl

com.ibm.commerce.command.AbstractECTargetableCommand

com.ibm.commerce.command.ControllerCommandImpl

com.ibm.commerce.security.commands.ResetPasswordAdministratorCmdImpl

All Implemented Interfaces:

AccCommand, ControllerCommand, ECCommand, ECTargetableCommand, ResetPasswordAdministratorCmd, Protectable, com.ibm.websphere.cache.Sizeable, com.ibm.websphere.command.CacheableCommand, com.ibm.websphere.command.Command, com.ibm.websphere.command.CommandCaller, com.ibm.websphere.command.TargetableCommand, java.io.Serializable

public class ResetPasswordAdministratorCmdImpl
extends ControllerCommandImpl
implements ResetPasswordAdministratorCmd

This controller command is used by an administrator to reset the password of a shopper.

Before executing this task command, the methods listed below must be invoked.

• setLogonId
• setAdministratorPassword
• setRedirectURL

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	COPYRIGHT The copyright statement.
static java.lang.String	ERRTASK_NAME The error task name.

Fields inherited from class com.ibm.websphere.command.TargetableCommandImpl

LOCAL

Fields inherited from interface com.ibm.commerce.security.commands.ResetPasswordAdministratorCmd

defaultCommandClassName, NAME

Fields inherited from interface com.ibm.websphere.command.Command

serialVersionUID

Constructor Summary

Constructors

Constructor and Description
ResetPasswordAdministratorCmdImpl()

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAdminPassword() Retrieves the password of the administrator who is resetting the shopper's password.
java.lang.String	getLogonId() Retrieves the logon ID of the shopper whose password needs to be reset.
java.lang.String	getRedirectURL() Retrieves the URL to redirect the user to after a successful password reset.
AccessVector	getResources() Gets the resources accessed by this command.
void	performExecute() This method executes the command to reset the password of user in one of two ways: Default: Generates a new random password and email's it to the user.
void	setAdministratorPassword(java.lang.String strAdminPassword) This method sets the administrator’s password, who resets the password of the shopper.
void	setLogonId(java.lang.String strLogonId) This method sets the logon ID of the shopper whose password is reset.
void	setRedirectURL(java.lang.String strRedirectURL) This method sets the URL to redirect the user to after a successful password reset.
void	setRequestProperties(TypedProperty hshReqParameters) This method sets the request properties.
void	validateParameters() This method validates the parameters by ensuring the following: The redirectURL is specified.

Methods inherited from class com.ibm.commerce.command.ControllerCommandImpl

checkPermission, fulfills, getForUserId, getGeneric, getOwner, getRequestProperties, getResolvedRequestProperties, getResourceOwners, getResponseProperties, getRetriable, getViewInputProperties, isGeneric, isRetriable, mergeProperties, setForUserId, setGeneric, setOwner, setResponseProperties, setRetriable, setViewInputProperties

Methods inherited from class com.ibm.commerce.command.AbstractECTargetableCommand

accessControlCheck, checkIsAllowed, checkResourcePermission, createCommandExecutionEvent, execute, getAccCheck, getCommandContext, getCommandIfName, getCommandName, getCommandStoreId, getDefaultProperties, getExceptionInvokeParameters, getObjectSize, getPostInvokeParameters, getPreInvokeParameters, getStoreId, getUser, getUserId, isReadyToCallExecute, reset, setAccCheck, setCommandContext, setCommandIfName, setCommandStoreId, setDefaultProperties

Methods inherited from class com.ibm.websphere.command.CacheableCommandImpl

executeFromCache, getCaller, getEntryInfo, getId, getSharingPolicy, postExecute, preExecute, setCaller, setObjectSize, unionDependencies, updateCache

Methods inherited from class com.ibm.websphere.command.TargetableCommandImpl

getCommandTarget, getCommandTargetName, getTargetPolicy, hasOutputProperties, setCommandTarget, setCommandTargetName, setHasOutputProperties, setOutputProperties, setTargetPolicy

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.ibm.commerce.command.ControllerCommand

checkPermission, execute, getGeneric, getRequestProperties, getResolvedRequestProperties, getResponseProperties, getRetriable, getViewInputProperties, isGeneric, isRetriable, mergeProperties, setGeneric, setRetriable, setViewInputProperties

Methods inherited from interface com.ibm.websphere.command.CacheableCommand

executeFromCache, getCaller, getEntryInfo, getId, getSharingPolicy, postExecute, preExecute, setCaller, updateCache

Methods inherited from interface com.ibm.websphere.command.TargetableCommand

getCommandTarget, getCommandTargetName, hasOutputProperties, setCommandTarget, setCommandTargetName, setOutputProperties

Methods inherited from interface com.ibm.websphere.command.CommandCaller

unionDependencies

Methods inherited from interface com.ibm.commerce.command.AccCommand

accessControlCheck, getAccCheck, getForUserId, getResourceOwners, setAccCheck, setForUserId, setOwner

Methods inherited from interface com.ibm.commerce.command.ECCommand

checkIsAllowed, checkResourcePermission, createCommandExecutionEvent, getCommandContext, getCommandIfName, getCommandName, getCommandStoreId, getDefaultProperties, getExceptionInvokeParameters, getPostInvokeParameters, getPreInvokeParameters, getStoreId, getUser, getUserId, setCommandContext, setCommandIfName, setCommandStoreId, setDefaultProperties

Methods inherited from interface com.ibm.websphere.command.Command

isReadyToCallExecute, reset

Methods inherited from interface com.ibm.commerce.security.Protectable

fulfills, getOwner

Field Detail

COPYRIGHT

public static final java.lang.String COPYRIGHT

The copyright statement.

See Also:

Constant Field Values

ERRTASK_NAME

public static final java.lang.String ERRTASK_NAME

The error task name.

See Also:

Constant Field Values

Constructor Detail

ResetPasswordAdministratorCmdImpl

public ResetPasswordAdministratorCmdImpl()

Method Detail

getAdminPassword

public java.lang.String getAdminPassword()

Retrieves the password of the administrator who is resetting the shopper's password.

Returns:

The administrator's password.

getLogonId

public java.lang.String getLogonId()

Retrieves the logon ID of the shopper whose password needs to be reset.

Returns:

The logon ID.

getRedirectURL

public java.lang.String getRedirectURL()

Retrieves the URL to redirect the user to after a successful password reset.

Returns:

The URL to redirect too.

getResources

public AccessVector getResources()
                          throws ECException

Gets the resources accessed by this command. For this command, the resource accessed is the user whose password is being reset.

Specified by:

getResources in interface ECCommand

Overrides:

getResources in class AbstractECTargetableCommand

Returns:

A vector of resource action pairs used by the command.

Throws:

ECException - If the resource can not be retrieved.

performExecute

public void performExecute()
                    throws ECException

This method executes the command to reset the password of user in one of two ways:

1. Default: Generates a new random password and email's it to the user.
2. 7.0.0.9+ when validationCode=true in CMDREG table: Sends a validation code along with a URL for ResetPasswordForm, so that the validation code and new password can be specified.
3. V8+ when byPassAdminPassword=true in CMDREG table: Bypass the validation for administrator's password. The administrator's password is not a mandatory input and VerifyCredentialsCmd will be bypassed.

This command requires the administrator's account not to be disabled and the supplied administrator's credentials to be valid. The following methods are called:

• VerifyCredentialsCmd to verify that the administrator's credentials are valid.
• GeneratePasswordCmd to generate a new random password.
• SendPasswordNotificationCmd to send the new password to the user, or if configured to use validation code, the code is passed using the password setter. The ResetPasswordForm URL is passed in the default properties.

Specified by:

performExecute in interface ECCommand

Specified by:

performExecute in interface com.ibm.websphere.command.TargetableCommand

Overrides:

performExecute in class AbstractECTargetableCommand

Throws:

ECException

setAdministratorPassword

public void setAdministratorPassword(java.lang.String strAdminPassword)

This method sets the administrator’s password, who resets the password of the shopper.

Specified by:

setAdministratorPassword in interface ResetPasswordAdministratorCmd

Parameters:

strAdminPassword - The administrator's password.

setLogonId

public void setLogonId(java.lang.String strLogonId)

This method sets the logon ID of the shopper whose password is reset.

Specified by:

setLogonId in interface ResetPasswordAdministratorCmd

Parameters:

strLogonId - Login ID to set.

setRedirectURL

public void setRedirectURL(java.lang.String strRedirectURL)

This method sets the URL to redirect the user to after a successful password reset.

Specified by:

setRedirectURL in interface ResetPasswordAdministratorCmd

Parameters:

strRedirectURL - URL to redirect to.

setRequestProperties

public void setRequestProperties(TypedProperty hshReqParameters)
                          throws ECApplicationException

This method sets the request properties. It retrieves the logon ID and administrator password from the provided request parameters.

Specified by:

setRequestProperties in interface ControllerCommand

Overrides:

setRequestProperties in class ControllerCommandImpl

Parameters:

hshReqParameters - The request parameters.

Throws:

ECApplicationException

validateParameters

public void validateParameters()
                        throws ECException

This method validates the parameters by ensuring the following:

• The redirectURL is specified.
• The userType is either administrator or siteAdministrator.
• The logon ID is specified and belongs to a registered user.
• The administrator's password is specified.

Specified by:

validateParameters in interface ECCommand

Overrides:

validateParameters in class AbstractECTargetableCommand

Throws:

ECException