База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

GCMParameterSpec — параметри за режим GCM

GCMParameterSpec предоставя на Cipher вектор за инициализация и дължина на маркера за удостоверяване. Самият обект не криптира данни и не гарантира уникалност на IV.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()

GCMParameterSpec от пакета javax.crypto.spec описва параметри за Cipher в режим GCM. tLen задава дължината на маркера за удостоверяване в битове, а не в байтове; това не е дължината на ключа.

Конструкторът приема целия IV или част от src, избрана чрез offset и len в байтове. Той копира входните данни; getIV() също връща ново копие. getTLen() връща дължината на маркера.

Отрицателен tLen, null или невалидни граници на подмасива водят до IllegalArgumentException. Успешното създаване на обекта не гарантира, че криптографският доставчик поддържа избраната дължина на маркера.

За AES/GCM/NoPadding подай тези параметри на Cipher.init(...). Никога не използвай повторно IV при криптиране със същия ключ: това позволява атаки с подправяне на съобщения. Примерът показва само копиране на масиви, а не сигурно генериране на IV.

Примери

import javax.crypto.spec.GCMParameterSpec;

public class Main {
    public static void main(String[] args) {
        byte[] iv = new byte[12];
        iv[0] = 7;
        GCMParameterSpec spec = new GCMParameterSpec(128, iv);

        iv[0] = 9;
        byte[] copy = spec.getIV();
        copy[0] = 11;

        System.out.println(spec.getTLen());
        System.out.println(spec.getIV().length);
        System.out.println(spec.getIV()[0]);
    }
}

Резултат

128
12
7

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници