Modifier and Type	Class and Description
private static class	SP800SecureRandomBuilder.CTRDRBGProvider
private static class	SP800SecureRandomBuilder.HashDRBGProvider
private static class	SP800SecureRandomBuilder.HMacDRBGProvider

Modifier and Type	Field and Description
private int	entropyBitsRequired
private final EntropySourceProvider	entropySourceProvider
private byte[]	personalizationString
private final SecureRandom	random
private int	securityStrength

Constructor Summary

Access	Constructor and Description
public	SP800SecureRandomBuilder() Basic constructor, creates a builder using an EntropySourceProvider based on the default SecureRandom with predictionResistant set to false.
public	SP800SecureRandomBuilder(SecureRandom the SecureRandom acting as a source of entropy for DRBGs made by this builder. entropySource, boolean true if the SecureRandom seeder can be regarded as predictionResistant. predictionResistant) Construct a builder with an EntropySourceProvider based on the passed in SecureRandom and the passed in value for prediction resistance.
public	SP800SecureRandomBuilder(EntropySourceProvider a provider of EntropySource objects. entropySourceProvider) Create a builder which makes creates the SecureRandom objects from a specified entropy source provider.

Method Summary

Modifier and Type	Method and Description
public SP800SecureRandom	Returns: a SecureRandom supported by a CTR DRBG. buildCTR(BlockCipher the block cipher to base the DRBG on. cipher, int key size in bits to be used with the block cipher. keySizeInBits, byte[] nonce value to use in DRBG construction. nonce, boolean specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes. predictionResistant) Build a SecureRandom based on a SP 800-90A CTR DRBG.
public SP800SecureRandom	Returns: a SecureRandom supported by a Hash DRBG. buildHash(Digest digest algorithm to use in the DRBG underneath the SecureRandom. digest, byte[] nonce value to use in DRBG construction. nonce, boolean specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes. predictionResistant) Build a SecureRandom based on a SP 800-90A Hash DRBG.
public SP800SecureRandom	Returns: a SecureRandom supported by a HMAC DRBG. buildHMAC(Mac HMAC algorithm to use in the DRBG underneath the SecureRandom. hMac, byte[] nonce value to use in DRBG construction. nonce, boolean specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes. predictionResistant) Build a SecureRandom based on a SP 800-90A HMAC DRBG.
private static String	getSimplifiedName(Digest digest)
public SP800SecureRandomBuilder	Returns: the current builder. setEntropyBitsRequired(int the number of bits of entropy to be requested from the entropy source on each seed/reseed. entropyBitsRequired) Set the amount of entropy bits required for seeding and reseeding DRBGs used in building SecureRandom objects.
public SP800SecureRandomBuilder	Returns: the current builder. setPersonalizationString(byte[] the personalisation string for the underlying DRBG. personalizationString) Set the personalization string for DRBG SecureRandoms created by this builder
public SP800SecureRandomBuilder	Returns: the current builder. setSecurityStrength(int the security strength (in bits) securityStrength) Set the security strength required for DRBGs used in building SecureRandom objects.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

entropyBitsRequired	back to summary
private int entropyBitsRequired

entropySourceProvider	back to summary
private final EntropySourceProvider entropySourceProvider

personalizationString	back to summary
private byte[] personalizationString

random	back to summary
private final SecureRandom random

securityStrength	back to summary
private int securityStrength

Constructor Detail

SP800SecureRandomBuilder	back to summary
public SP800SecureRandomBuilder() Basic constructor, creates a builder using an EntropySourceProvider based on the default SecureRandom with predictionResistant set to false. Any SecureRandom created from a builder constructed like this will make use of input passed to SecureRandom.setSeed() if the default SecureRandom does for its generateSeed() call.

SP800SecureRandomBuilder

back to summary

public SP800SecureRandomBuilder()

Basic constructor, creates a builder using an EntropySourceProvider based on the default SecureRandom with predictionResistant set to false.

Any SecureRandom created from a builder constructed like this will make use of input passed to SecureRandom.setSeed() if the default SecureRandom does for its generateSeed() call.

SP800SecureRandomBuilder	back to summary
public SP800SecureRandomBuilder(SecureRandom entropySource, boolean predictionResistant) Construct a builder with an EntropySourceProvider based on the passed in SecureRandom and the passed in value for prediction resistance. Any SecureRandom created from a builder constructed like this will make use of input passed to SecureRandom.setSeed() if the passed in SecureRandom does for its generateSeed() call. Parameters entropySource:SecureRandom the SecureRandom acting as a source of entropy for DRBGs made by this builder. predictionResistant:boolean true if the SecureRandom seeder can be regarded as predictionResistant.

SP800SecureRandomBuilder

back to summary

public SP800SecureRandomBuilder(SecureRandom entropySource, boolean predictionResistant)

Construct a builder with an EntropySourceProvider based on the passed in SecureRandom and the passed in value for prediction resistance.

Any SecureRandom created from a builder constructed like this will make use of input passed to SecureRandom.setSeed() if the passed in SecureRandom does for its generateSeed() call.

Parameters

entropySource:SecureRandom: the SecureRandom acting as a source of entropy for DRBGs made by this builder.
predictionResistant:boolean: true if the SecureRandom seeder can be regarded as predictionResistant.

SP800SecureRandomBuilder	back to summary
public SP800SecureRandomBuilder(EntropySourceProvider entropySourceProvider) Create a builder which makes creates the SecureRandom objects from a specified entropy source provider. Note If this constructor is used any calls to setSeed() in the resulting SecureRandom will be ignored. Parameters entropySourceProvider:EntropySourceProvider a provider of EntropySource objects.

SP800SecureRandomBuilder

back to summary

public SP800SecureRandomBuilder(EntropySourceProvider entropySourceProvider)

Create a builder which makes creates the SecureRandom objects from a specified entropy source provider.

Note

If this constructor is used any calls to setSeed() in the resulting SecureRandom will be ignored.

Parameters

entropySourceProvider:EntropySourceProvider: a provider of EntropySource objects.

Method Detail

buildCTR	back to summary
public SP800SecureRandom buildCTR(BlockCipher cipher, int keySizeInBits, byte[] nonce, boolean predictionResistant) Build a SecureRandom based on a SP 800-90A CTR DRBG. Parameters cipher:BlockCipher the block cipher to base the DRBG on. keySizeInBits:int key size in bits to be used with the block cipher. nonce:byte[] nonce value to use in DRBG construction. predictionResistant:boolean specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes. Returns:SP800SecureRandom a SecureRandom supported by a CTR DRBG.

buildCTR

back to summary

public SP800SecureRandom buildCTR(BlockCipher cipher, int keySizeInBits, byte[] nonce, boolean predictionResistant)

Build a SecureRandom based on a SP 800-90A CTR DRBG.

Parameters

cipher:BlockCipher: the block cipher to base the DRBG on.
keySizeInBits:int: key size in bits to be used with the block cipher.
nonce:byte[]: nonce value to use in DRBG construction.
predictionResistant:boolean: specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes.

Returns:SP800SecureRandom

a SecureRandom supported by a CTR DRBG.

buildHash	back to summary
public SP800SecureRandom buildHash(Digest digest, byte[] nonce, boolean predictionResistant) Build a SecureRandom based on a SP 800-90A Hash DRBG. Parameters digest:Digest digest algorithm to use in the DRBG underneath the SecureRandom. nonce:byte[] nonce value to use in DRBG construction. predictionResistant:boolean specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes. Returns:SP800SecureRandom a SecureRandom supported by a Hash DRBG.

buildHash

back to summary

public SP800SecureRandom buildHash(Digest digest, byte[] nonce, boolean predictionResistant)

Build a SecureRandom based on a SP 800-90A Hash DRBG.

Parameters

digest:Digest: digest algorithm to use in the DRBG underneath the SecureRandom.
nonce:byte[]: nonce value to use in DRBG construction.
predictionResistant:boolean: specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes.

Returns:SP800SecureRandom

a SecureRandom supported by a Hash DRBG.

buildHMAC	back to summary
public SP800SecureRandom buildHMAC(Mac hMac, byte[] nonce, boolean predictionResistant) Build a SecureRandom based on a SP 800-90A HMAC DRBG. Parameters hMac:Mac HMAC algorithm to use in the DRBG underneath the SecureRandom. nonce:byte[] nonce value to use in DRBG construction. predictionResistant:boolean specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes. Returns:SP800SecureRandom a SecureRandom supported by a HMAC DRBG.

buildHMAC

back to summary

public SP800SecureRandom buildHMAC(Mac hMac, byte[] nonce, boolean predictionResistant)

Build a SecureRandom based on a SP 800-90A HMAC DRBG.

Parameters

hMac:Mac: HMAC algorithm to use in the DRBG underneath the SecureRandom.
nonce:byte[]: nonce value to use in DRBG construction.
predictionResistant:boolean: specify whether the underlying DRBG in the resulting SecureRandom should reseed on each request for bytes.

Returns:SP800SecureRandom

a SecureRandom supported by a HMAC DRBG.

getSimplifiedName	back to summary
private static String getSimplifiedName(Digest digest)

setEntropyBitsRequired	back to summary
public SP800SecureRandomBuilder setEntropyBitsRequired(int entropyBitsRequired) Set the amount of entropy bits required for seeding and reseeding DRBGs used in building SecureRandom objects. Parameters entropyBitsRequired:int the number of bits of entropy to be requested from the entropy source on each seed/reseed. Returns:SP800SecureRandomBuilder the current builder.

setEntropyBitsRequired

back to summary

public SP800SecureRandomBuilder setEntropyBitsRequired(int entropyBitsRequired)

Set the amount of entropy bits required for seeding and reseeding DRBGs used in building SecureRandom objects.

Parameters

entropyBitsRequired:int: the number of bits of entropy to be requested from the entropy source on each seed/reseed.

Returns:SP800SecureRandomBuilder

the current builder.

setPersonalizationString	back to summary
public SP800SecureRandomBuilder setPersonalizationString(byte[] personalizationString) Set the personalization string for DRBG SecureRandoms created by this builder Parameters personalizationString:byte[] the personalisation string for the underlying DRBG. Returns:SP800SecureRandomBuilder the current builder.

setPersonalizationString

back to summary

public SP800SecureRandomBuilder setPersonalizationString(byte[] personalizationString)

Set the personalization string for DRBG SecureRandoms created by this builder

Parameters

personalizationString:byte[]: the personalisation string for the underlying DRBG.

Returns:SP800SecureRandomBuilder

the current builder.

setSecurityStrength	back to summary
public SP800SecureRandomBuilder setSecurityStrength(int securityStrength) Set the security strength required for DRBGs used in building SecureRandom objects. Parameters securityStrength:int the security strength (in bits) Returns:SP800SecureRandomBuilder the current builder.

setSecurityStrength

back to summary

public SP800SecureRandomBuilder setSecurityStrength(int securityStrength)

Set the security strength required for DRBGs used in building SecureRandom objects.

Parameters

securityStrength:int: the security strength (in bits)

Returns:SP800SecureRandomBuilder

the current builder.

org.bouncycastle.crypto.prng back to summary

private Class SP800SecureRandomBuilder.CTRDRBGProvider

Class Inheritance

extends Object
implements DRBGProvider

java.lang.Object
org.bouncycastle.crypto.prng.SP800SecureRandomBuilder.CTRDRBGProvider

All Implemented Interfaces

org.bouncycastle.crypto.prng.DRBGProvider

Field Summary

Modifier and Type	Field and Description
private final BlockCipher	blockCipher
private final int	keySizeInBits
private final byte[]	nonce
private final byte[]	personalizationString
private final int	securityStrength

Constructor Summary

Access	Constructor and Description
public	CTRDRBGProvider(BlockCipher blockCipher, int keySizeInBits, byte[] nonce, byte[] personalizationString, int securityStrength)

Method Summary

Modifier and Type	Method and Description
public SP80090DRBG	get(EntropySource entropySource) Implements org.bouncycastle.crypto.prng.DRBGProvider.get.
public String	getAlgorithm() Implements org.bouncycastle.crypto.prng.DRBGProvider.getAlgorithm.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

blockCipher	back to summary
private final BlockCipher blockCipher

keySizeInBits	back to summary
private final int keySizeInBits

nonce	back to summary
private final byte[] nonce

personalizationString	back to summary
private final byte[] personalizationString

securityStrength	back to summary
private final int securityStrength

Constructor Detail

CTRDRBGProvider	back to summary
public CTRDRBGProvider(BlockCipher blockCipher, int keySizeInBits, byte[] nonce, byte[] personalizationString, int securityStrength)

Method Detail

get	back to summary
public SP80090DRBG get(EntropySource entropySource) Implements org.bouncycastle.crypto.prng.DRBGProvider.get.

getAlgorithm	back to summary
public String getAlgorithm() Implements org.bouncycastle.crypto.prng.DRBGProvider.getAlgorithm.

org.bouncycastle.crypto.prng back to summary

private Class SP800SecureRandomBuilder.HashDRBGProvider

Class Inheritance

extends Object
implements DRBGProvider

java.lang.Object
org.bouncycastle.crypto.prng.SP800SecureRandomBuilder.HashDRBGProvider

All Implemented Interfaces

org.bouncycastle.crypto.prng.DRBGProvider

Field Summary

Modifier and Type	Field and Description
private final Digest	digest
private final byte[]	nonce
private final byte[]	personalizationString
private final int	securityStrength

Constructor Summary

Access	Constructor and Description
public	HashDRBGProvider(Digest digest, byte[] nonce, byte[] personalizationString, int securityStrength)

Method Summary

Modifier and Type	Method and Description
public SP80090DRBG	get(EntropySource entropySource) Implements org.bouncycastle.crypto.prng.DRBGProvider.get.
public String	getAlgorithm() Implements org.bouncycastle.crypto.prng.DRBGProvider.getAlgorithm.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

digest	back to summary
private final Digest digest

nonce	back to summary
private final byte[] nonce

personalizationString	back to summary
private final byte[] personalizationString

securityStrength	back to summary
private final int securityStrength

Constructor Detail

HashDRBGProvider	back to summary
public HashDRBGProvider(Digest digest, byte[] nonce, byte[] personalizationString, int securityStrength)

Method Detail

get	back to summary
public SP80090DRBG get(EntropySource entropySource) Implements org.bouncycastle.crypto.prng.DRBGProvider.get.

getAlgorithm	back to summary
public String getAlgorithm() Implements org.bouncycastle.crypto.prng.DRBGProvider.getAlgorithm.

org.bouncycastle.crypto.prng back to summary

private Class SP800SecureRandomBuilder.HMacDRBGProvider

Class Inheritance

extends Object
implements DRBGProvider

java.lang.Object
org.bouncycastle.crypto.prng.SP800SecureRandomBuilder.HMacDRBGProvider

All Implemented Interfaces

org.bouncycastle.crypto.prng.DRBGProvider

Field Summary

Modifier and Type	Field and Description
private final Mac	hMac
private final byte[]	nonce
private final byte[]	personalizationString
private final int	securityStrength

Constructor Summary

Access	Constructor and Description
public	HMacDRBGProvider(Mac hMac, byte[] nonce, byte[] personalizationString, int securityStrength)

Method Summary

Modifier and Type	Method and Description
public SP80090DRBG	get(EntropySource entropySource) Implements org.bouncycastle.crypto.prng.DRBGProvider.get.
public String	getAlgorithm() Implements org.bouncycastle.crypto.prng.DRBGProvider.getAlgorithm.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

hMac	back to summary
private final Mac hMac

nonce	back to summary
private final byte[] nonce

personalizationString	back to summary
private final byte[] personalizationString

securityStrength	back to summary
private final int securityStrength

Constructor Detail

HMacDRBGProvider	back to summary
public HMacDRBGProvider(Mac hMac, byte[] nonce, byte[] personalizationString, int securityStrength)

Method Detail

get	back to summary
public SP80090DRBG get(EntropySource entropySource) Implements org.bouncycastle.crypto.prng.DRBGProvider.get.

getAlgorithm	back to summary
public String getAlgorithm() Implements org.bouncycastle.crypto.prng.DRBGProvider.getAlgorithm.

public Class SP800SecureRandomBuilder

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class SP800SecureRandomBuilder.CTRDRBGProvider

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class SP800SecureRandomBuilder.HashDRBGProvider

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class SP800SecureRandomBuilder.HMacDRBGProvider

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail