Класс 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

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

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.

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

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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/security/spec/PSSParameterSpec.html