oracle.security.crypto.core

Class SymmetricKeyGenerator

java.lang.Object

oracle.security.crypto.core.SymmetricKeyGenerator

public class SymmetricKeyGenerator
extends java.lang.Object

A class for randomly generating symmetric keys.

Note: DES and Triple-DES (DES-EDE) keys are generated with odd parity. Parity may also be set and tested using the methods CryptoUtils.setKeyParity(oracle.security.crypto.core.SymmetricKey, int) and CryptoUtils.checkKeyParity(oracle.security.crypto.core.SymmetricKey, int).

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	AES128_DEFAULT_LENGTH Default key length for AES128 (16 bytes).
protected static int	AES192_DEFAULT_LENGTH Default key length for AES192 (24 bytes).
protected static int	AES256_DEFAULT_LENGTH Default key length for AES256 (32 bytes).
protected AlgorithmIdentifier	algID
protected static int	ARCFOUR_DEFAULT_LENGTH Default key length for ARCFOUR (16 bytes).
protected static int	BLOWFISH_DEFAULT_LENGTH Default key length for BLOWFISH (56 bytes).
protected static int	DES_DEFAULT_LENGTH Default key length for DES (8 bytes).
protected static int	DES_EDE3_DEFAULT_LENGTH Default key length for DES_EDE3 (24 bytes).
protected static int	RC2_DEFAULT_LENGTH Default key length for RC2 (16 bytes).

Constructor Summary

Constructors

Constructor and Description
SymmetricKeyGenerator() Empty constructor.

Method Summary

Methods

Modifier and Type	Method and Description
SymmetricKey	generateKey() Generate a new random symmetric key using the default RandomBitsSource and the length set by the algorithm identifier parameters or the default for the algorithm.
SymmetricKey	generateKey(int length) Generate a new random symmetric key using the default RandomBitsSource and the given length.
SymmetricKey	generateKey(RandomBitsSource rbs) Generate a new random symmetric key of the length set by the algorithm identifier parameters, or the default for the algorithm.
SymmetricKey	generateKey(RandomBitsSource rbs, int length) Generate a new random symmetric key using the given RandomBitsSource and length.
AlgorithmIdentifier	getAlgID() Returns the AlgorithmIdentifier of this SymmetricKeyGenerator.
static SymmetricKeyGenerator	getInstance(AlgorithmIdentifier algID) Create a new SymmetricKeyGenerator for the given algorithm.
void	setAlgID(AlgorithmIdentifier algID) Set the algorithm identifier for the symmetric key algorithm.

Methods inherited from class java.lang.Object

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

Field Detail

AES128_DEFAULT_LENGTH

protected static final int AES128_DEFAULT_LENGTH

Default key length for AES128 (16 bytes).

See Also:

Constant Field Values

AES192_DEFAULT_LENGTH

protected static final int AES192_DEFAULT_LENGTH

Default key length for AES192 (24 bytes).

See Also:

Constant Field Values

AES256_DEFAULT_LENGTH

protected static final int AES256_DEFAULT_LENGTH

Default key length for AES256 (32 bytes).

See Also:

Constant Field Values

BLOWFISH_DEFAULT_LENGTH

protected static final int BLOWFISH_DEFAULT_LENGTH

Default key length for BLOWFISH (56 bytes).

See Also:

Constant Field Values

DES_DEFAULT_LENGTH

protected static final int DES_DEFAULT_LENGTH

Default key length for DES (8 bytes).

See Also:

Constant Field Values

DES_EDE3_DEFAULT_LENGTH

protected static final int DES_EDE3_DEFAULT_LENGTH

Default key length for DES_EDE3 (24 bytes).

See Also:

Constant Field Values

ARCFOUR_DEFAULT_LENGTH

protected static final int ARCFOUR_DEFAULT_LENGTH

Default key length for ARCFOUR (16 bytes).

See Also:

Constant Field Values

RC2_DEFAULT_LENGTH

protected static final int RC2_DEFAULT_LENGTH

Default key length for RC2 (16 bytes).

See Also:

Constant Field Values

algID

protected AlgorithmIdentifier algID

Constructor Detail

SymmetricKeyGenerator

public SymmetricKeyGenerator()

Empty constructor.

Method Detail

getInstance

public static SymmetricKeyGenerator getInstance(AlgorithmIdentifier algID)
                                         throws java.lang.IllegalArgumentException

Create a new SymmetricKeyGenerator for the given algorithm.

Throws:

java.lang.IllegalArgumentException

setAlgID

public void setAlgID(AlgorithmIdentifier algID)
              throws AlgorithmIdentifierException

Set the algorithm identifier for the symmetric key algorithm.

Throws:

AlgorithmIdentifierException

See Also:

AlgorithmIdentifier, CBCAlgorithmIdentifier, RC2AlgorithmIdentifier

getAlgID

public AlgorithmIdentifier getAlgID()

Returns the AlgorithmIdentifier of this SymmetricKeyGenerator.

generateKey

public SymmetricKey generateKey(RandomBitsSource rbs,
                       int length)

Generate a new random symmetric key using the given RandomBitsSource and length.

Parameters:

rbs - The source of randomness used to generate the key material.

length - The length, in bytes, of the key to be generated.

generateKey

public SymmetricKey generateKey(RandomBitsSource rbs)

Generate a new random symmetric key of the length set by the algorithm identifier parameters, or the default for the algorithm.

Parameters:

rbs - The source of randomness used to generate the key material.

generateKey

public SymmetricKey generateKey(int length)

Generate a new random symmetric key using the default RandomBitsSource and the given length.

Parameters:

length - The length, in bytes, of the key to be generated.

generateKey

public SymmetricKey generateKey()

Generate a new random symmetric key using the default RandomBitsSource and the length set by the algorithm identifier parameters or the default for the algorithm.