org.springframework.security.ui
Interface AuthenticationEntryPoint

All Known Implementing Classes:

AuthenticationProcessingFilterEntryPoint, BasicProcessingFilterEntryPoint, DigestProcessingFilterEntryPoint, NtlmProcessingFilterEntryPoint, PreAuthenticatedProcessingFilterEntryPoint, X509ProcessingFilterEntryPoint

public interface AuthenticationEntryPoint

Used by ExceptionTranslationFilter to commence an authentication scheme.

Version:

$Id$

Author:

Ben Alex

Method Summary

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 java.io.IOException,
                     javax.servlet.ServletException

Commences an authentication scheme.

ExceptionTranslationFilter will populate the HttpSession attribute named AbstractProcessingFilter.SPRING_SECURITY_SAVED_REQUEST_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:

java.io.IOException

javax.servlet.ServletException