Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

GCMParameterSpec — parametri della modalità GCM

GCMParameterSpec fornisce a Cipher un vettore di inizializzazione e la lunghezza del tag di autenticazione. L’oggetto non cifra i dati né garantisce l’unicità dell’IV.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

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

GCMParameterSpec, nel pacchetto javax.crypto.spec, descrive i parametri per un Cipher in modalità GCM. tLen indica la lunghezza del tag di autenticazione in bit, non in byte; non è la lunghezza della chiave.

Un costruttore accetta l’intero IV oppure una parte di src selezionata da offset e len, in byte. Copia i dati in ingresso; anche getIV() restituisce una nuova copia. getTLen() restituisce la lunghezza del tag.

Un valore tLen negativo, null o limiti non validi della porzione causano IllegalArgumentException. La creazione dell’oggetto non garantisce che un provider crittografico supporti la lunghezza del tag scelta.

Per AES/GCM/NoPadding, passa questi parametri a Cipher.init(...). Non riutilizzare mai un IV quando cifri con la stessa chiave: ciò consente attacchi di contraffazione. L’esempio mostra solo la copia degli array, non la generazione sicura di IV.

Esempi

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]);
    }
}

Risultato

128
12
7

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti