JavaTM Platform
Standard Ed. 6

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


public interface DSAKeyPairGenerator

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

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 で、要求されたモジュラスの長さに対して計算済みのパラメータが存在しない場合

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。