com.atlassian.crowd.integration.http
Class CrowdHttpAuthenticatorImpl

java.lang.Object
  com.atlassian.crowd.integration.http.CrowdHttpAuthenticatorImpl

All Implemented Interfaces:

CrowdHttpAuthenticator

public class CrowdHttpAuthenticatorImpl
extends java.lang.Object
implements CrowdHttpAuthenticator

Implementation of CrowdHttpAuthenticator.

Constructor Summary

CrowdHttpAuthenticatorImpl(CrowdClient client, ClientProperties clientProperties, CrowdHttpTokenHelper tokenHelper)

Method Summary

User	authenticate(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, java.lang.String username, java.lang.String password) Authenticates the user based on provided credentials.
User	getUser(javax.servlet.http.HttpServletRequest request) Attempts to retrieve the currently authenticated User from the request.
boolean	isAuthenticated(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Tests whether a request is authenticated via SSO.
void	logout(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) Logs out the authenticated user.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CrowdHttpAuthenticatorImpl

public CrowdHttpAuthenticatorImpl(CrowdClient client,
                                  ClientProperties clientProperties,
                                  CrowdHttpTokenHelper tokenHelper)

Method Detail

getUser

public User getUser(javax.servlet.http.HttpServletRequest request)

Description copied from interface: CrowdHttpAuthenticator

Attempts to retrieve the currently authenticated User from the request. This will attempt to find the Crowd SSO token via:

1. a request attribute (not the request parameter), OR
2. a cookie on the request

Specified by:

getUser in interface CrowdHttpAuthenticator

Parameters:

request - HTTP request, possibly containing a Crowd SSO cookie.

Returns:

authenticated User or null if the there is no authenticated user.

authenticate

public User authenticate(javax.servlet.http.HttpServletRequest request,
                         javax.servlet.http.HttpServletResponse response,
                         java.lang.String username,
                         java.lang.String password)
                  throws InvalidAuthenticationException,
                         OperationNotPermittedException,
                         OperationFailedException

Description copied from interface: CrowdHttpAuthenticator

Authenticates the user based on provided credentials.

Validation factors (such as IP address) are extracted from the request.

If the user is successfully authenticated, the Crowd SSO token is placed in:

1. the request: as an attribute, so the user is authenticated for the span of the request.
2. the response: as a cookie, so the user is authenticated for subsequent requests.

If the credentials fail authentication, any existing Crowd SSO token is removed from:

1. the request attribute.
2. the response as a cookie as a cookie with a max-age of 0.

Specified by:

authenticate in interface CrowdHttpAuthenticator

Parameters:

request - request to set the Crowd SSO token

response - response to set the Crowd SSO token cookie

username - username to authenticate

password - password of the user

Returns:

the authenticated user if the authentication was successful, otherwise an exception is thrown.

Throws:

InvalidAuthenticationException - if the application or user authentication was not successful.

OperationNotPermittedException - if the application is not permitted to perform the requested operation on the server.

OperationFailedException - if the operation has failed for an unknown reason

isAuthenticated

public boolean isAuthenticated(javax.servlet.http.HttpServletRequest request,
                               javax.servlet.http.HttpServletResponse response)

Description copied from interface: CrowdHttpAuthenticator

Tests whether a request is authenticated via SSO. This only tests against the Crowd server if the validation interval is exceeded, this value is obtained from crowd.properties AND that there is a valid token present for the user in the Crowd Cookie. The last validated date/time attribute of the request session is updated.

Specified by:

isAuthenticated in interface CrowdHttpAuthenticator

Parameters:

request - HttpServletRequest

response - HttpServletResponse

Returns:

true if and only if the request has been authenticated.

logout

public void logout(javax.servlet.http.HttpServletRequest request,
                   javax.servlet.http.HttpServletResponse response)

Description copied from interface: CrowdHttpAuthenticator

Logs out the authenticated user. Removes the cookie from the response and request attribute. Invalidates the token on the server.

Specified by:

logout in interface CrowdHttpAuthenticator

Parameters:

request - request contains the Crowd SSO token to invalidate and hence log the user out.

response - response returns a request to remove the token cookie from the user browser.