クラス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()
    トレーラ・フィールドの値を返します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    String
    toString()
    オブジェクトの文字列表現を返します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • 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 - ハッシュ関数のアルゴリズム名。 ハッシュ関数の標準名の詳細は、「Javaセキュリティ標準アルゴリズム名仕様」のPSSParameterSpecセクションを参照してください。
      mgfName - マスク生成関数のアルゴリズム名。 マスク生成関数の標準名の詳細は、「Javaセキュリティ標準アルゴリズム名仕様」のPSSParameterSpecセクションを参照してください。
      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