SecureRandom 类

定义

[Android.Runtime.Register("java/security/SecureRandom", DoNotGenerateAcw=true)]
public class SecureRandom : Java.Util.Random

[<Android.Runtime.Register("java/security/SecureRandom", DoNotGenerateAcw=true)>]
type SecureRandom = class
    inherit Random

继承

Object

Object

Random

SecureRandom

属性

RegisterAttribute

注解

此类提供加密强随机数生成器（RNG）。

加密强随机数最低符合 FIPS 140-2 中指定的统计随机数生成器测试，加密模块http://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.140-2.pdf的安全要求，第 4.9.1 节。 此外， SecureRandom 还必须生成非确定性输出。 因此，SecureRandom传递给对象的任何种子材料都必须不可预知，并且所有SecureRandom输出序列都必须以加密方式强，如 RFC 4086：安全http://tools.ietf.org/html/rfc4086随机性要求中所述。

许多 SecureRandom 实现采用伪随机数生成器（PRNG（也称为确定性随机位生成器或 DRBG）的形式，这意味着它们使用确定性算法从随机种子生成伪随机序列。 其他实现可能会生成真正的随机数，而其他实现可能同时使用这两种技术。

调用方通过无参数构造函数或方法之getInstance一获取SecureRandom实例。 例如：

<blockquote>

SecureRandom r1 = new SecureRandom();
            SecureRandom r2 = SecureRandom.getInstance("NativePRNG");
            SecureRandom r3 = SecureRandom.getInstance("DRBG",
                    DrbgParameters.instantiation(128, RESEED_ONLY, null));

</blockquote>

上面的第三个 SecureRandom 语句返回支持特定实例化参数的特定算法的对象。 实现的有效实例化参数必须与此最小请求匹配，但不一定相同。 例如，即使请求不需要特定功能，实际实例化也可以提供该功能。 实现可能会在实际使用之前延迟实例化 a SecureRandom ，但在创建有效实例化参数后必须确定，并且 #getParameters() 应始终返回相同的结果不变。

调用以下方法以检索随机字节的典型调用方 SecureRandom ：

<blockquote>

SecureRandom random = new SecureRandom();
            byte[] bytes = new byte[20];
            random.nextBytes(bytes);

</blockquote>

调用方还可以调用 #generateSeed 该方法来生成给定数量的种子字节（例如，为其他随机数生成器设定种子）：

<blockquote>

byte[] seed = random.generateSeed(20);

</blockquote>

新创建的 PRNG SecureRandom 对象未设定种子（除非由其创建）。#SecureRandom(byte[]) 第一个调用 nextBytes 将强制它从特定于实现的萎缩源播种自身。 如果 setSeed 以前调用过，则不会进行这种自播。

可以随时通过调用reseed或setSeed方法重新分配 ASecureRandom。 该方法 reseed 从其 entropy 源读取 entropy 输入以重新分配自身。 该方法 setSeed 要求调用方提供种子。

请注意， reseed 所有 SecureRandom 实现都可能不支持。

某些SecureRandom实现可能接受参数及其#nextBytes(byte[], SecureRandomParameters)#reseed(SecureRandomParameters)方法，以进一SecureRandomParameters步控制方法的行为。

注意：根据实现的不同，generateSeedreseed如果nextBytes各种类似 Unix 的操作系统上的 entropy 源为 /dev/random，则和方法可能会阻止收集 entropy。例如，如果 entropy 源是 /dev/random。

<h2> 线程安全 </h2>SecureRandom 对象可供多个并发线程使用。

在 1.1 中添加。

Java文档java.security.SecureRandom。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。