Класс 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()`	Возвращает значение поля завершающего маркера.

Методы, объявленные в классе Object

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()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание полей

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 Security Standard Algorithm Names.

mgfName — название алгоритма функции генерации маски. Сведения о стандартных названиях функций генерации маски см. в разделе PSSParameterSpec спецификации Java Security Standard Algorithm Names.

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.