Класс GCMParameterSpec

java.lang.Object

javax.crypto.spec.GCMParameterSpec

Все реализуемые интерфейсы:: AlgorithmParameterSpec

public class GCMParameterSpec extends Object implements AlgorithmParameterSpec

Определяет набор параметров, необходимых для Cipher с использованием режима Galois/Counter Mode (GCM).

Простые режимы блочных шифров (например, CBC) обычно требуют только вектора инициализации (например, IvParameterSpec), но GCM требует следующих параметров:

IV: Вектор инициализации (IV)
tLen: длина (в битах) тега аутентификации T

Помимо описанных здесь параметров, другие входные/выходные данные GCM (Дополнительные данные аутентификации (AAD), ключи, блочные шифры, зашифрованные/расшифрованные данные и теги аутентификации) обрабатываются в классе Cipher.

Дополнительную информацию об алгоритме аутентифицированного шифрования с ассоциированными данными (AEAD) можно найти в RFC 5116 , а также в NIST Special Publication 800-38D, "NIST Recommendation for Block Cipher Modes of Operation: Galois/Counter Mode (GCM) and GMAC."

Спецификация GCM указывает, что tLen может принимать только значения {128, 120, 112, 104, 96} или {64, 32} для определенных применений. Другие значения могут быть указаны для этого класса, но не все реализации CSP их поддерживают.

С тех пор:

1.7

См. также:

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

Конструктор	Описание
`GCMParameterSpec(int tLen, byte[] src)`	Создаёт GCMParameterSpec, используя указанную длину тега аутентификации в битах и буфер IV.
`GCMParameterSpec(int tLen, byte[] src, int offset, int len)`	Создаёт объект GCMParameterSpec, используя указанную длину тега аутентификации в битах и часть указанного буфера в качестве IV.

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

Модификатор и тип	Метод	Описание
`byte[]`	`getIV()`	Возвращает вектор инициализации (IV).
`int`	`getTLen()`	Возвращает длину тега аутентификации.

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

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

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

GCMParameterSpec

public GCMParameterSpec(int tLen, byte[] src)

Создаёт GCMParameterSpec, используя указанную длину тега аутентификации в битах и буфер IV.

Параметры:: tLen - длина тега аутентификации (в битах); src - буфер источника IV. Содержимое буфера копируется для защиты от последующих изменений.
Исключения:: IllegalArgumentException - если tLen отрицательно или src равно null.

GCMParameterSpec

public GCMParameterSpec(int tLen, byte[] src, int offset, int len)

Создаёт объект GCMParameterSpec, используя указанную длину тега аутентификации в битах и часть указанного буфера в качестве IV.

Параметры:: tLen - длина тега аутентификации (в битах); src - буфер источника IV. Содержимое буфера копируется для защиты от последующих изменений.; offset - смещение в src, где начинается IV; len - количество байтов IV
Исключения:: IllegalArgumentException - если tLen отрицательно, src равно null, len или offset отрицательны или сумма offset и len больше длины массива байтов src.

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

getTLen

public int getTLen()

Возвращает длину тега аутентификации.

Возвращает:: длину тега аутентификации (в битах)

getIV

public byte[] getIV()

Возвращает вектор инициализации (IV).

Возвращает:: IV. Создаёт новый массив каждый раз, когда вызывается этот метод.

© 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/spec/GCMParameterSpec.html