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