Класс 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 по режимам работы блочных шифров: Galois/Counter Mode (GCM) и GMAC» — в NIST Special Publication 800-38D.

Спецификация 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, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/javax/crypto/spec/GCMParameterSpec.html