com.sun.identity.authentication.spi
Interface AMAuthCallBack

public interface AMAuthCallBack

The AMAuthCallBack interface should be implemented by external business logic code, in order to receive callbacks from the authentication framework when one of the following events happens :

• account lockout
• password change (via LDAP module)

The event type and related information are passed through the method call authEventCallback. The event parameters are stored in a hashmap. See information about public static fields for more details.

A plug-in class, which implements this interface, can retrieve the event parameters using the get() function of the Map interface : eventParams.get(TIME_KEY); eventParams.get(USER_KEY); etc.

Field Summary

static int	ACCOUNT_LOCKOUT The constant for the event type ACCOUNT LOCKOUT.
static int	PASSWORD_CHANGE The constant for the event type PASSWORD CHANGE.
static java.lang.String	REALM_KEY The key for the value of the module's realm, for which the callback was triggered.
static java.lang.String	TIME_KEY The key for the value of the callback notification time (i.e.
static java.lang.String	USER_KEY The key for the value of the user's identity for which the callback was triggered.

Method Summary

void	authEventCallback(int eventType, java.util.Map eventParams) Receives the event notifications when the user status changes during the authentication process.

Field Detail

TIME_KEY

public static final java.lang.String TIME_KEY

The key for the value of the callback notification time (i.e. when the event occured).

REALM_KEY

public static final java.lang.String REALM_KEY

The key for the value of the module's realm, for which the callback was triggered.

USER_KEY

public static final java.lang.String USER_KEY

The key for the value of the user's identity for which the callback was triggered.

PASSWORD_CHANGE

public static final int PASSWORD_CHANGE

The constant for the event type PASSWORD CHANGE.

ACCOUNT_LOCKOUT

public static final int ACCOUNT_LOCKOUT

The constant for the event type ACCOUNT LOCKOUT.

Method Detail

authEventCallback

public void authEventCallback(int eventType,
                              java.util.Map eventParams)
                       throws AMAuthCallBackException

Receives the event notifications when the user status changes during the authentication process. It includes the type of event and other information pertinent to this event.

Parameters:

eventType - the type of event for which this method is being called

eventParams - a map of different parameters meaningful for this event.

Throws:

a - AMAuthCallBackException can be thrown back if necessary (currently not supported). It will be ignored by authentication processing classes.