java.security.interfaces
インタフェース DSAKeyPairGenerator

public abstract interface DSAKeyPairGenerator

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

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

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

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

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

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

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

関連項目:

KeyPairGenerator

メソッドの概要

void	initialize(DSAParams params, SecureRandom random) p、q、g および DSA の系列のパラメータを使用して鍵ペアジェネレータを初期化します。
void	initialize(int modlen, boolean genParams, SecureRandom random) パラメータなしで、指定されたモジュラスの長さに対して鍵ペアを初期化します。

メソッドの詳細

initialize

public void initialize(DSAParams params,
                       SecureRandom random)
                throws InvalidParameterException

p、q、g および DSA の系列のパラメータを使用して鍵ペアジェネレータを初期化します。

パラメータ:

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

random - 鍵ビットの生成に使用する乱数発生の元

例外:

InvalidParameterException - 渡されたパラメータが無効または null の場合

initialize

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

パラメータなしで、指定されたモジュラスの長さに対して鍵ペアを初期化します。

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

パラメータ:

modlen - モジュラスの長さ。有効な値は、512 以上 1024 以下の任意の 8 の倍数

random - 鍵のビットの生成に使用する乱数発生の元

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

例外:

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