org.jboss.sasl.util

Class AbstractSaslClient

java.lang.Object

org.jboss.sasl.util.AbstractSaslParticipant

org.jboss.sasl.util.AbstractSaslClient

All Implemented Interfaces:

javax.security.sasl.SaslClient

Direct Known Subclasses:

AnonymousSaslClient, LocalUserClient

public abstract class AbstractSaslClient
extends AbstractSaslParticipant
implements javax.security.sasl.SaslClient

A base class for SASL client implementations.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	authorizationId
private boolean	hasInitialResponse

Fields inherited from class org.jboss.sasl.util.AbstractSaslParticipant

NO_BYTES

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractSaslClient(java.lang.String mechanismName, java.lang.String protocol, java.lang.String serverName, javax.security.auth.callback.CallbackHandler callbackHandler, java.lang.String authorizationId, boolean hasInitialResponse) Construct a new instance.

Method Summary

Modifier and Type	Method and Description
byte[]	evaluateChallenge(byte[] challenge) Evaluate an authentication challenge received from the server.
protected java.lang.String	getAuthorizationId() Get the specified authorization ID.
boolean	hasInitialResponse() Determines whether this mechanism has an optional initial response.

Methods inherited from class org.jboss.sasl.util.AbstractSaslParticipant

dispose, evaluateMessage, getCallbackHandler, getContext, getMechanismName, getNegotiatedProperty, getProtocol, getServerName, getWrapper, handleCallbacks, init, isComplete, setWrapper, tryHandleCallbacks, unwrap, wrap

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.security.sasl.SaslClient

dispose, getMechanismName, getNegotiatedProperty, isComplete, unwrap, wrap

Field Detail

authorizationId

private final java.lang.String authorizationId

hasInitialResponse

private final boolean hasInitialResponse

Constructor Detail

AbstractSaslClient

protected AbstractSaslClient(java.lang.String mechanismName,
                             java.lang.String protocol,
                             java.lang.String serverName,
                             javax.security.auth.callback.CallbackHandler callbackHandler,
                             java.lang.String authorizationId,
                             boolean hasInitialResponse)

Construct a new instance.

Parameters:

mechanismName - the SASL mechanism name

protocol - the protocol

serverName - the server name

callbackHandler - the callback handler to use for authentication

authorizationId - the possibly null protocol-dependent name used for authorization

hasInitialResponse - true if the mechanism supports an initial response, false otherwise

Method Detail

evaluateChallenge

public byte[] evaluateChallenge(byte[] challenge)
                         throws javax.security.sasl.SaslException

Evaluate an authentication challenge received from the server.

Specified by:

evaluateChallenge in interface javax.security.sasl.SaslClient

Parameters:

challenge - the authentication challenge

Returns:

the response to send to the server

Throws:

javax.security.sasl.SaslException - if there is an error processing the server message

hasInitialResponse

public boolean hasInitialResponse()

Determines whether this mechanism has an optional initial response. If true, caller should call evaluateChallenge(byte[]) with an empty array to get the initial response.

Specified by:

hasInitialResponse in interface javax.security.sasl.SaslClient

Returns:

true if this mechanism has an initial response

getAuthorizationId

protected java.lang.String getAuthorizationId()

Get the specified authorization ID.

Returns:

the authorization ID