org.jasig.cas.authentication.handler
Interface AuthenticationHandler

All Known Subinterfaces:

NamedAuthenticationHandler

All Known Implementing Classes:

AbstractPreAndPostProcessingAuthenticationHandler, AbstractUsernamePasswordAuthenticationHandler, HttpBasedServiceCredentialsAuthenticationHandler, JaasAuthenticationHandler, SimpleTestUsernamePasswordAuthenticationHandler

public interface AuthenticationHandler

Validate Credentials support for AuthenticationManagerImpl.

Determines that Credentials are valid. Password-based credentials may be tested against an external LDAP, Kerberos, JDBC source. Certificates may be checked against a list of CA's and do the usual chain validation. Implementations must be parameterized with their sources of information.

Callers to this class should first call supports to determine if the AuthenticationHandler can authenticate the credentials provided.

Since:

3.0

This is a published and supported CAS Server 3 API.

Version:

$Revision: 42053 $ $Date: 2007-06-10 09:17:55 -0400 (Sun, 10 Jun 2007) $

Author:

Scott Battaglia

Method Summary

boolean	authenticate(Credentials credentials) Method to determine if the credentials supplied are valid.
boolean	supports(Credentials credentials) Method to check if the handler knows how to handle the credentials provided.

Method Detail

authenticate

boolean authenticate(Credentials credentials)
                     throws AuthenticationException

Method to determine if the credentials supplied are valid.

Parameters:

credentials - The credentials to validate.

Returns:

true if valid, return false otherwise.

Throws:

AuthenticationException - An AuthenticationException can contain details about why a particular authentication request failed.

supports

boolean supports(Credentials credentials)

Method to check if the handler knows how to handle the credentials provided. It may be a simple check of the Credentials class or something more complicated such as scanning the information contained in the Credentials object.

Parameters:

credentials - The credentials to check.

Returns:

true if the handler supports the Credentials, false othewrise.