SecureRandom (Java Platform SE 8)

java.lang.Object
- java.util.Random
- - java.security.SecureRandom

すべての実装されたインタフェース:

Serializable
```
public class SecureRandom
extends Random
```
このクラスは暗号用に強化された乱数ジェネレータ(RNG)を提供します。
強力な暗号化による乱数は、「FIPS 140-2, Security Requirements for Cryptographic Modules」のセクション4.9.1に指定されている統計的乱数生成テストに最低限適合しています。また、SecureRandomは順序不定で出力を行う必要があります。このため、SecureRamdomオブジェクトに渡されるすべてのシード素材が予測不可能で、SecureRandomのすべての出力シーケンスが「RFC 1750: Randomness Recommendations for Security」に記述されているとおり、強力に暗号化されている必要があります。
呼出し側は、引数なしのコンストラクタか、任意のgetInstanceメソッドを使って、SecureRandomインスタンスを取得します。
```
      SecureRandom random = new SecureRandom();
 
```
多くのSecureRandom実装は擬似乱数ジェネレータ(PRNG)の形式です。これは、特定の決定性アルゴリズムを使って真の乱数シードから擬似乱数シーケンスを生成することを意味します。実装の中には、真の乱数を生成するものもあれば、両方の技術の組み合わせを使用するものもあります。
SecureRandomの一般的な呼出し側は、次のメソッドを呼び出してランダム・バイトを取得します。
```
      SecureRandom random = new SecureRandom();
      byte bytes[] = new byte[20];
      random.nextBytes(bytes);
 
```
呼出し側は、次の例のようにgenerateSeedメソッドを呼び出して、指定された数のシード・バイトを生成することもできます。生成されたシード・バイトは、たとえば別の乱数ジェネレータをシードするために使用します。
```
      byte seed[] = random.generateSeed(20);
 
```
注: 実装によっては、generateSeedメソッドおよびnextBytesメソッドは、たとえばそれらがUNIX系オペレーティング・システムの/dev/randomから読み取る必要がある場合に、エントロピーが収集されるときにブロックされることがあります。
関連項目:

SecureRandomSpi, Random, 直列化された形式

コンストラクタのサマリー

コンストラクタ
修飾子	コンストラクタと説明
	`SecureRandom()` デフォルトの乱数アルゴリズムを実装する、セキュリティ保護された乱数ジェネレータ(RNG)を構築します。
	`SecureRandom(byte[] seed)` デフォルトの乱数アルゴリズムを実装する、セキュリティ保護された乱数ジェネレータ(RNG)を構築します。
`protected`	`SecureRandom(SecureRandomSpi secureRandomSpi, Provider provider)` SecureRandomオブジェクトを作成します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`byte[]`	`generateSeed(int numBytes)` 指定されたバイト数のシード・バイトを返します。シード・バイトの計算には、このクラスが自身をシードするのに使用するシード生成アルゴリズムが使用されます。
`String`	`getAlgorithm()` このSecureRandomオブジェクトが実装しているアルゴリズムの名前を返します。
`static SecureRandom`	`getInstance(String algorithm)` 指定された乱数ジェネレータ(RNG)アルゴリズムを実装したSecureRandomオブジェクトを返します。
`static SecureRandom`	`getInstance(String algorithm, Provider provider)` 指定された乱数ジェネレータ(RNG)アルゴリズムを実装したSecureRandomオブジェクトを返します。
`static SecureRandom`	`getInstance(String algorithm, String provider)` 指定された乱数ジェネレータ(RNG)アルゴリズムを実装したSecureRandomオブジェクトを返します。
`static SecureRandom`	`getInstanceStrong()` `securerandom.strongAlgorithmsSecurity`プロパティで指定されたアルゴリズムまたはプロバイダを使用して選択された`SecureRandom`オブジェクトを返します。
`Provider`	`getProvider()` このSecureRandomオブジェクトのプロバイダを返します。
`static byte[]`	`getSeed(int numBytes)` 指定されたバイト数のシード・バイトを返します。シード・バイトの計算には、このクラスが自身をシードするのに使用するシード生成アルゴリズムが使用されます。
`protected int`	`next(int numBits)` ユーザーが指定した数の擬似乱数ビット(右詰、ゼロ埋め込み)を含む整数を生成します。
`void`	`nextBytes(byte[] bytes)` ユーザーが指定したバイト数の乱数バイト数を生成します。
`void`	`setSeed(byte[] seed)` 乱数オブジェクトを再シードします。
`void`	`setSeed(long seed)` 指定された`long seed`に含まれている8バイトを使用して、この乱数オブジェクトを再シードします。

クラス java.util.Randomから継承されたメソッド
doubles, doubles, doubles, doubles, ints, ints, ints, ints, longs, longs, longs, longs, nextBoolean, nextDouble, nextFloat, nextGaussian, nextInt, nextInt, nextLong

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - SecureRandom
```
public SecureRandom()
```
    デフォルトの乱数アルゴリズムを実装する、セキュリティ保護された乱数ジェネレータ(RNG)を構築します。
    このコンストラクタは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。SecureRandom (RNG)アルゴリズムをサポートする最初のProviderのSecureRandomSpi実装をカプセル化する新しいSecureRandomオブジェクトが返されます。RNGアルゴリズムをサポートするProviderが存在しない場合、実装固有のデフォルト値が返されます。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    RNGアルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSecureRandomのセクションを参照。
    シードされていないSecureRandomオブジェクトが返されます。返されたオブジェクトをシードするには、setSeedメソッドを呼び出します。setSeedが呼び出されなかった場合、最初にnextBytesメソッドを呼び出したときに、SecureRandomオブジェクトが強制的にシードされます。setSeedが以前に呼び出されている場合、この自己シードは行われません。
  - SecureRandom
```
public SecureRandom(byte[] seed)
```
    デフォルトの乱数アルゴリズムを実装する、セキュリティ保護された乱数ジェネレータ(RNG)を構築します。SecureRandomインスタンスは、指定のシード・バイトでシードされます。
    このコンストラクタは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。SecureRandom (RNG)アルゴリズムをサポートする最初のProviderのSecureRandomSpi実装をカプセル化する新しいSecureRandomオブジェクトが返されます。RNGアルゴリズムをサポートするProviderが存在しない場合、実装固有のデフォルト値が返されます。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    RNGアルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSecureRandomのセクションを参照。
    
    パラメータ:
    
    seed - シード。
  - SecureRandom
```
protected SecureRandom(SecureRandomSpi secureRandomSpi,
                       Provider provider)
```
    SecureRandomオブジェクトを作成します。
    
    パラメータ:
    
    secureRandomSpi - SecureRandomの実装。
    
    provider - プロバイダ。
- メソッドの詳細
  - getInstance
```
public static SecureRandom getInstance(String algorithm)
                                throws NoSuchAlgorithmException
```
    指定された乱数ジェネレータ(RNG)アルゴリズムを実装したSecureRandomオブジェクトを返します。
    このメソッドは、最優先のProviderから順に、登録済みのセキュリティProviderのリストをトラバースします。指定されたアルゴリズムをサポートする最初のProviderのSecureRandomSpi実装をカプセル化する新しいSecureRandomオブジェクトが返されます。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    シードされていないSecureRandomオブジェクトが返されます。返されたオブジェクトをシードするには、setSeedメソッドを呼び出します。setSeedが呼び出されなかった場合、最初にnextBytesメソッドを呼び出したときに、SecureRandomオブジェクトが強制的にシードされます。setSeedが以前に呼び出されている場合、この自己シードは行われません。
    
    パラメータ:
    
    algorithm - RNGアルゴリズムの名前。RNGアルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSecureRandomのセクションを参照。
    
    戻り値:
    
    新規SecureRandomオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定したアルゴリズムのSecureRandomSpi実装をサポートするProviderが存在しない場合。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Provider
  - getInstance
```
public static SecureRandom getInstance(String algorithm,
                                       String provider)
                                throws NoSuchAlgorithmException,
                                       NoSuchProviderException
```
    指定された乱数ジェネレータ(RNG)アルゴリズムを実装したSecureRandomオブジェクトを返します。
    指定されたプロバイダのSecureRandomSpi実装をカプセル化する新しいSecureRandomオブジェクトが返されます。指定したプロバイダは、セキュリティ・プロバイダ・リストに登録する必要があります。
    登録済みプロバイダのリストは、Security.getProviders()メソッド経由で取得できます。
    シードされていないSecureRandomオブジェクトが返されます。返されたオブジェクトをシードするには、setSeedメソッドを呼び出します。setSeedが呼び出されなかった場合、最初にnextBytesメソッドを呼び出したときに、SecureRandomオブジェクトが強制的にシードされます。setSeedが以前に呼び出されている場合、この自己シードは行われません。
    
    パラメータ:
    
    algorithm - RNGアルゴリズムの名前。RNGアルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSecureRandomのセクションを参照。
    
    provider - プロバイダ名。
    
    戻り値:
    
    新規SecureRandomオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定されたプロバイダに指定されたアルゴリズムのSecureRandomSpiの実装がない場合。
    
    NoSuchProviderException - 指定されたプロバイダがセキュリティ・プロバイダ・リストに登録されていない場合。
    
    IllegalArgumentException - プロバイダ名がnullまたは空の場合。
    
    導入されたバージョン:
    
    1.2
    
    関連項目:
    
    Provider
  - getInstance
```
public static SecureRandom getInstance(String algorithm,
                                       Provider provider)
                                throws NoSuchAlgorithmException
```
    指定された乱数ジェネレータ(RNG)アルゴリズムを実装したSecureRandomオブジェクトを返します。
    指定されたProviderオブジェクトのSecureRandomSpi実装をカプセル化する新しいSecureRandomオブジェクトが返されます。指定されたProviderオブジェクトは、プロバイダ・リストに登録する必要はありません。
    シードされていないSecureRandomオブジェクトが返されます。返されたオブジェクトをシードするには、setSeedメソッドを呼び出します。setSeedが呼び出されなかった場合、最初にnextBytesメソッドを呼び出したときに、SecureRandomオブジェクトが強制的にシードされます。setSeedが以前に呼び出されている場合、この自己シードは行われません。
    
    パラメータ:
    
    algorithm - RNGアルゴリズムの名前。RNGアルゴリズムの標準名については、Java暗号化アーキテクチャ標準アルゴリズム名のドキュメントのSecureRandomのセクションを参照。
    
    provider - プロバイダ。
    
    戻り値:
    
    新規SecureRandomオブジェクト。
    
    例外:
    
    NoSuchAlgorithmException - 指定されたProviderオブジェクトに指定されたアルゴリズムのSecureRandomSpiの実装がない場合。
    
    IllegalArgumentException - 指定されたプロバイダがnullの場合。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    Provider
  - getProvider
```
public final Provider getProvider()
```
    このSecureRandomオブジェクトのプロバイダを返します。
    
    戻り値:
    
    このSecureRandomオブジェクトのプロバイダ。
  - getAlgorithm
```
public String getAlgorithm()
```
    このSecureRandomオブジェクトが実装しているアルゴリズムの名前を返します。
    
    戻り値:
    
    アルゴリズムの名前。アルゴリズム名を特定できない場合はunknown。
    
    導入されたバージョン:
    
    1.5
  - setSeed
```
public void setSeed(byte[] seed)
```
    乱数オブジェクトを再シードします。与えられたシードは、既存のシードと置き換わるのではなく、既存のシードに追加されます。これにより、呼出しを繰り返しても、ランダム性が減少しないことが保証されます。
    
    パラメータ:
    
    seed - シード。
    
    関連項目:
    
    getSeed(int)
  - setSeed
```
public void setSeed(long seed)
```
    指定されたlong seedに含まれている8バイトを使用して、この乱数オブジェクトを再シードします。与えられたシードは、既存のシードと置き換わるのではなく、既存のシードに追加されます。これにより、呼出しを繰り返しても、ランダム性が減少しないことが保証されます。
    このメソッドは、java.util.Randomとの互換性のために定義されています。
    
    オーバーライド:
    
    setSeed、クラス: Random
    
    パラメータ:
    
    seed - シード。
    
    関連項目:
    
    getSeed(int)
  - nextBytes
```
public void nextBytes(byte[] bytes)
```
    ユーザーが指定したバイト数の乱数バイト数を生成します。
    setSeedが以前に呼び出されたことがない場合は、このメソッドを最初に呼び出したとき、このSecureRandomオブジェクトが強制的にシードされます。setSeedが以前に呼び出されている場合、この自己シードは行われません。
    
    オーバーライド:
    
    nextBytes、クラス: Random
    
    パラメータ:
    
    bytes - 乱数バイトを充填する配列。
  - next
```
protected final int next(int numBits)
```
    ユーザーが指定した数の擬似乱数ビット(右詰、ゼロ埋め込み)を含む整数を生成します。このメソッドは、java.util.Randomメソッドをオーバーライドし、そのクラス(たとえば、nextInt、nextLong、およびnextFloat)から継承するメソッドのすべてに乱数ビットの発生源を提供するのに役立ちます。
    
    オーバーライド:
    
    next、クラス: Random
    
    パラメータ:
    
    numBits - 生成する擬似乱数ビットの数(0 <= numBits <= 32)。
    
    戻り値:
    
    ユーザー指定の擬似乱数ビット(右詰め、先頭にゼロ埋め込み)を含むint。
  - getSeed
```
public static byte[] getSeed(int numBytes)
```
    指定されたバイト数のシード・バイトを返します。シード・バイトの計算には、このクラスが自身をシードするのに使用するシード生成アルゴリズムが使用されます。この呼出しを使うと、ほかの乱数ジェネレータをシードできます。
    このメソッドは、下位互換のためだけに提供されています。呼出し側からは、代替のgetInstanceメソッドのうちの1つを使用してSecureRandomオブジェクトを取得したすぐあとに、generateSeedメソッドを呼び出してそのオブジェクトからシード・バイトを取得することをお薦めします。
    
    パラメータ:
    
    numBytes - 生成するシード・バイト数。
    
    戻り値:
    
    シード・バイト。
    
    関連項目:
    
    setSeed(byte[])
  - generateSeed
```
public byte[] generateSeed(int numBytes)
```
    指定されたバイト数のシード・バイトを返します。シード・バイトの計算には、このクラスが自身をシードするのに使用するシード生成アルゴリズムが使用されます。この呼出しを使うと、ほかの乱数ジェネレータをシードできます。
    
    パラメータ:
    
    numBytes - 生成するシード・バイト数。
    
    戻り値:
    
    シード・バイト。
  - getInstanceStrong
```
public static SecureRandom getInstanceStrong()
                                      throws NoSuchAlgorithmException
```
    securerandom.strongAlgorithmsSecurityプロパティで指定されたアルゴリズムまたはプロバイダを使用して選択されたSecureRandomオブジェクトを返します。
    RSA公開/非公開鍵のような付加価値の高い永続的な秘密情報を作成する場合など、状況によっては強力な乱数値が必要になります。アプリケーションが適切で強力なSecureRandom実装を選択できるようにするため、Javaディストリビューションでは、securerandom.strongAlgorithmsセキュリティ・プロパティに既知の強力なSecureRandom実装のリストが含まれています。
    Javaプラットフォームのすべての実装は、強力なSecureRandom実装を1つ以上サポートする必要があります。
    
    戻り値:
    
    securerandom.strongAlgorithmsセキュリティ・プロパティで示される強力なSecureRandom実装
    
    例外:
    
    NoSuchAlgorithmException - アルゴリズムが存在しない場合
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    Security.getProperty(String)

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスSecureRandom

コンストラクタのサマリー

メソッドのサマリー

クラス java.util.Randomから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

SecureRandom

SecureRandom

SecureRandom

メソッドの詳細

getInstance

getInstance

getInstance

getProvider

getAlgorithm

setSeed

setSeed

nextBytes

next

getSeed

generateSeed

getInstanceStrong