org.jivesoftware.wildfire.net
Class SASLAuthentication

java.lang.Object
  org.jivesoftware.wildfire.net.SASLAuthentication

public class SASLAuthentication
extends Object

SASLAuthentication is responsible for returning the available SASL mechanisms to use and for actually performing the SASL authentication.

The list of available SASL mechanisms is determined by:

1. The type of UserProvider being used since some SASL mechanisms require the server to be able to retrieve user passwords
2. Whether anonymous logins are enabled or not.
3. Whether shared secret authentication is enabled or not.
4. Whether the underlying connection has been secured or not.

Author:

Hao Chen, Gaston Dombiak

Nested Class Summary

static class	SASLAuthentication.ElementType
static class	SASLAuthentication.Status

Field Summary

protected static String

CHARSET The utf-8 charset for decoding and encoding Jabber packet streams.

Constructor Summary

SASLAuthentication()

Method Summary

static void	addSupportedMechanism(String mechanism) Adds a new SASL mechanism to the list of supported SASL mechanisms by the server.
static boolean	authenticateSharedSecret(String digest) Returns true if the supplied digest matches the shared secret value.
static String	getSASLMechanisms(Session session) Returns a string with the valid SASL mechanisms available for the specified session.
static org.dom4j.Element	getSASLMechanismsElement(Session session)
static String	getSharedSecret() Returns the shared secret value, or null if shared secret authentication is disabled.
static Set<String>	getSupportedMechanisms() Returns the list of supported SASL mechanisms by the server.
static SASLAuthentication.Status	handle(Session session, org.dom4j.Element doc) Handles the SASL authentication packet.
static boolean	isSharedSecretAllowed() Returns true if shared secret authentication is enabled.
static void	removeSupportedMechanism(String mechanism) Removes a SASL mechanism from the list of supported SASL mechanisms by the server.
static void	setSharedSecretAllowed(boolean sharedSecretAllowed) Sets whether shared secret authentication is enabled.

Methods inherited from class java.lang.Object

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

Field Detail

CHARSET

protected static String CHARSET

The utf-8 charset for decoding and encoding Jabber packet streams.

Constructor Detail

SASLAuthentication

public SASLAuthentication()

Method Detail

getSASLMechanisms

public static String getSASLMechanisms(Session session)

Returns a string with the valid SASL mechanisms available for the specified session. If the session's connection is not secured then only include the SASL mechanisms that don't require TLS.

Returns:

a string with the valid SASL mechanisms available for the specified session.

getSASLMechanismsElement

public static org.dom4j.Element getSASLMechanismsElement(Session session)

handle

public static SASLAuthentication.Status handle(Session session,
                                               org.dom4j.Element doc)
                                        throws UnsupportedEncodingException

Handles the SASL authentication packet. The entity may be sending an initial authentication request or a response to a challenge made by the server. The returned value indicates whether the authentication has finished either successfully or not or if the entity is expected to send a response to a challenge.

Parameters:

session - the session that is authenticating with the server.

doc - the stanza sent by the authenticating entity.

Returns:

value that indicates whether the authentication has finished either successfully or not or if the entity is expected to send a response to a challenge.

Throws:

UnsupportedEncodingException - If UTF-8 charset is not supported.

isSharedSecretAllowed

public static boolean isSharedSecretAllowed()

Returns true if shared secret authentication is enabled. Shared secret authentication creates an anonymous session, but requires that the authenticating entity know a shared secret key. The client sends a digest of the secret key, which is compared against a digest of the local shared key.

Returns:

true if shared secret authentication is enabled.

setSharedSecretAllowed

public static void setSharedSecretAllowed(boolean sharedSecretAllowed)

Sets whether shared secret authentication is enabled. Shared secret authentication creates an anonymous session, but requires that the authenticating entity know a shared secret key. The client sends a digest of the secret key, which is compared against a digest of the local shared key.

Parameters:

sharedSecretAllowed - true if shared secret authentication should be enabled.

getSharedSecret

public static String getSharedSecret()

Returns the shared secret value, or null if shared secret authentication is disabled. If this is the first time the shared secret value has been requested (and shared secret auth is enabled), the key will be randomly generated and stored in the property xmpp.auth.sharedSecret.

Returns:

the shared secret value.

authenticateSharedSecret

public static boolean authenticateSharedSecret(String digest)

Returns true if the supplied digest matches the shared secret value. The digest must be an MD5 hash of the secret key, encoded as hex. This value is supplied by clients attempting shared secret authentication.

Parameters:

digest - the MD5 hash of the secret key, encoded as hex.

Returns:

true if authentication succeeds.

addSupportedMechanism

public static void addSupportedMechanism(String mechanism)

Adds a new SASL mechanism to the list of supported SASL mechanisms by the server. The new mechanism will be offered to clients and connection managers as stream features.

Note: this method simply registers the SASL mechanism to be advertised as a supported mechanism by Wildfire. Actual SASL handling is done by Java itself, so you must add the provider to Java.

Parameters:

mechanism - the new SASL mechanism.

removeSupportedMechanism

public static void removeSupportedMechanism(String mechanism)

Removes a SASL mechanism from the list of supported SASL mechanisms by the server.

Parameters:

mechanism - the SASL mechanism to remove.

getSupportedMechanisms

public static Set<String> getSupportedMechanisms()

Returns the list of supported SASL mechanisms by the server. Note that Java may have support for more mechanisms but some of them may not be returned since a special setup is required that might be missing. Use addSupportedMechanism(String) to add new SASL mechanisms.

Returns:

the list of supported SASL mechanisms by the server.