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

CKTIS / Java

AEADBadTagException — falha na autenticação do texto cifrado

AEADBadTagException significa que um Cipher a funcionar num modo AEAD, como GCM ou CCM, não conseguiu verificar a etiqueta de autenticação. Rejeita os dados em vez de os considerar corretamente decifrados.

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

Sintaxe

import javax.crypto.AEADBadTagException;

// public class AEADBadTagException extends BadPaddingException
new AEADBadTagException();
new AEADBadTagException("Authentication failed");

javax.crypto.AEADBadTagException é uma exceção verificada disponível desde Java 7, no pacote javax.crypto do módulo java.base. Estende BadPaddingException, mas, neste caso, indica que a verificação da etiqueta AEAD falhou, e não um problema normal de padding. O construtor AEADBadTagException() não fornece uma mensagem detalhada; AEADBadTagException(String msg) aceita uma.

AEAD autentica os dados cifrados e os dados autenticados adicionais opcionais (AAD), que não são cifrados. Durante a decifragem, Cipher.doFinal(...) lança esta exceção se a etiqueta não corresponder. A exceção, por si só, não permite distinguir entre adulteração, corrupção ou dados de entrada incompatíveis, como a chave, o IV ou o AAD.

Após uma falha, rejeita os dados; não utilizes texto simples parcial. Se tratares AEADBadTagException e BadPaddingException separadamente, coloca primeiro o bloco catch mais específico. Não baseies a lógica do programa no texto da mensagem da exceção.

O exemplo inverte um bit da etiqueta e espera Authentication failed. A chave e o IV fixos servem apenas para uma demonstração isolada: numa cifragem GCM real, nunca repitas um IV com a mesma chave. A documentação abrange Java SE 21; o ambiente de produção do repositório não foi atestado.

Exemplos

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

public class Main {
    public static void main(String[] args) throws Exception {
        // Fixed key and IV are for this isolated demonstration only.
        var key = new SecretKeySpec(new byte[16], "AES");
        var params = new GCMParameterSpec(128, new byte[12]);
        var encryptor = Cipher.getInstance("AES/GCM/NoPadding");
        encryptor.init(Cipher.ENCRYPT_MODE, key, params);
        byte[] sealed = encryptor.doFinal(
                "hello".getBytes(StandardCharsets.UTF_8));

        // Flip one bit in the appended authentication tag.
        sealed[sealed.length - 1] ^= 1;

        var decryptor = Cipher.getInstance("AES/GCM/NoPadding");
        decryptor.init(Cipher.DECRYPT_MODE, key, params);
        try {
            decryptor.doFinal(sealed);
            throw new AssertionError("Expected authentication failure");
        } catch (AEADBadTagException expected) {
            System.out.println("Authentication failed");
        }
    }
}

Resultado

Authentication failed

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