Класс PSSParameterSpec

java.lang.Object

java.security.spec.PSSParameterSpec

Все реализованные интерфейсы:: AlgorithmParameterSpec

public class PSSParameterSpec extends Object implements AlgorithmParameterSpec

Этот класс определяет спецификацию параметров для схемы подписи RSASSA-PSS, как определено в стандарте PKCS#1 v2.2.

Его определение в ASN.1 в стандарте PKCS #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)
 }

где

 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`	Константа `TrailerFieldBC`, как определено в стандарте PKCS #1.

Краткое описание конструкторов

Конструктор	Описание
`PSSParameterSpec(int saltLen)`	Устарело. Этот конструктор использует значения по умолчанию, определённые в стандарте PKCS #1, за исключением длины соли.
`PSSParameterSpec(String mdName, String mgfName, AlgorithmParameterSpec mgfSpec, int saltLen, int trailerField)`	Создаёт новый объект `PSSParameterSpec`, как определено в стандарте PKCS #1, используя указанный алгоритм хеширования, функцию генерации маски, параметры для функции генерации маски, длину соли и значения поля трейлера.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`getDigestAlgorithm()`	Возвращает имя алгоритма хеширования.
`String`	`getMGFAlgorithm()`	Возвращает имя алгоритма генерации маски.
`AlgorithmParameterSpec`	`getMGFParameters()`	Возвращает параметры для функции генерации маски.
`int`	`getSaltLength()`	Возвращает длину соли в байтах.
`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

Константа TrailerFieldBC, как определено в стандарте PKCS #1.

С момента:

См. также:

DEFAULT

@Deprecated(since="19") public static final PSSParameterSpec DEFAULT

Устарело.

Это поле использует значения по умолчанию, определённые в стандарте PKCS #1. Некоторые из этих значений по умолчанию больше не рекомендуются из-за прогресса в криптоанализе – см. стандарт PKCS#1 v2.2 для получения более подробной информации. Поэтому рекомендуется создавать новый объект PSSParameterSpec с желаемыми значениями параметров, используя конструктор PSSParameterSpec(String, String, AlgorithmParameterSpec, int, int).

Набор параметров PSS со всеми значениями по умолчанию.

С момента:

1.5

Внешние спецификации

Подробное описание конструкторов

PSSParameterSpec

public PSSParameterSpec(String mdName, String mgfName, AlgorithmParameterSpec mgfSpec, int saltLen, int trailerField)

Создаёт новый объект PSSParameterSpec, как определено в стандарте PKCS #1, используя указанный алгоритм хеширования, функцию генерации маски, параметры для функции генерации маски, длину соли и значения поля трейлера.

Параметры:: mdName - имя алгоритма хеш-функции. См. раздел PSSParameterSpec спецификации стандартных алгоритмов безопасности Java Java Security Standard Algorithm Names Specification для информации о стандартных именах хеш-функций.; mgfName - имя алгоритма функции генерации маски. См. раздел PSSParameterSpec спецификации стандартных алгоритмов безопасности Java Java Security Standard Algorithm Names Specification для информации о стандартных именах функций генерации маски.; mgfSpec - параметры для функции генерации маски. Если задан null, getMGFParameters() вернёт null.; saltLen - длина соли в байтах; trailerField - значение поля трейлера
Исключения:: NullPointerException - если mdName или mgfName равно null; IllegalArgumentException - если saltLen или trailerField меньше 0
С момента:: 1.5

PSSParameterSpec

@Deprecated(since="19") public PSSParameterSpec(int saltLen)

Устарело.

Этот конструктор использует значения по умолчанию, определённые в стандарте PKCS #1, за исключением длины соли. Некоторые из этих значений по умолчанию больше не рекомендуются из-за прогресса в криптоанализе – см. стандарт PKCS#1 v2.2 для получения более подробной информации. Поэтому рекомендуется явно указывать все желаемые значения параметров с помощью конструктора PSSParameterSpec(String, String, AlgorithmParameterSpec, int, int).

Создаёт новый объект PSSParameterSpec, используя указанную длину соли и другие значения по умолчанию, как определено в стандарте PKCS #1.

Параметры:

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()

Возвращает длину соли в байтах.

Возвращает:: длину соли

getTrailerField

public int getTrailerField()

Возвращает значение для поля трейлера.

Возвращает:: значение для поля трейлера
С момента:: 1.5

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/security/spec/PSSParameterSpec.html