CKTIS / Java
AEADBadTagException — chyba ověření šifrovaného textu
AEADBadTagException znamená, že Cipher pracující v režimu AEAD, například GCM nebo CCM, nedokázal ověřit autentizační značku. Data odmítněte a nepovažujte je za úspěšně dešifrovaná.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
import javax.crypto.AEADBadTagException;
// public class AEADBadTagException extends BadPaddingException
new AEADBadTagException();
new AEADBadTagException("Authentication failed");javax.crypto.AEADBadTagException je kontrolovaná výjimka dostupná od Java 7 v balíčku javax.crypto modulu java.base. Dědí z BadPaddingException, ale zde signalizuje neúspěšné ověření značky AEAD, nikoli běžný problém s paddingem. Konstruktor AEADBadTagException() neposkytuje podrobnou zprávu; AEADBadTagException(String msg) ji přijímá.
AEAD ověřuje šifrovaná data a případná další autentizovaná data (AAD), která se nešifrují. Při dešifrování vyvolá Cipher.doFinal(...) tuto výjimku, pokud značka nesouhlasí. Samotná výjimka nerozlišuje mezi manipulací, poškozením a neodpovídajícími vstupy, jako jsou klíč, IV nebo AAD.
Po chybě data odmítněte; nepoužívejte žádný částečný prostý text. Pokud zpracováváte AEADBadTagException a BadPaddingException odděleně, umístěte konkrétnější blok catch jako první. Nezakládejte logiku programu na textu zprávy výjimky.
Příklad změní jeden bit značky a očekává Authentication failed. Pevný klíč a IV slouží pouze pro izolovanou demonstraci: při skutečném šifrování GCM nikdy neopakujte IV se stejným klíčem. Dokumentace se vztahuje k Java SE 21; produkční běhové prostředí repozitáře nebylo potvrzeno.
Příklady
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");
}
}
}Výsledek
Authentication failed
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.