org.apache.sling.auth.core.spi
Interface AuthenticationFeedbackHandler

All Known Implementing Classes:
AbstractAuthenticationHandler, DefaultAuthenticationFeedbackHandler, SelectorAuthenticationHandler

public interface AuthenticationFeedbackHandler

The AuthenticationFeedbackHandler may be implemented by AuthenticationHandler services to request being informed on the success or failure of authentication.


Method Summary
 void authenticationFailed(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, AuthenticationInfo authInfo)
          Called if authentication failed with the credentials provided in the authInfo map.
 boolean authenticationSucceeded(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, AuthenticationInfo authInfo)
          Called if authentication succeeded with the credentials provided in the authInfo map.
 

Method Detail

authenticationFailed

void authenticationFailed(javax.servlet.http.HttpServletRequest request,
                          javax.servlet.http.HttpServletResponse response,
                          AuthenticationInfo authInfo)
Called if authentication failed with the credentials provided in the authInfo map.

This method allows the handler to cleanup any state prepared while handling the extractCredentials method. Handlers are expected to not send a in this method because the Sling Authenticator will proceed to select an authentication handler whose requestCredentials method will be called.

Implementations may also wish to set the AuthenticationHandler.FAILURE_REASON request attribute to inform interested parties (including its any AuthenticationHandler.requestCredentials(HttpServletRequest, HttpServletResponse) method about the reasons of failure to to authenticate.

Parameters:
request - The current request
response - The current response
authInfo - The AuthenticationInfo object used to authenticate the request.

authenticationSucceeded

boolean authenticationSucceeded(javax.servlet.http.HttpServletRequest request,
                                javax.servlet.http.HttpServletResponse response,
                                AuthenticationInfo authInfo)
Called if authentication succeeded with the credentials provided in the authInfo map.

This method is called after successful login and impersonation handling immediately before continuing with the request. The handler may choose to send its own response or to just set some response header (e.g. adding a Cookie) and return appropriately.

Parameters:
request - The current request
response - The current response
authInfo - The AuthenticationInfo object used to authenticate the request.
Returns:
true if the handler sent back a response to the client and request processing should be terminated at this point. If false is returned, the request proceeds as authenticated.


Copyright © 2007-2011 The Apache Software Foundation. All Rights Reserved.