org.jboss.sasl.callback

Class DigestHashCallback

java.lang.Object

org.jboss.sasl.callback.DigestHashCallback

All Implemented Interfaces:

javax.security.auth.callback.Callback

public class DigestHashCallback
extends java.lang.Object
implements javax.security.auth.callback.Callback

Callback to allow Digest mechanisms to request the pre-digested {username : realm : password} value instead of the plain text password.

The benefit of this callback is that the server no longer needs to store the raw plain text password of the user.

This Callback has accessor methods for both the raw byte[] of the hash and the hex encoded String of the hash, however only one format of the hash should actually be set - the Callback will convert to the other format should the get method be called.

Field Summary

Fields

Modifier and Type	Field and Description
private byte[]	hash
private java.lang.String	hexHash
private java.lang.String	prompt

Constructor Summary

Constructors

Constructor and Description
DigestHashCallback(java.lang.String prompt) Construct the DigestHashCallback with the supplied prompt.

Method Summary

Modifier and Type	Method and Description
byte[]	getHash() Get the hash that has been set on this Callback.
java.lang.String	getHexHash() Get the hex encoded form of the hash set on this Callback.
void	setHash(byte[] hash) Sets the raw byte[] hash.
void	setHexHash(java.lang.String hexHash) Sets the hex encoded form of a hash.

Methods inherited from class java.lang.Object

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

Field Detail

prompt

private final java.lang.String prompt

hexHash

private java.lang.String hexHash

hash

private byte[] hash

Constructor Detail

DigestHashCallback

public DigestHashCallback(java.lang.String prompt)

Construct the DigestHashCallback with the supplied prompt.

Parameters:

prompt - - the prompt.

Method Detail

getHash

public byte[] getHash()

Get the hash that has been set on this Callback.

If a Hex encoded hash has been it will be converted to the raw byte[] representation.

Returns:

the raw byte[] of the hash or null if no hash has been set.

getHexHash

public java.lang.String getHexHash()

Get the hex encoded form of the hash set on this Callback.

If a raw hash has been set it will be hex encoded before being returned.

Returns:

the hex encoded hash or null if no hash has been set.

setHash

public void setHash(byte[] hash)

Sets the raw byte[] hash.

If a hex encoded hash has been set it will be cleared.

Parameters:

hash - - the raw byte[] hash.

setHexHash

public void setHexHash(java.lang.String hexHash)

Sets the hex encoded form of a hash.

If a raw hash has been set it will be cleared.

Parameters:

hexHash - - the hex encoded hash.