Spec-Zone.ru › OpenJDK 21

Класс 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
См. также:
  • MGF1ParameterSpec
  • AlgorithmParameterSpec
  • Signature

Краткое описание полей

Модификатор и тип Поле Описание
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.
С момента:
11
См. также:
  • Значения постоянных полей

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 - имя алгоритма хеш-функции
mgfName - имя алгоритма функции генерации маски
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, 2023, 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/21/docs/api/java.base/java/security/spec/PSSParameterSpec.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API