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

クラスPSSParameterSpec

java.lang.Object
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 --
 }

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

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final PSSParameterSpec
    DEFAULT
    非推奨。
    このフィールドではPKCS #1標準で定義されたデフォルト値が使用されます。
    static final int
    TRAILER_FIELD_BC
    PKCS #1標準で定義されているTrailerFieldBC定数。

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

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

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    String
    getDigestAlgorithm()
    メッセージ・ダイジェストのアルゴリズムの名前を返します。
    String
    getMGFAlgorithm()
    マスク生成関数のアルゴリズムの名前を返します。
    AlgorithmParameterSpec
    getMGFParameters()
    マスク生成関数のパラメータを返します。
    int
    getSaltLength()
    Saltの長さをバイト単位で返します。
    int
    getTrailerField()
    トレーラ・フィールドの値を返します。

    クラスjava.lang.Objectで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • フィールド詳細

    • TRAILER_FIELD_BC

      public static final int TRAILER_FIELD_BC
      PKCS #1標準で定義されているTrailerFieldBC定数。
      導入されたバージョン:
      11
      関連項目:

    • DEFAULT

      @Deprecated(since="19") public static final PSSParameterSpec DEFAULT
      非推奨。
      このフィールドではPKCS #1標準で定義されたデフォルト値が使用されます。 これらのデフォルトの一部は、cryptanalysisの進歩のために推奨されなくなりました -- 詳細は、PKCS#1 v2.2標準を参照してください。 したがって、PSSParameterSpec(String, String, AlgorithmParameterSpec, int, int)コンストラクタを使用して、必要なパラメータ値を含む新しいPSSParameterSpecを作成することをお薦めします。
      デフォルト値がすべて設定された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

      @Deprecated(since="19") public PSSParameterSpec(int saltLen)
      非推奨。
      このコンストラクタは、saltの長さを除き、PKCS #1標準で定義されたデフォルト値を使用します。 これらのデフォルトの一部は、cryptanalysisの進歩のために推奨されなくなりました -- 詳細は、PKCS#1 v2.2標準を参照してください。 したがって、必要なすべてのパラメータ値をPSSParameterSpec(String, String, AlgorithmParameterSpec, int, int)コンストラクタで明示的に指定することをお薦めします。
      PKCS #1標準で定義されている指定されたソルト長およびその他のデフォルト値を使用して、新しいPSSParameterSpecを作成します。
      パラメータ:
      saltLen - ソルトの長さ(バイト)
      スロー:
      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