Класс 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
См. также:: 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. Создает новый массив каждый раз при вызове этого метода.