java.security.interfaces

インタフェース DSAKeyPairGenerator

public interface DSAKeyPairGenerator

DSA 鍵のペアを生成できるオブジェクトに対するインタフェースです。

initialize メソッドは何回でも呼び出すことができます。initialize メソッドが DSAKeyPairGenerator で呼び出されない場合、デフォルトでは、計算済みの p、q、g パラメータと、乱数ビット発生の元として SecureRandom のインスタンスを使用して 1024 ビット鍵を生成します。

DSA 固有のパラメータを指定したり、DSA アルゴリズムで使用するのに適切な鍵のペアを生成したりする場合には、通常、次のようにします。

1. 引数として DSA を指定して KeyPairGenerator の getInstance メソッドを呼び出して DSA に対する鍵ペアジェネレータを取得する。

2. その結果を DSAKeyPairGenerator にキャストしたあと、この DSAKeyPairGenerator インタフェースの initialize メソッドの 1 つを呼び出してそのジェネレータを初期化する。

3. KeyPairGenerator クラスの generateKeyPair を呼び出して鍵ペアを生成する。

注: DSA 鍵ペアジェネレータに対してアルゴリズム固有の初期化を毎回行う必要はありません。すなわち、このインタフェースの initialize メソッドを毎回呼び出す必要はありません。KeyPairGenerator インタフェースの initialize メソッドを使用した、アルゴリズムに依存しない初期化だけが、アルゴリズム固有のパラメータに対してデフォルト設定を受け入れる場合に行う必要があります。

関連項目:

KeyPairGenerator

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	initialize(DSAParams params, SecureRandom random) DSA ファミリのパラメータ (p、q、および g) とオプションの SecureRandom ビットソースを使用して、鍵ペアジェネレータを初期化します。
void	initialize(int modlen, boolean genParams, SecureRandom random) 指定されたモジュラスの長さ (パラメータではない) の鍵ペアジェネレータとオプションの SecureRandom ビットソースを初期化します。

メソッドの詳細

initialize

void initialize(DSAParams params,
              SecureRandom random)
                throws InvalidParameterException

DSA ファミリのパラメータ (p、q、および g) とオプションの SecureRandom ビットソースを使用して、鍵ペアジェネレータを初期化します。SecureRandom ビットソースが必要であるのに指定されていない場合 (null である場合)、デフォルトの SecureRandom インスタンスが使用されます。

パラメータ:

params - 鍵の生成に使用するパラメータ。

random - 鍵ビットの生成に使用するランダムビットのソース。null も可。

例外:

InvalidParameterException - params の値が無効であるか、null の場合。

initialize

void initialize(int modlen,
              boolean genParams,
              SecureRandom random)
                throws InvalidParameterException

指定されたモジュラスの長さ (パラメータではない) の鍵ペアジェネレータとオプションの SecureRandom ビットソースを初期化します。SecureRandom ビットソースが必要であるのに指定されていない場合 (null である場合)、デフォルトの SecureRandom インスタンスが使用されます。

genParams が true の場合、このメソッドは新しい p、q、および g のパラメータを生成します。false の場合、このメソッドは、要求されたモジュラスの長さに対する計算済みのパラメータを使用します。そのモジュラスの長さに対する計算済みのパラメータが存在しない場合は、例外が発生します。512 と 1024 ビットのモジュラスの長さに対しては、デフォルトのパラメータが常に存在することが保証されています。

パラメータ:

modlen - モジュラスの長さ (ビット単位)。有効な値は、512 以上 1024 以下の任意の 8 の倍数。

random - 鍵ビットの生成に使用するランダムビットのソース。null も可。

genParams - 要求されたモジュラスの長さに対して新しいパラメータを生成するかどうかの指定。

例外:

InvalidParameterException - modlen が 512 から 1024 の範囲にない場合、または genParams が false で、要求されたモジュラスの長さに対して計算済みのパラメータが存在しない場合。