gnu.crypto.sasl.srp
Class SRP

java.lang.Object
  gnu.crypto.sasl.srp.SRP

public final class SRP

extends java.lang.Object

A Factory class that returns SRP Singletons that know all SRP-related mathematical computations and protocol-related operations for both the client- and server-sides.

Version:

$Revision: 1.2 $

Method Summary

byte[]	digest(byte[] src) Convenience method to return the result of digesting the designated input with a new instance of the SRP message digest algorithm.
byte[]	digest(java.lang.String src) Convenience method to return the result of digesting the designated input with a new instance of the SRP message digest algorithm.
byte[]	generateKn(byte[] K, byte[] cn, byte[] sn)
byte[]	generateM1(java.math.BigInteger N, java.math.BigInteger g, java.lang.String U, byte[] s, java.math.BigInteger A, java.math.BigInteger B, byte[] K, java.lang.String I, java.lang.String L)
byte[]	generateM2(java.math.BigInteger A, byte[] M, byte[] K, java.lang.String U, java.lang.String I, java.lang.String o, java.lang.String sid, int ttl, byte[] cIV, byte[] sIV)
java.lang.String	getAlgorithm()
static SRP	instance(java.lang.String mdName) Returns an instance of this object that uses the designated message digest algorithm as its digest function.
IMessageDigest	newDigest() Returns a new instance of the SRP message digest algorithm --which is SHA-160 by default, but could be anything else provided the proper conditions as specified in the SRP specifications.
byte[]	xor(byte[] a, byte[] b) Convenience method to XOR N bytes from two arrays; N being the output size of the SRP message digest algorithm.

Methods inherited from class java.lang.Object

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

Method Detail

instance

public static SRP instance(java.lang.String mdName)

Returns an instance of this object that uses the designated message digest algorithm as its digest function.

Returns:

an instance of this object for the designated digest name.

getAlgorithm

public java.lang.String getAlgorithm()

Returns:

the message digest algorithm name used by this instance.

newDigest

public IMessageDigest newDigest()

Returns a new instance of the SRP message digest algorithm --which is SHA-160 by default, but could be anything else provided the proper conditions as specified in the SRP specifications.

Returns:

a new instance of the underlying SRP message digest algorithm.

Throws:

java.lang.RuntimeException - if the implementation of the message digest algorithm does not support cloning.

digest

public byte[] digest(byte[] src)

Convenience method to return the result of digesting the designated input with a new instance of the SRP message digest algorithm.

Parameters:

src - some bytes to digest.

Returns:

the bytes constituting the result of digesting the designated input with a new instance of the SRP message digest algorithm.

digest

public byte[] digest(java.lang.String src)

Convenience method to return the result of digesting the designated input with a new instance of the SRP message digest algorithm.

Parameters:

src - a String whose bytes (using the default platform encoding) are to be digested.

Returns:

the bytes constituting the result of digesting the designated input with a new instance of the SRP message digest algorithm.

xor

public byte[] xor(byte[] a,
                  byte[] b)

Convenience method to XOR N bytes from two arrays; N being the output size of the SRP message digest algorithm.

Parameters:

a - the first byte array.

b - the second one.

Returns:

N bytes which are the result of the XOR operations on the first N bytes from the designated arrays. N is the size of the SRP message digest algorithm; eg. 20 for SHA-160.

generateM2

public byte[] generateM2(java.math.BigInteger A,
                         byte[] M,
                         byte[] K,
                         java.lang.String U,
                         java.lang.String I,
                         java.lang.String o,
                         java.lang.String sid,
                         int ttl,
                         byte[] cIV,
                         byte[] sIV)

generateM1

public byte[] generateM1(java.math.BigInteger N,
                         java.math.BigInteger g,
                         java.lang.String U,
                         byte[] s,
                         java.math.BigInteger A,
                         java.math.BigInteger B,
                         byte[] K,
                         java.lang.String I,
                         java.lang.String L)

generateKn

public byte[] generateKn(byte[] K,
                         byte[] cn,
                         byte[] sn)