モジュール java.base
パッケージ java.security.spec

クラスPSSParameterSpec

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


    public class PSSParameterSpec
    extends Object
    implements AlgorithmParameterSpec
    このクラスは、PKCS#1 v2.1標準で定義されたRSA-PSS署名スキームのパラメータ仕様を指定します。

    PKCS#1標準のASN.1定義は次のように記述します。

     RSASSA-PSS-params ::= SEQUENCE {
       hashAlgorithm      [0] OAEP-PSSDigestAlgorithms  DEFAULT sha1,
       maskGenAlgorithm   [1] PKCS1MGFAlgorithms  DEFAULT mgf1SHA1,
       saltLength         [2] INTEGER  DEFAULT 20,
       trailerField       [3] INTEGER  DEFAULT 1
     }
     
    ここでは
     OAEP-PSSDigestAlgorithms    ALGORITHM-IDENTIFIER ::= {
       { OID id-sha1 PARAMETERS NULL   }|
       { OID id-sha224 PARAMETERS NULL   }|
       { OID id-sha256 PARAMETERS NULL }|
       { OID id-sha384 PARAMETERS NULL }|
       { OID id-sha512 PARAMETERS NULL },
       ...  -- Allows for future expansion --
     }
    
     PKCS1MGFAlgorithms    ALGORITHM-IDENTIFIER ::= {
       { OID id-mgf1 PARAMETERS OAEP-PSSDigestAlgorithms },
       ...  -- Allows for future expansion --
     }
     

    注: PSSParameterSpec.DEFAULTは次を使用します。メッセージ・ダイジェスト -- "SHA-1"マスク生成関数(mgf) -- "MGF1" mgfのパラメータ -- MGF1ParameterSpec.SHA1ソルト長 -- 20トレーラ・フィールド -- 1

    導入されたバージョン:
    1.4
    関連項目:
    MGF1ParameterSpec, AlgorithmParameterSpec, Signature
    • フィールドの詳細

      • DEFAULT

        public static final PSSParameterSpec DEFAULT
        デフォルト値がすべて設定されたPSSパラメータ・セット。
        導入されたバージョン:
        1.5
    • コンストラクタの詳細

      • PSSParameterSpec

        public PSSParameterSpec​(String mdName,
                                String mgfName,
                                AlgorithmParameterSpec mgfSpec,
                                int saltLen,
                                int trailerField)
        指定されたメッセージ・ダイジェスト、マスク生成関数、マスク生成関数用パラメータ、ソルト長、トレーラ・フィールドの各値を使用して、PKCS#1標準で定義されたPSSParameterSpecを新規作成します。
        パラメータ:
        mdName - ハッシュ関数のアルゴリズム名。
        mgfName - マスク生成関数のアルゴリズム名。
        mgfSpec - マスク生成関数のパラメータ。 nullが指定されると、getMGFParameters()でnullが返される。
        saltLen - ソルト長。
        trailerField - トレーラ・フィールドの値。
        例外:
        NullPointerException - mdNameまたはmgfNameがnullの場合。
        IllegalArgumentException - saltLenまたはtrailerFieldが0より小さい場合。
        導入されたバージョン:
        1.5
      • PSSParameterSpec

        public PSSParameterSpec​(int saltLen)
        指定されたソルト長とその他のデフォルト値を使用して、PKCS#1で定義されたPSSParameterSpecを新規作成します。
        パラメータ:
        saltLen - PKCS#1 PSSエンコーディングで使用されているソルト長(ビット単位)。
        例外:
        IllegalArgumentException - saltLenが0より小さい場合。
    • メソッドの詳細

      • getDigestAlgorithm

        public String getDigestAlgorithm​()
        メッセージ・ダイジェストのアルゴリズムの名前を返します。
        戻り値:
        メッセージ・ダイジェストのアルゴリズムの名前。
        導入されたバージョン:
        1.5
      • getMGFAlgorithm

        public String getMGFAlgorithm​()
        マスク生成関数のアルゴリズムの名前を返します。
        戻り値:
        マスク生成関数のアルゴリズムの名前。
        導入されたバージョン:
        1.5
      • getMGFParameters

        public AlgorithmParameterSpec getMGFParameters​()
        マスク生成関数のパラメータを返します。
        戻り値:
        マスク生成関数のパラメータ。
        導入されたバージョン:
        1.5
      • getSaltLength

        public int getSaltLength​()
        ソルト長を返します(ビット単位)。
        戻り値:
        ソルト長。
      • getTrailerField

        public int getTrailerField​()
        トレーラ・フィールド(PKCS#1 v2.1におけるbc)の値を返します。
        戻り値:
        トレーラ・フィールド(PKCS#1 v2.1におけるbc)の値。
        導入されたバージョン:
        1.5