モジュール 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 --
 }

ノート: 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を新規作成します。

  • メソッドのサマリー

    修飾子と型 メソッド 説明
    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

      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