モジュール java.base
パッケージ 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メソッドを使用した、アルゴリズムに依存しない初期化だけが、アルゴリズム固有のパラメータに対してデフォルト設定を受け入れる場合に行う必要があります。

    注: このインタフェースの以前の実装の一部では、2048ビットや3072ビットのようなサイズの大きいDSAパラメータはサポートされていない場合があります。

    導入されたバージョン:
    1.1
    関連項目:
    KeyPairGenerator
    • メソッドのサマリー

      すべてのメソッド インスタンス・メソッド 抽象メソッド 
      修飾子と型 メソッド 説明
      void initialize​(int modlen, boolean genParams, SecureRandom random)
      指定されたモジュラスの長さ(パラメータではない)の鍵ペア・ジェネレータとオプションのSecureRandomビット・ソースを初期化します。
      void initialize​(DSAParams params, SecureRandom random)
      DSAファミリのパラメータ(p、q、およびg)とオプションの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以下の任意の64の倍数、2048および3072。
        random - 鍵ビットの生成に使用するランダム・ビットのソース。nullも可。
        genParams - 要求されたモジュラスの長さに対して新しいパラメータを生成するかどうかの指定。
        例外:
        InvalidParameterException - modlenが無効か未サポートの場合、またはgenParamsがfalseで、要求されたモジュラスの長さに対して計算済みのパラメータが存在しない場合。