Class GCMParameterSpec

java.lang.Object

javax.crypto.spec.GCMParameterSpec

Все реализованные интерфейсы:: AlgorithmParameterSpec

public class GCMParameterSpec extends Object implements AlgorithmParameterSpec

Задает набор параметров, необходимых для Cipher, использующего режим Галуа/счетчика (GCM).

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

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

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

Дополнительные сведения об алгоритме аутентифицированного шифрования с присоединенными данными (AEAD) см. в документе RFC 5116 , а также в публикации NIST № 800-38D «Рекомендация NIST по режимам работы блочных шифров: режим Галуа/счетчика (GCM) и 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()`	Возвращает длину тега аутентификации.

Методы, объявленные в классе 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, 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/javax/crypto/spec/GCMParameterSpec.html