iaik.security.kdf

Class KDF3ParameterSpec

java.lang.Object

iaik.pkcs.pkcs1.PKCS1AlgorithmParameterSpec

iaik.pkcs.pkcs1.MGF1ParameterSpec

iaik.security.kdf.KDF1ParameterSpec

iaik.security.kdf.KDF2ParameterSpec

iaik.security.kdf.KDF3ParameterSpec

All Implemented Interfaces:

KeyDerivationParameterSpec, java.security.spec.AlgorithmParameterSpec

public class KDF3ParameterSpec
extends KDF2ParameterSpec

Algorithm parameter specification for the KDF3 Key Derivation Function (KDF).

This class holds all information needed for using the KDF3. This includes the used hash algorithm, the desired key length, the secret value, and the additional information. We use this approach, as the KDF3 is implemented using the KeyGenerator class, and and KeyGenerator.generateKey() is not parameterized.

Constructor Summary

Constructors

Constructor and Description
KDF3ParameterSpec(AlgorithmID hashAlgorithm, int keyLength) Creates a new KDF3ParameterSpec for the hash algorithm to be used with KDF3 and the desired key length.
KDF3ParameterSpec(AlgorithmID hashAlgorithm, int keyLength, byte[] secretValue) Creates a new KDF3ParameterSpec for the hash algorithm to be used with KDF3, the desired key length, and the secret value.
KDF3ParameterSpec(AlgorithmID hashAlgorithm, int keyLength, byte[] secretValue, byte[] otherInfo) Creates a new KDF3ParameterSpec for the hash algorithm to be used with KDF3, the desired key length, the secret value, and the additional information.

Method Summary

Modifier and Type	Method and Description
AlgorithmID	getAlgorithmId() Returns the AlgorithmID of the KDF associated with this class.
java.lang.String	getKdf() Returns the name of the KDF associated with this class.

Methods inherited from class iaik.security.kdf.KDF1ParameterSpec

getKeyLength, getOtherInfo, getSecretValue, setKeyLength, setOtherInfo, setSecretValue

Methods inherited from class iaik.pkcs.pkcs1.MGF1ParameterSpec

getHashAlgorithm, getHashEngine, setHashEngine, toString

Methods inherited from class iaik.pkcs.pkcs1.PKCS1AlgorithmParameterSpec

getSecureRandom, setSecureRandom

Methods inherited from class java.lang.Object

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

Constructor Detail

KDF3ParameterSpec

public KDF3ParameterSpec(AlgorithmID hashAlgorithm,
                         int keyLength)

Creates a new KDF3ParameterSpec for the hash algorithm to be used with KDF3 and the desired key length. It is possible to set the secret value and the additional information with KDF1ParameterSpec.setSecretValue(byte[]) and KDF1ParameterSpec.setOtherInfo(byte[]) respectively. At least the secret value is mandatory.

Parameters:

hashAlgorithm - the hash algorithm ID

keyLength - the desired key length

KDF3ParameterSpec

public KDF3ParameterSpec(AlgorithmID hashAlgorithm,
                         int keyLength,
                         byte[] secretValue)

Creates a new KDF3ParameterSpec for the hash algorithm to be used with KDF3, the desired key length, and the secret value. It is possible to set the additional information with KDF1ParameterSpec.setOtherInfo(byte[]).

Parameters:

hashAlgorithm - the hash algorithm ID

keyLength - the desired key length

secretValue - the secret value used for key derivation

KDF3ParameterSpec

public KDF3ParameterSpec(AlgorithmID hashAlgorithm,
                         int keyLength,
                         byte[] secretValue,
                         byte[] otherInfo)

Creates a new KDF3ParameterSpec for the hash algorithm to be used with KDF3, the desired key length, the secret value, and the additional information.

Parameters:

hashAlgorithm - the hash algorithm ID

keyLength - the desired key length

secretValue - the secret value used for key derivation

otherInfo - the additional information for key derivation

Method Detail

getAlgorithmId

public AlgorithmID getAlgorithmId()

Returns the AlgorithmID of the KDF associated with this class.

Specified by:

getAlgorithmId in interface KeyDerivationParameterSpec

Overrides:

getAlgorithmId in class KDF2ParameterSpec

Returns:

The algorithmID of KDF3

getKdf

public java.lang.String getKdf()

Returns the name of the KDF associated with this class.

Specified by:

getKdf in interface KeyDerivationParameterSpec

Overrides:

getKdf in class KDF2ParameterSpec

Returns:

"KDF3"