org.acegisecurity.ui

Interface AuthenticationEntryPoint

All Known Implementing Classes:

AuthenticationProcessingFilterEntryPoint, BasicProcessingFilterEntryPoint, CasProcessingFilterEntryPoint, DigestProcessingFilterEntryPoint, X509ProcessingFilterEntryPoint

public interface AuthenticationEntryPoint

Used by ExceptionTranslationFilter to commence an authentication scheme.

Version:

$Id: AuthenticationEntryPoint.java 1784 2007-02-24 21:00:24Z luke_t $

Author:

Ben Alex

Method Summary

Modifier and Type	Method and Description
void	commence(javax.servlet.ServletRequest request, javax.servlet.ServletResponse response, AuthenticationException authException) Commences an authentication scheme.

Method Detail

commence

void commence(javax.servlet.ServletRequest request,
              javax.servlet.ServletResponse response,
              AuthenticationException authException)
       throws IOException,
              javax.servlet.ServletException

Commences an authentication scheme.

SecurityEnforcementFilter will populate the HttpSession attribute named AuthenticationProcessingFilter.ACEGI_SECURITY_TARGET_URL_KEY with the requested target URL before calling this method.

Implementations should modify the headers on the ServletResponse as necessary to commence the authentication process.

Parameters:

request - that resulted in an AuthenticationException

response - so that the user agent can begin authentication

authException - that caused the invocation

Throws:

IOException - DOCUMENT ME!

javax.servlet.ServletException - DOCUMENT ME!