Класс 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 поддерживают их.

Since:

1.7

См. также:

Cipher

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

Конструктор	Описание
`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, 2021, 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/17/docs/api/java.base/javax/crypto/spec/GCMParameterSpec.html