Класс GCMParameterSpec

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

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

Конструкторы

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