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.