org.ow2.proactive.authentication

Class AuthenticationImpl

java.lang.Object

org.ow2.proactive.authentication.AuthenticationImpl

All Implemented Interfaces:

Serializable, org.objectweb.proactive.Active, org.objectweb.proactive.RunActive, Authentication, Loggable

Direct Known Subclasses:

RMAuthenticationImpl

public abstract class AuthenticationImpl
extends Object
implements Authentication, org.objectweb.proactive.RunActive

An active object responsible for authentication.

Since:

ProActive Scheduling 0.9.1

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected String	privateKeyPath Path to the private key file for used for authentication
protected String	publicKeyPath Path to the private key file for used for authentication

Constructor Summary

Constructors

Constructor and Description
AuthenticationImpl() Empty constructor
AuthenticationImpl(String jaasPath, String privPath, String pubPath) Default constructor

Method Summary

Modifier and Type	Method and Description
Subject	authenticate(Credentials cred) Performs login.
protected abstract String	getLoginMethod() Defines login method
byte[]	getPrivateKey() Request this Authentication's private key for credentials encryption
PublicKey	getPublicKey() Request this AuthenticationImpl's public key.
org.objectweb.proactive.core.util.wrapper.BooleanWrapper	isActivated() Checks whether an authentication is activated or in other words is ready to authenticate users.
void	runActivity(org.objectweb.proactive.Body body) Method controls the execution of every request.
void	setActivated(boolean activated) Activates or desactivates authentication active object
boolean	terminate() Terminates the active object

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ow2.proactive.authentication.Authentication

getHostURL, getJMXConnectorURL, getJMXConnectorURL

Methods inherited from interface org.ow2.proactive.authentication.Loggable

getLogger

Field Detail

privateKeyPath

protected String privateKeyPath

Path to the private key file for used for authentication

publicKeyPath

protected String publicKeyPath

Path to the private key file for used for authentication

Constructor Detail

AuthenticationImpl

public AuthenticationImpl()

Empty constructor

AuthenticationImpl

public AuthenticationImpl(String jaasPath,
                          String privPath,
                          String pubPath)

Default constructor

Loads jaas.config and stores it in global system property, also locates keypair used for authentication: public key is used to encrypt credentials to make the old deprecated API still compatible, private key is used to decrypt credentials in the new API.

Parameters:

jaasPath - path to the jaas configuration file

privPath - path to the private key file

pubPath - path to the public key file

Method Detail

getLoginMethod

protected abstract String getLoginMethod()

Defines login method

Returns:

a string which represents the login method.

authenticate

public Subject authenticate(Credentials cred)
                     throws LoginException

Performs login.

Specified by:

authenticate in interface Authentication

Parameters:

cred - encrypted username and password

Returns:

the name of the user logged

Throws:

LoginException - if username or password is incorrect.

getPublicKey

public PublicKey getPublicKey()
                       throws LoginException

Request this AuthenticationImpl's public key.

The public key provided by this method can be used to create encrypted credentials with Credentials.createCredentials(String, String, PublicKey). The private key corresponding to this public key will be used for decryption.

Specified by:

getPublicKey in interface Authentication

Returns:

this AuthenticationImpl's public key

Throws:

LoginException - the key could not be retrieved

getPrivateKey

public byte[] getPrivateKey()
                     throws LoginException

Description copied from interface: Authentication

Request this Authentication's private key for credentials encryption

Specified by:

getPrivateKey in interface Authentication

Returns:

this Authentication's private key

Throws:

LoginException - the key could not be retrieved

isActivated

public org.objectweb.proactive.core.util.wrapper.BooleanWrapper isActivated()

Description copied from interface: Authentication

Checks whether an authentication is activated or in other words is ready to authenticate users.

Specified by:

isActivated in interface Authentication

Returns:

true if it is activated.

See Also:

Authentication.isActivated()

setActivated

public void setActivated(boolean activated)

Activates or desactivates authentication active object

Parameters:

activated - the status of the desired activated state.

terminate

public boolean terminate()

Terminates the active object

Returns:

true if the object has been terminated.

runActivity

public void runActivity(org.objectweb.proactive.Body body)

Method controls the execution of every request. Tries to keep this active object alive in case of any exception.

Specified by:

runActivity in interface org.objectweb.proactive.RunActive