CKTIS / Java
AEADBadTagException — fallo de autenticación del texto cifrado
AEADBadTagException significa que un Cipher que funciona en un modo AEAD, como GCM o CCM, no pudo verificar la etiqueta de autenticación. Rechaza los datos en lugar de tratarlos como descifrados correctamente.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
import javax.crypto.AEADBadTagException;
// public class AEADBadTagException extends BadPaddingException
new AEADBadTagException();
new AEADBadTagException("Authentication failed");javax.crypto.AEADBadTagException es una excepción comprobada disponible desde Java 7, en el paquete javax.crypto del módulo java.base. Hereda de BadPaddingException, pero en este caso indica que ha fallado la verificación de la etiqueta AEAD, no un problema normal de padding. El constructor AEADBadTagException() no proporciona un mensaje detallado; AEADBadTagException(String msg) acepta uno.
AEAD autentica los datos cifrados y los datos autenticados adicionales opcionales (AAD), que no se cifran. Durante el descifrado, Cipher.doFinal(...) lanza esta excepción si la etiqueta no coincide. La excepción por sí sola no permite distinguir entre manipulación, corrupción o entradas que no coinciden, como la clave, el IV o el AAD.
Tras un fallo, rechaza los datos; no utilices ningún texto plano parcial. Si gestionas AEADBadTagException y BadPaddingException por separado, coloca primero el bloque catch más específico. No bases la lógica del programa en el texto del mensaje de la excepción.
El ejemplo invierte un bit de la etiqueta y espera Authentication failed. La clave y el IV fijos son solo para una demostración aislada: en un cifrado GCM real, nunca repitas un IV con la misma clave. El alcance de la documentación es Java SE 21; no se ha certificado el entorno de ejecución de producción del repositorio.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.