iaik.security.random

Class SecRandom

java.lang.Object

java.util.Random

java.security.SecureRandom

iaik.security.random.SecRandom

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

AnsiRandom, X917Random

Deprecated.

since 8.0; use Entrust.getDefaultSecureRandomInstance() instead

public abstract class SecRandom
extends java.security.SecureRandom

The SecRandom class is the base class of all IAIK implemented secure pseudo random number generators (PRNGs). For compatibility with the JDK it is a subclass of java.security.SecureRandom, which in turn extends java.util.Random. Programmers who themselves want to implement a secure PRNG should subclass this class for compatibility and because this class takes care of some of the pecularities of the JDK SecureRandom.

Subclasses just need to implement the abstract engineNextBytes() and engineSetSeed() methods and a no-args constructor. Subclasses should not seed themselves in the constructor, they should wait for the application to call a setSeed() method explicitly with data from an appropriate random source. This class makes sure that engineNextBytes() is never called before a seed has been set, if necessary by calling setSeed() itself with data from the default SeedGenerator.

This class also serves as storage point for the system's default secure PRNG. Applications which want to use a secure PRNG should typically call SecRandom.getDefault() instead of instantiating one particular PRNG directly. This will allow the PRNG used throughout the application to be set by a simple SecRandom.setDefault() call. The initial default PRNG is iaik.security.random.SHA1Random.

Version:

1.1

See Also:

SecureRandom, MessageDigestRandom, SHA1Random, SeedGenerator, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.Object	m_sync Deprecated.
protected boolean	seeded Deprecated. Indicates if the SecRandom object has been assigned a seed.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SecRandom() Deprecated. Constructor for use by subclasses.

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract void	engineNextBytes(byte[] bytes) Deprecated. Return the next bytes.length random bytes.
protected abstract void	engineSetSeed(byte[] seed) Deprecated. Set the seed to be used for random number generation.
static java.security.SecureRandom	getDefault() Deprecated. Return a new instance of the default random number generator.
void	nextBytes(byte[] bytes) Deprecated. Return the next bytes.length random bytes.
static void	setDefault(java.lang.Class clazz) Deprecated. Set the default random number generator.
void	setSeed() Deprecated. Set the seed to the next seed generated by the current default seed generator.
void	setSeed(byte[] seed) Deprecated. Set the seed to be used for random number generation.
void	setSeed(long seed) Deprecated. Set the seed to the given long int.

Methods inherited from class java.security.SecureRandom

generateSeed, getAlgorithm, getInstance, getInstance, getInstance, getProvider, getSeed, next

Methods inherited from class java.util.Random

nextBoolean, nextDouble, nextFloat, nextGaussian, nextInt, nextInt, nextLong

Methods inherited from class java.lang.Object

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

Field Detail

m_sync

protected static java.lang.Object m_sync

Deprecated.

seeded

protected boolean seeded

Deprecated.

Indicates if the SecRandom object has been assigned a seed.

Since:

Entrust 7.0

Constructor Detail

SecRandom

protected SecRandom()

Deprecated.

Constructor for use by subclasses. It does not do anything except call the SecureRandom superclass constructor.

Method Detail

getDefault

public static final java.security.SecureRandom getDefault()

Deprecated.

Return a new instance of the default random number generator. It will not be assigned a seed (see also nextBytes()). Calling getDefault() is the recommended way of obtaining a PRNG.

setDefault

public static final void setDefault(java.lang.Class clazz)
                             throws RandomException

Deprecated.

Set the default random number generator. Instances of this PRNG will be returned by subsequent calls of getDefault(). The PRNG must have a no-args constructor accessible to this class.

Throws:

java.lang.IllegalArgumentException - if there was an error with the SecureRandom

RandomException

nextBytes

public final void nextBytes(byte[] bytes)

Deprecated.

Return the next bytes.length random bytes. If the SecRandom has not been seeded before, setSeed() will be called. This methods calls engineNextBytes().

Overrides:

nextBytes in class java.security.SecureRandom

setSeed

public final void setSeed(byte[] seed)

Deprecated.

Set the seed to be used for random number generation. This methods calls engineSetSeed().

Overrides:

setSeed in class java.security.SecureRandom

setSeed

public final void setSeed(long seed)

Deprecated.

Set the seed to the given long int. This method converts the long to a byte array (two's complement, MSB first) and calls setSeed(byte[]). This method is included mainly for compatibility, a 64 bit seed will generally be too short for cryptographic applications and should not be used.

Overrides:

setSeed in class java.security.SecureRandom

setSeed

public final void setSeed()

Deprecated.

Set the seed to the next seed generated by the current default seed generator. That means, calling this method is equivalent to calling setSeed(SeedGenerator.getDefault().getSeed());.

engineNextBytes

protected abstract void engineNextBytes(byte[] bytes)

Deprecated.

Return the next bytes.length random bytes. This methods has to be implemented by subclasses.

engineSetSeed

protected abstract void engineSetSeed(byte[] seed)

Deprecated.

Set the seed to be used for random number generation. This methods has to be implemented by subclasses.