Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.acegisecurity.providers.rcp
Class RemoteAuthenticationProvider  view RemoteAuthenticationProvider download RemoteAuthenticationProvider.java

java.lang.Object
  extended byorg.acegisecurity.providers.rcp.RemoteAuthenticationProvider
All Implemented Interfaces:
org.acegisecurity.providers.AuthenticationProvider, org.springframework.beans.factory.InitializingBean

public class RemoteAuthenticationProvider
extends java.lang.Object
implements org.acegisecurity.providers.AuthenticationProvider, org.springframework.beans.factory.InitializingBean

Client-side object which queries a RemoteAuthenticationManager to validate an authentication request.

A new Authentication object is created by this class comprising the request Authentication object's principal, credentials and the GrantedAuthority[]s returned by the RemoteAuthenticationManager.

The RemoteAuthenticationManager should not require any special username or password setting on the remoting client proxy factory to execute the call. Instead the entire authentication request must be encapsulated solely within the Authentication request object. In practical terms this means the RemoteAuthenticationManager will not be protected by BASIC or any other HTTP-level authentication.

If authentication fails, a RemoteAuthenticationException will be thrown. This exception should be caught and displayed to the user, enabling them to retry with alternative credentials etc.

Version:
$Id: RemoteAuthenticationProvider.java,v 1.3 2005/11/17 00:55:51 benalex Exp $

Field Summary
private static org.apache.commons.logging.Log logger
           
private  RemoteAuthenticationManager remoteAuthenticationManager
           
 
Constructor Summary
RemoteAuthenticationProvider()
           
 
Method Summary
 void afterPropertiesSet()
          Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
 org.acegisecurity.Authentication authenticate(org.acegisecurity.Authentication authentication)
          Performs authentication with the same contract as AuthenticationManager.authenticate(Authentication)>AuthenticationManager.authenticate(Authentication) 55 .
 RemoteAuthenticationManager getRemoteAuthenticationManager()
           
 void setRemoteAuthenticationManager(RemoteAuthenticationManager remoteAuthenticationManager)
           
 boolean supports(java.lang.Class authentication)
          Returns true if this AuthenticationProvider supports the indicated Authentication object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

logger

private static final org.apache.commons.logging.Log logger

remoteAuthenticationManager

private RemoteAuthenticationManager remoteAuthenticationManager
Constructor Detail

RemoteAuthenticationProvider

public RemoteAuthenticationProvider()
Method Detail

setRemoteAuthenticationManager

public void setRemoteAuthenticationManager(RemoteAuthenticationManager remoteAuthenticationManager)

getRemoteAuthenticationManager

public RemoteAuthenticationManager getRemoteAuthenticationManager()

afterPropertiesSet

public void afterPropertiesSet()
                        throws java.lang.Exception
Description copied from interface: org.springframework.beans.factory.InitializingBean
Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).

This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.

Specified by:
afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

authenticate

public org.acegisecurity.Authentication authenticate(org.acegisecurity.Authentication authentication)
                                              throws org.acegisecurity.AuthenticationException
Description copied from interface: org.acegisecurity.providers.AuthenticationProvider
Performs authentication with the same contract as AuthenticationManager.authenticate(Authentication)>AuthenticationManager.authenticate(Authentication) 55 .

Specified by:
authenticate in interface org.acegisecurity.providers.AuthenticationProvider

supports

public boolean supports(java.lang.Class authentication)
Description copied from interface: org.acegisecurity.providers.AuthenticationProvider
Returns true if this AuthenticationProvider supports the indicated Authentication object.

Returning true does not guarantee an AuthenticationProvider will be able to authenticate the presented instance of the Authentication class. It simply indicates it can support closer evaluation of it. An AuthenticationProvider can still return null from the AuthenticationProvider.authenticate(Authentication)>AuthenticationProvider.authenticate(Authentication) 55 method to indicate another AuthenticationProvider should be tried.

Selection of an AuthenticationProvider capable of performing authentication is conducted at runtime the ProviderManager.

Specified by:
supports in interface org.acegisecurity.providers.AuthenticationProvider