Justice League Blog
Proper use of Java’s SecureRandom
This is a guest post by Amit Sethi, Senior Consultant at Cigital.
When generating random numbers in Java for cryptographic purposes, many developers often use the
java.security.SecureRandom class. And while the
java.security.SecureRandom class is designed to generate cryptographically secure random numbers, there are a few subtleties in the API, and if it is used improperly the output can become predictable. At Cigital we have witnessed a number of cases where this is true. The following is a guide to the proper use of Java’s
First, let’s take a quick look at how the
java.security.SecureRandom API works. The
java.security.SecureRandom class does not actually implement a pseudorandom number generator (PRNG) itself. It uses PRNG implementations in other classes to generate random numbers. A number of actual PRNGs may actually be used when an instance of
java.security.SecureRandom is created. The PRNGs are part of Java cryptographic service providers (CSPs). In Sun’s Java implementation, the SUN CSP is used by default. On Windows, the SUN CSP uses the SHA1PRNG implemented in sun.security.provider.SecureRandom by default. On Solaris and Linux, the SUN CSP default is to use sun.security.provider.NativePRNG which simply provides the output of the
/dev/urandom PRNG provided by the operating system. If however, on Solaris/Linux, the java.security configuration file in the JRE is modified such that securerandom.source is set to something other than file:
/dev/urandom, then the SHA1PRNG implemented in sun.security.provider.SecureRandom is used, as on Windows. Of course, an application can choose not to use the defaults, and can always specify a particular PRNG implemented by a particular cryptographic provider. In Cigital’s experience, most Java applications that use
java.security.SecureRandom actually use the SHA1PRNG provided by the SUN CSP under the cover.
Now, an application will end up with an instance of SHA1PRNG implemented in
sun.security.provider.SecureRandom using the following calls:
// The following will create SUN SHA1PRNG on Windows with // default configuration and Sun JRE, and on Solaris/Linux // if securerandom.source is modified in java.security SecureRandom sr1 = new SecureRandom(); // The following will create SUN SHA1PRNG if the highest // priority CSP is SUN SecureRandom sr2 = SecureRandom.getInstance("SHA1PRNG"); // The following will always create SUN SHA1PRNG SecureRandom sr3 = SecureRandom.getInstance("SHA1PRNG", "SUN");
Note that according to Sun’s documentation, the returned
java.security.SecureRandom instance is not seeded by any of these calls. If after one of these calls,
java.security.SecureRandom.nextBytes(byte) is called, then the PRNG is seeded using a secure mechanism provided by the underlying operating system (starting with JRE 1.4.1 in Windows and JRE 1.4.2 in Linux and Solaris). If
java.security.SecureRandom.setSeed(byte) is called before a call to
java.security.SecureRandom.nextBytes(byte), then the internal seeding mechanism is bypassed, and only the provided seed is used to generate random numbers.
For those who are not familiar with the inner workings of cryptographic PRNGs, their job is to take a relatively small random seed and use it to produce deterministic output that seems random to anybody that does not know what the seed is. The PRNG tries to ensure that the output does not reveal any information about the seed, and that somebody observing the output cannot predict future outputs without knowing the seed.
By bypassing the internal secure seeding mechanism of the SHA1PRNG, you may compromise the security of your PRNG output. If you seed it with anything that an attacker can potentially predict (e.g. the time when the PRNG instance was created), then using
java.security.SecureRandom may not provide the level of security that you need.
Finally, regardless of how well the PRNG is seeded, it should not be used indefinitely without reseeding. There are two approaches that can be used for longer-term security of PRNG output:
- Periodically throw away the existing
java.security.SecureRandominstance and create a new one. This will generate a new instance with a new seed.
- Periodically add new random material to the PRNG seed by making a call to
In summary, keep the following in mind when using
- Always specify the exact PRNG and provider that you wish to use. If you just use the default PRNG, you may end up with different PRNGs on different installations of your application that may need to be called differently in order to work properly. Using the following code to get a PRNG instance is appropriate:
SecureRandom sr = SecureRandom.getInstance("SHA1PRNG", "SUN");
- When using the SHA1PRNG, always call
java.security.SecureRandom.nextBytes(byte)immediately after creating a new instance of the PRNG. This will force the PRNG to seed itself securely. If for testing purposes, you need predictable output, ignoring this rule and seeding the PRNG with hard-coded/predictable values may be appropriate.
- Use at least JRE 1.4.1 on Windows and at least JRE 1.4.2 on Solaris and Linux. Earlier versions do not seed the SHA1PRNG securely.
- Periodically reseed your PRNG as observing a large amount of PRNG output generated using one seed may allow the attacker to determine the seed and thus predict all future outputs.