CKTIS / Java
GCMParameterSpec — parâmetros do modo GCM
GCMParameterSpec fornece ao Cipher um vetor de inicialização e o comprimento da etiqueta de autenticação. O próprio objeto não cifra dados nem garante a unicidade do IV.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()GCMParameterSpec, do pacote javax.crypto.spec, descreve parâmetros para um Cipher no modo GCM. tLen indica o comprimento da etiqueta de autenticação em bits, não em bytes; não é o comprimento da chave.
Um construtor aceita o IV completo ou uma parte de src selecionada por offset e len, em bytes. Copia os dados de entrada; getIV() também devolve uma cópia nova. getTLen() devolve o comprimento da etiqueta.
Um tLen negativo, null ou limites inválidos da secção provocam IllegalArgumentException. A criação do objeto não garante que um fornecedor criptográfico suporte o comprimento da etiqueta escolhido.
Para AES/GCM/NoPadding, passa estes parâmetros a Cipher.init(...). Nunca reutilizes um IV ao cifrar com a mesma chave: isso permite ataques de falsificação. O exemplo mostra apenas a cópia de arrays, não a geração segura de IV.
Exemplos
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]);
}
}Resultado
128 12 7
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.