iaik.security.dh

Class ESDHParameterSpec

java.lang.Object

javax.crypto.spec.DHParameterSpec

iaik.security.dh.ESDHParameterSpec

All Implemented Interfaces:

java.security.spec.AlgorithmParameterSpec

public class ESDHParameterSpec
extends javax.crypto.spec.DHParameterSpec

Diffie Hellman parameter specification.

Attention: This is not a SUN implementation!

This class has been developed by IAIK according to the documentation publically available.
For SUN's documentation of this class see http://java.sun.com/security/JCE1.2/spec/apidoc/index.html

The Diffie Hellman algorithm has been the first public-key algorithm. It only can be used for key-agreement, but not for data encrypting and decrypting.

PKCS#3 describes a method for implementing the Diffie Hellman key agreement where two (or more) entities use general Diffie Hellman parameters (an odd prime p, an integer base g satisfying 0 < g < p, and optionally an integer l prescribing the length of the private value), generated from some central authority (which may an entity itself), for creating a shared secret only known by them.

This class represents a specification for the prime modulus (p), base ganerator (g) and exponent length (l) parameters, as used by the Diffie-Hellman key exchange algorithm according to PKCS#3 (Diffie-Hellman Key Agreement Standard).

See Also:

AlgorithmParameterSpec

Constructor Summary

Constructors

Constructor and Description
ESDHParameterSpec(java.math.BigInteger p, java.math.BigInteger g, java.math.BigInteger q) Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g and prime factor q.
ESDHParameterSpec(java.math.BigInteger p, java.math.BigInteger g, java.math.BigInteger q, java.math.BigInteger j) Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g, prime factor q and soubgroup factor j.
ESDHParameterSpec(java.math.BigInteger p, java.math.BigInteger g, java.math.BigInteger q, java.math.BigInteger j, byte[] seed, int pgenCounter) Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g, prime factor q, soubgroup factor j, the seed and counter used in the system parameter generation process.
ESDHParameterSpec(java.math.BigInteger p, java.math.BigInteger g, java.math.BigInteger q, byte[] seed, int pgenCounter) Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g, prime factor q, the seed and counter used in the system parameter generation process.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
java.math.BigInteger	getJ() Returns the subgroup factor j.
int	getL() This method overrides the method of the super class and always returns 0 since we don't use parameter L in ESDH.
int	getPGenCounter() Returns the counter used in the system parameter generation process.
java.math.BigInteger	getQ() Returns the prime factor q.
byte[]	getSeed() Returns the seed used in the system parameter generation process.
java.lang.String	toString() Returns a string representation of this Object.

Methods inherited from class javax.crypto.spec.DHParameterSpec

getG, getP

Methods inherited from class java.lang.Object

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

Constructor Detail

ESDHParameterSpec

public ESDHParameterSpec(java.math.BigInteger p,
                         java.math.BigInteger g,
                         java.math.BigInteger q)

Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g and prime factor q.

Parameters:

p - the prime modulus

g - the base generator

q - the prime factor

ESDHParameterSpec

public ESDHParameterSpec(java.math.BigInteger p,
                         java.math.BigInteger g,
                         java.math.BigInteger q,
                         java.math.BigInteger j)

Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g, prime factor q and soubgroup factor j.

Parameters:

p - the prime modulus

g - the base generator

q - the prime factor

j - the subgroup factor

ESDHParameterSpec

public ESDHParameterSpec(java.math.BigInteger p,
                         java.math.BigInteger g,
                         java.math.BigInteger q,
                         byte[] seed,
                         int pgenCounter)

Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g, prime factor q, the seed and counter used in the system parameter generation process.

Parameters:

p - the prime modulus

g - the base generator

q - the prime factor

seed - the the seed used in the system parameter generation process

pgenCounter - the counter used in the system parameter generation process

ESDHParameterSpec

public ESDHParameterSpec(java.math.BigInteger p,
                         java.math.BigInteger g,
                         java.math.BigInteger q,
                         java.math.BigInteger j,
                         byte[] seed,
                         int pgenCounter)

Creates a Diffie-Hellman parameter specification, based on given prime modulus p, base generator g, prime factor q, soubgroup factor j, the seed and counter used in the system parameter generation process.

Parameters:

p - the prime modulus

g - the base generator

q - the prime factor

j - the subgroup factor

seed - the the seed used in the system parameter generation process

pgenCounter - the counter used in the system parameter generation process

Method Detail

getQ

public java.math.BigInteger getQ()

Returns the prime factor q.

Returns:

the prime factor q

getJ

public java.math.BigInteger getJ()

Returns the subgroup factor j.

Returns:

the subgroup factor j

getSeed

public byte[] getSeed()

Returns the seed used in the system parameter generation process.

Returns:

the seed used in the system parameter generation process

getPGenCounter

public int getPGenCounter()

Returns the counter used in the system parameter generation process.

Returns:

the counter used in the system parameter generation process

getL

public int getL()

This method overrides the method of the super class and always returns 0 since we don't use parameter L in ESDH.

Overrides:

getL in class javax.crypto.spec.DHParameterSpec

Returns:

0 is returned

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Returns a string representation of this Object.

Overrides:

toString in class java.lang.Object

Returns:

a string representation