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

CKTIS / Java

Cipher: cifragem autenticada com AES-GCM

Cipher disponibiliza cifragem e decifragem através de fornecedores criptográficos de Java. AES-GCM protege a confidencialidade dos dados e deteta modificações. A utilização correta exige um IV único para cada chave e a verificação da etiqueta de autenticação.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
cipher.init(Cipher.ENCRYPT_MODE, key, new GCMParameterSpec(128, iv));
cipher.updateAAD(aad);
byte[] ciphertextAndTag = cipher.doFinal(plaintext);

Cipher de javax.crypto é uma interface baseada em classes para operações criptográficas implementadas por um fornecedor. Cipher.getInstance("AES/GCM/NoPadding") seleciona a transformação: algoritmo, modo e padding. Indica o nome completo em vez de depender das predefinições do fornecedor.

Cipher.init define a chave, os parâmetros e a direção: Cipher.ENCRYPT_MODE significa cifragem e Cipher.DECRYPT_MODE significa decifragem. GCMParameterSpec(128, iv) especifica uma etiqueta de autenticação de 128 bits e o IV. Cipher.updateAAD adiciona dados autenticados mas não cifrados; em GCM, fornece-os antes de processar a mensagem. A decifragem requer AAD e parâmetros idênticos.

Cipher.doFinal conclui a operação: a cifragem GCM acrescenta a etiqueta ao texto cifrado, enquanto a decifragem a verifica. Uma incompatibilidade causa AEADBadTagException; rejeita o resultado e não consideres os dados autênticos antes de a verificação terminar com sucesso.

Nunca reutilizes um IV ao cifrar com a mesma chave. Antes de outra cifragem, volta a chamar init com um IV novo. A chave e o IV fixos e conhecidos publicamente no exemplo servem apenas para uma demonstração reproduzível, não para produção; as chaves reais exigem geração e armazenamento seguros.

Exemplos

import java.nio.charset.StandardCharsets;
import javax.crypto.Cipher;
import javax.crypto.spec.GCMParameterSpec;
import javax.crypto.spec.SecretKeySpec;

public class CipherDemo {
    public static void main(String[] args) throws Exception {
        // Fixed key and IV: reproducible demonstration only, never production.
        var key = new SecretKeySpec(new byte[16], "AES");
        byte[] iv = new byte[12];
        byte[] aad = "record:1".getBytes(StandardCharsets.UTF_8);
        byte[] plaintext = "Hello".getBytes(StandardCharsets.UTF_8);
        var parameters = new GCMParameterSpec(128, iv);

        Cipher encryptor = Cipher.getInstance("AES/GCM/NoPadding");
        encryptor.init(Cipher.ENCRYPT_MODE, key, parameters);
        encryptor.updateAAD(aad);
        byte[] ciphertextAndTag = encryptor.doFinal(plaintext);

        Cipher decryptor = Cipher.getInstance("AES/GCM/NoPadding");
        decryptor.init(Cipher.DECRYPT_MODE, key, parameters);
        decryptor.updateAAD(aad);
        byte[] recovered = decryptor.doFinal(ciphertextAndTag);

        System.out.println(new String(recovered, StandardCharsets.UTF_8));
        System.out.println(ciphertextAndTag.length);
    }
}

Resultado

Hello
21

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