org.cyclos.impl.access

Interface FailedActionHandler

public interface FailedActionHandler

Handles the failed attempts to perform an action

Author:

jcomas

Method Summary

Modifier and Type	Method and Description
void	clearGuestFailures(org.cyclos.impl.access.FailedAction action, java.lang.String remoteAddress) Clears all the guest failures for the given action and remote address
void	clearPasswordFailures(BasicUser user, PasswordType passwordType, boolean forgot) Clears all the password failures for the given user and password type, either in normal or forgot password mode
void	clearPinFailures(Pin pin) Clears all the pin failures for the given Pin
void	clearUserFailures(org.cyclos.impl.access.FailedAction action, BasicUser user) Clears all the user failures for the given action and user
int	countGuestFailures(org.cyclos.impl.access.FailedAction action, java.lang.String remoteAddress) Returns the number of guest failures for the given action and remote address
int	countPasswordFailures(BasicUser user, PasswordType passwordType, boolean forgot) Returns the number of password failures for the given user and password type, either in normal or forgot password mode.
int	countPinFailures(Pin pin) Returns the number of pin failures for the given pin
int	countUserFailures(org.cyclos.impl.access.FailedAction action, BasicUser user) Returns the number of user failures for the given action and user.
boolean	isBlocked(java.lang.String remoteAddress) Returns whether the given remote address is blocked
boolean	recordAndBlockUserIfMaxReached(org.cyclos.impl.access.FailedAction action, BasicUser user, java.lang.Integer max, UserAlertType alertType) Records an action failure, blocks the user (if null use the logged user) if the max has been reached and generates an user alert.
boolean	recordGuestFailure(org.cyclos.impl.access.FailedAction action, java.lang.String remoteAddress, UserLocatorVO locator, java.lang.Integer maxAttempts, TimeInterval blockTime) Registers a transaction end listener to actually record the action failure.
boolean	recordPasswordFailure(BasicUser user, PasswordType passwordType, boolean forgot) Registers a transaction end listener to actually record the password failure, either in normal or forgot password mode.
boolean	recordPinFailure(Pin pin, java.lang.Integer maxAttempts, java.lang.Runnable onMaxReached) Registers a transaction end listener to actually record the pin failure.
boolean	recordUserFailure(org.cyclos.impl.access.FailedAction action, BasicUser user, java.lang.Integer maxAttempts, java.lang.Runnable onMaxReached) Registers a transaction end listener to actually record the user action failure.

Method Detail

clearGuestFailures

void clearGuestFailures(org.cyclos.impl.access.FailedAction action,
                        java.lang.String remoteAddress)

Clears all the guest failures for the given action and remote address

clearPasswordFailures

void clearPasswordFailures(BasicUser user,
                           PasswordType passwordType,
                           boolean forgot)

Clears all the password failures for the given user and password type, either in normal or forgot password mode

clearPinFailures

void clearPinFailures(Pin pin)

Clears all the pin failures for the given Pin

clearUserFailures

void clearUserFailures(org.cyclos.impl.access.FailedAction action,
                       BasicUser user)

Clears all the user failures for the given action and user

countGuestFailures

int countGuestFailures(org.cyclos.impl.access.FailedAction action,
                       java.lang.String remoteAddress)

Returns the number of guest failures for the given action and remote address

countPasswordFailures

int countPasswordFailures(BasicUser user,
                          PasswordType passwordType,
                          boolean forgot)

Returns the number of password failures for the given user and password type, either in normal or forgot password mode.

countPinFailures

int countPinFailures(Pin pin)
              throws FrameworkException

Returns the number of pin failures for the given pin

Throws:

FrameworkException

countUserFailures

int countUserFailures(org.cyclos.impl.access.FailedAction action,
                      BasicUser user)

Returns the number of user failures for the given action and user.

isBlocked

boolean isBlocked(java.lang.String remoteAddress)

Returns whether the given remote address is blocked

recordAndBlockUserIfMaxReached

boolean recordAndBlockUserIfMaxReached(org.cyclos.impl.access.FailedAction action,
                                       BasicUser user,
                                       java.lang.Integer max,
                                       UserAlertType alertType)

Records an action failure, blocks the user (if null use the logged user) if the max has been reached and generates an user alert. Also returns if the muser was blocked, so callers can already do some logic regarding it.

recordGuestFailure

boolean recordGuestFailure(org.cyclos.impl.access.FailedAction action,
                           java.lang.String remoteAddress,
                           UserLocatorVO locator,
                           java.lang.Integer maxAttempts,
                           TimeInterval blockTime)

Registers a transaction end listener to actually record the action failure. If so, calls the listener in the new transaction, after the current transaction. Also returns if the maximum attempts has been reached in the last hour, so callers can already do some logic regarding it.

recordPasswordFailure

boolean recordPasswordFailure(BasicUser user,
                              PasswordType passwordType,
                              boolean forgot)

Registers a transaction end listener to actually record the password failure, either in normal or forgot password mode. Blocks the password if the maximum was actually reached.

recordPinFailure

boolean recordPinFailure(Pin pin,
                         java.lang.Integer maxAttempts,
                         java.lang.Runnable onMaxReached)

Registers a transaction end listener to actually record the pin failure. If so, calls the onMaxReached in the new transaction, after the current transaction. Also returns if the maximum attempts has been reached, so callers can already do some logic regarding it.

recordUserFailure

boolean recordUserFailure(org.cyclos.impl.access.FailedAction action,
                          BasicUser user,
                          java.lang.Integer maxAttempts,
                          java.lang.Runnable onMaxReached)

Registers a transaction end listener to actually record the user action failure. If so, calls the onMaxReached in the new transaction, after the current transaction. Also returns if the maximum attempts has been reached, so callers can already do some logic regarding it.