com.safenetinc.luna.provider

Class LunaRandom

java.lang.Object

java.security.SecureRandomSpi

com.safenetinc.luna.provider.LunaRandom

All Implemented Interfaces:

java.io.Serializable

public class LunaRandom
extends java.security.SecureRandomSpi

The LunaProvider SecureRandom engine class. Random numbers provided by this engine are generated in the Luna HSM. If the engine is initialized without a seed, self-seeding is done in hardware.

If the user is logged in to an HSM, the RNG operations will occur on the default slot as returned by LunaSlotManager.getDefaultSlot().

If the user is not logged in, PKCS still allows RNG operations to occur. Since SecureRandom does not have a method to specify a slot, in this case the RNG operations will occur on the first slot on the system (in numerical order) that has a token present. If there are no Luna tokens present this class will throw an exception.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
LunaRandom()

Method Summary

Methods

Modifier and Type	Method and Description
protected byte[]	engineGenerateSeed(int numBytes) Returns the given number of seed bytes.
protected void	engineNextBytes(byte[] buffer) Retrieve a user-specified number of random bytes from the Luna HSM's random number generator.
protected void	engineSetSeed(byte[] seed) Re-seed the hardware RNG with the given seed.

Methods inherited from class java.lang.Object

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

Constructor Detail

LunaRandom

public LunaRandom()

Method Detail

engineSetSeed

protected void engineSetSeed(byte[] seed)

Re-seed the hardware RNG with the given seed.

Specified by:

engineSetSeed in class java.security.SecureRandomSpi

Parameters:

seed - The seed

Throws:

LunaException - if there are no tokens present on the system

engineNextBytes

protected void engineNextBytes(byte[] buffer)

Retrieve a user-specified number of random bytes from the Luna HSM's random number generator.

Specified by:

engineNextBytes in class java.security.SecureRandomSpi

Parameters:

buffer - The buffer to fill with random data

Throws:

LunaException - if there are no tokens present on the system

engineGenerateSeed

protected byte[] engineGenerateSeed(int numBytes)

Returns the given number of seed bytes.

Specified by:

engineGenerateSeed in class java.security.SecureRandomSpi

Parameters:

numBytes - The number of seed bytes to generate

Returns:

The seed bytes