Класс KEM.Encapsulator

java.lang.Object

javax.crypto.KEM.Encapsulator

Вложенный класс:: KEM

public static final class KEM.Encapsulator extends Object

Капсулятор, сгенерированный методом KEM.newEncapsulator(java.security.PublicKey) на стороне отправителя KEM.

Этот класс представляет функцию инкапсуляции ключа KEM. Каждый вызов метода encapsulate генерирует новый секретный ключ и сообщение инкапсуляции ключа, возвращаемые в объекте KEM.Encapsulated.

С момента:: 21

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

Модификатор и тип	Метод	Описание
`KEM.Encapsulated`	`encapsulate()`	Функция инкапсуляции ключа.
`KEM.Encapsulated`	`encapsulate(int from, int to, String algorithm)`	Функция инкапсуляции ключа.
`int`	`encapsulationSize()`	Возвращает размер сообщения инкапсуляции ключа.
`String`	`providerName()`	Возвращает имя поставщика.
`int`	`secretSize()`	Возвращает размер общего секрета.

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

providerName

public String providerName()

Возвращает имя поставщика.

Возвращает:: имя поставщика

encapsulate

public KEM.Encapsulated encapsulate()

Функция инкапсуляции ключа.

Этот метод эквивалентен encapsulate(0, secretSize(), "Generic"). Эта комбинация аргументов должна поддерживаться каждой реализацией.

Сгенерированный секретный ключ обычно передаётся в функцию вывода ключа (KDF) в качестве входных данных.

Возвращает:: объект KEM.Encapsulated, содержащий общий секрет, сообщение инкапсуляции ключа и необязательные параметры. Общий секрет — это SecretKey, содержащий все байты секрета, и имя алгоритма "Generic".

encapsulate

public KEM.Encapsulated encapsulate(int from, int to, String algorithm)

Функция инкапсуляции ключа.

Каждый вызов этого метода генерирует новый секретный ключ и сообщение инкапсуляции ключа, возвращаемые в объекте KEM.Encapsulated.

Реализация может выбрать не поддерживать произвольные комбинации from, to, и algorithm.

Параметры:: from - начальный индекс массива байтов общего секрета для возврата, включительно; to - конечный индекс массива байтов общего секрета для возврата, исключая его; algorithm - имя алгоритма для секретного ключа, который возвращается
Возвращает:: объект KEM.Encapsulated, содержащий часть общего секрета, сообщение инкапсуляции ключа и необязательные параметры. Часть общего секрета — это SecretKey, содержащая байты секрета, начиная с from и заканчивая to, не включая последний. Например, encapsulate(0, 16, "AES") использует первые 16 байтов общего секрета в качестве 128-битного ключа AES.
Выбрасывает:: IndexOutOfBoundsException - если from < 0, from > to, или to > secretSize(); NullPointerException - если algorithm является null; UnsupportedOperationException - если комбинация from, to, и algorithm не поддерживается капсулятором

secretSize

public int secretSize()

Возвращает размер общего секрета.

Этот метод может быть вызван для определения длины общего секрета до вызова encapsulate или если полученный SecretKey не извлекается.

Возвращает:: размер общего секрета

encapsulationSize

public int encapsulationSize()

Возвращает размер сообщения инкапсуляции ключа.

Этот метод может быть вызван для определения длины сообщения инкапсуляции перед вызовом encapsulate.

Возвращает:: размер сообщения инкапсуляции ключа

© 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/javax/crypto/KEM.Encapsulator.html