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.