org.jboss.security.client
Class SecurityClient

java.lang.Object
  org.jboss.security.client.SecurityClient

public abstract class SecurityClient
extends Object

Generic Security Client class
Basic Users:

Basic users will just use the methods that set the username and credential

Since:

May 1, 2007

Version:

$Revision$

Author:

Anil.Saldhana@redhat.com

See Also:

#setUserName(String)} and @see {@link #setCredential(Object)}

Intermediate Users:

You can specify usage of JAAS as the framework in the client implementation. In this case, you will @see {@link #setLoginConfigName(String)} and, Advanced Users:

You will use the @see {@link #setSASLMechanism(String)} method

Field Summary

protected CallbackHandler	callbackHandler
protected Object	credential
protected boolean	jaasDesired
protected String	loginConfigName
protected String	saslAuthorizationId
protected boolean	saslDesired
protected String	saslMechanism
protected Object	userPrincipal

Constructor Summary

SecurityClient()

Method Summary

protected abstract void	cleanUp() Provide an opportunity for client implementations to clean up
void	login() Login with the desired method
void	logout() Log Out
protected abstract void	peformSASLLogin()
protected abstract void	performJAASLogin()
protected abstract void	performSimpleLogin()
void	setJAAS(String configName, CallbackHandler cbh) Set the JAAS Login Configuration Name and Call back handler
void	setSASL(String mechanism, String authorizationId, CallbackHandler cbh) Set the mechanism and other parameters for SASL Client
void	setSimple(Object username, Object credential) Set the user name and credential for simple login (non-jaas, non-sasl)

Methods inherited from class java.lang.Object

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

Field Detail

userPrincipal

protected Object userPrincipal

credential

protected Object credential

callbackHandler

protected CallbackHandler callbackHandler

loginConfigName

protected String loginConfigName

saslMechanism

protected String saslMechanism

saslAuthorizationId

protected String saslAuthorizationId

jaasDesired

protected boolean jaasDesired

saslDesired

protected boolean saslDesired

Constructor Detail

SecurityClient

public SecurityClient()

Method Detail

login

public void login()
           throws LoginException

Login with the desired method

Throws:

LoginException

logout

public void logout()

Log Out

setSimple

public void setSimple(Object username,
                      Object credential)

Set the user name and credential for simple login (non-jaas, non-sasl)

Parameters:

username - (Can be null)

credential - (Can be null)

setJAAS

public void setJAAS(String configName,
                    CallbackHandler cbh)

Set the JAAS Login Configuration Name and Call back handler

Parameters:

configName - can be null

cbh - can be null

setSASL

public void setSASL(String mechanism,
                    String authorizationId,
                    CallbackHandler cbh)

Set the mechanism and other parameters for SASL Client

Parameters:

mechanism -

authorizationId -

cbh -

performJAASLogin

protected abstract void performJAASLogin()
                                  throws LoginException

Throws:

LoginException

peformSASLLogin

protected abstract void peformSASLLogin()

performSimpleLogin

protected abstract void performSimpleLogin()

cleanUp

protected abstract void cleanUp()

Provide an opportunity for client implementations to clean up