CKTIS / Java
AEADBadTagException – Authentifizierungsfehler beim Chiffretext
AEADBadTagException bedeutet, dass ein Cipher im AEAD-Modus, etwa GCM oder CCM, den Authentifizierungstag nicht verifizieren konnte. Die Daten müssen verworfen werden und dürfen nicht als erfolgreich entschlüsselt gelten.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
import javax.crypto.AEADBadTagException;
// public class AEADBadTagException extends BadPaddingException
new AEADBadTagException();
new AEADBadTagException("Authentication failed");javax.crypto.AEADBadTagException ist eine geprüfte Ausnahme, die seit Java 7 im Paket javax.crypto des Moduls java.base verfügbar ist. Sie erweitert BadPaddingException, signalisiert hier jedoch eine fehlgeschlagene Überprüfung des AEAD-Tags und kein gewöhnliches Padding-Problem. Der Konstruktor AEADBadTagException() liefert keine Detailnachricht; AEADBadTagException(String msg) nimmt eine solche entgegen.
AEAD authentifiziert verschlüsselte Daten und optionale zusätzliche authentifizierte Daten (AAD), die nicht verschlüsselt werden. Beim Entschlüsseln löst Cipher.doFinal(...) diese Ausnahme aus, wenn der Tag nicht übereinstimmt. Die Ausnahme allein lässt nicht erkennen, ob Manipulation, Beschädigung oder nicht passende Eingaben wie Schlüssel, IV oder AAD die Ursache sind.
Verwirf die Daten nach einem Fehler; verwende keinen teilweise entschlüsselten Klartext. Wenn du AEADBadTagException und BadPaddingException getrennt behandelst, muss der spezifischere catch-Block zuerst stehen. Richte die Programmlogik nicht am Text der Ausnahmemeldung aus.
Das Beispiel kippt ein Bit des Tags um und erwartet Authentication failed. Der feste Schlüssel und IV dienen ausschließlich einer isolierten Demonstration: Verwende bei echter GCM-Verschlüsselung niemals denselben IV erneut mit demselben Schlüssel. Die Dokumentation bezieht sich auf Java SE 21; die Produktionslaufzeit des Repositorys wurde nicht bestätigt.
Beispiele
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");
}
}
}Ergebnis
Authentication failed
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.