de.intarsys.aaa.authentication

Interface IAuthenticationHandler

All Superinterfaces:

Serializable

public interface IAuthenticationHandler
extends Serializable

The authentication strategy.

The IAuthenticationHandler manages authentication of a subject. After successful authentication with a given ICredential, getSubject returns the currently active authenticated object.

Method Summary

Methods

Modifier and Type	Method and Description
void	authenticate(ICredential credential) Perform the necessary authentication procedure for the given credential.
ICredentialSpec	getCredentialSpec() A description of the ICredential expected by this IAuthenticationHandler upon authenticate.
ISubject	getSubject() The authenticated subject for the active authentication context.
boolean	isAuthenticationRequired() true if the IAuthenticationHandler requires authentication.

Method Detail

authenticate

void authenticate(ICredential credential)
                  throws AuthenticationException

Perform the necessary authentication procedure for the given credential. If successful, establish the subject for the active authentication context.

"credential" may be null to cancel authentication.

Parameters:

credential -

Throws:

AuthenticationException

getCredentialSpec

ICredentialSpec getCredentialSpec()

A description of the ICredential expected by this IAuthenticationHandler upon authenticate.

Returns:

getSubject

ISubject getSubject()

The authenticated subject for the active authentication context.

Returns:

The authenticated subject for the active authentication context.

isAuthenticationRequired

boolean isAuthenticationRequired()

true if the IAuthenticationHandler requires authentication.

Returns: