Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes