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

クラスPSSParameterSpec

  • すべての実装されたインタフェース:
    AlgorithmParameterSpec
    public class PSSParameterSpec
extends Object
implements AlgorithmParameterSpec
    このクラスは、PKCS#1 v2.2標準に定義されているRSASSA-PSSシグネチャ・スキームのパラメータ仕様を指定します。

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

     RSASSA-PSS-params ::= SEQUENCE {
   hashAlgorithm      [0] HashAlgorithm      DEFAULT sha1,
   maskGenAlgorithm   [1] MaskGenAlgorithm   DEFAULT mgf1SHA1,
   saltLength         [2] INTEGER            DEFAULT 20,
   trailerField       [3] TrailerField       DEFAULT trailerFieldBC(1)
 }
    where 
     HashAlgorithm ::= AlgorithmIdentifier {
   {OAEP-PSSDigestAlgorithms}
 }
 MaskGenAlgorithm ::= AlgorithmIdentifier { {PKCS1MGFAlgorithms} }
 TrailerField ::= INTEGER { trailerFieldBC(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 }|
   { OID id-sha512-224 PARAMETERS NULL }|
   { OID id-sha512-256 PARAMETERS NULL },
   ...  -- Allows for future expansion --
 }
 PKCS1MGFAlgorithms    ALGORITHM-IDENTIFIER ::= {
   { OID id-mgf1 PARAMETERS HashAlgorithm },
   ...  -- Allows for future expansion --
 }

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

    導入されたバージョン:
    1.4
    関連項目:
    MGF1ParameterSpec, AlgorithmParameterSpec, Signature

    • フィールドのサマリー

      フィールド 
      修飾子と型 フィールド 説明
      static PSSParameterSpec DEFAULT
      デフォルト値がすべて設定されたPSSパラメータ・セット
      static int TRAILER_FIELD_BC
      PKCS #1に定義されているTrailerFieldBC定数

    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      PSSParameterSpec​(int saltLen)
      指定されたソルト長とその他のデフォルト値を使用して、PKCS#1で定義されたPSSParameterSpecを新規作成します。
      PSSParameterSpec​(String mdName, String mgfName, AlgorithmParameterSpec mgfSpec, int saltLen, int trailerField)
      指定されたメッセージ・ダイジェスト、マスク生成関数、マスク生成関数用パラメータ、ソルト長、トレーラ・フィールドの各値を使用して、PKCS#1標準で定義されたPSSParameterSpecを新規作成します。

    • フィールドの詳細

      • TRAILER_FIELD_BC

        public static final int TRAILER_FIELD_BC
        PKCS #1に定義されているTrailerFieldBC定数
        導入されたバージョン:
        11
        関連項目:
        定数フィールド値

      • 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エンコーディングで使用されるsaltの長さ(バイト)
        例外:
        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()
        Saltの長さをバイト単位で返します。
        戻り値:
        ソルト長

      • getTrailerField

        public int getTrailerField()
        トレーラ・フィールドの値を返します。
        戻り値:
        トレーラ・フィールドの値
        導入されたバージョン:
        1.5