com.entrust.toolkit.security.provider

Class SeedGenerator

java.lang.Object

iaik.security.random.SeedGenerator

com.entrust.toolkit.security.provider.SeedGenerator

Deprecated.

seeding is now handled automatically by Entrust's SecureRandom implementations (random number generators); for access to the PRNGs underlying seeding algorithm call generateSeed() on the SecureRandom instance.

public final class SeedGenerator
extends SeedGenerator

This class offers several methods for random seed generation.

Field Summary

Fields inherited from class iaik.security.random.SeedGenerator

seedGenListener

Constructor Summary

Constructors

Constructor and Description
SeedGenerator() Deprecated. Instantiates a SeedGenerator object.

Method Summary

Methods

Modifier and Type	Method and Description
byte[]	getCurrentTimeSeed() Deprecated. Gets a seed based on the current time.
byte[]	getMemorySeed() Deprecated. Gets a seed based on current free memory and the total memory allocated to the Java Virtual Machine (JVM).
byte[]	getMetaSeed(int bytesNeeded) Deprecated.
byte[]	getSeed() Deprecated. Gets the generated random seed bits.
int[]	getStatus() Deprecated. Gets the current status of seed generation.
byte[]	getStrongSeed(byte[] externalSeed) Deprecated. Gets a cryptographically strong seed based on several different seed sources and on an external seed when available.
byte[]	getTimingSeed(int bitsNeeded) Deprecated. Gets a thread-timing based random number seed.

Methods inherited from class iaik.security.random.SeedGenerator

callSeedGenListener, getDefault, getDefaultSeedGenerator, longToBytes, seedAvailable, setDefault, setDefaultSeedGenerator, setSeedGenListener

Methods inherited from class java.lang.Object

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

Constructor Detail

SeedGenerator

public SeedGenerator()

Deprecated.

Instantiates a SeedGenerator object.

Method Detail

getSeed

public byte[] getSeed()

Deprecated.

Gets the generated random seed bits.

Some seed generators might require a special procedure before getSeed() can be called. If the seed is not yet available this method returns null. If the method is called after the seed has been fetched once, it returns the seed a second time.

Specified by:

getSeed in class SeedGenerator

Returns:

a byte array

getStatus

public int[] getStatus()

Deprecated.

Gets the current status of seed generation.

Returns an array of two integers. The first array indicates how many random bits have already been generated. The secondarray gives the total number of random bits to be generated. By definition, if getStatus()[0] equals getStatus()[1], the seed is ready to be fetched using getSeed().

Specified by:

getStatus in class SeedGenerator

Returns:

an array of two integers

getStrongSeed

public byte[] getStrongSeed(byte[] externalSeed)

Deprecated.

Gets a cryptographically strong seed based on several different seed sources and on an external seed when available.

Parameters:

externalSeed - to be used for creating the strong seed.

Precondition:
Can be null.

Returns:

the cryptographically strong seed.

Postcondition:
Cannot be null.

getMemorySeed

public byte[] getMemorySeed()

Deprecated.

Gets a seed based on current free memory and the total memory allocated to the Java Virtual Machine (JVM).

Returns:

memory seed

Postcondition

Cannot be null

getMetaSeed

public byte[] getMetaSeed(int bytesNeeded)

Deprecated.

getCurrentTimeSeed

public byte[] getCurrentTimeSeed()

Deprecated.

Gets a seed based on the current time.

Returns:

current time seed

Postcondition

Cannot be null

getTimingSeed

public byte[] getTimingSeed(int bitsNeeded)

Deprecated.

Gets a thread-timing based random number seed.

This method returns a random number seed generated by thread-based timing methods alone. It has been proven to work well on a variety of operating systems.

Parameters:

bitsNeeded - the number of bits of entropy required

Returns:

the random number seed