CKTIS / Java
AEADBadTagException — chyba overenia šifrovaného textu
AEADBadTagException znamená, že Cipher pracujúci v režime AEAD, napríklad GCM alebo CCM, nedokázal overiť autentizačnú značku. Údaje odmietnite a nepovažujte ich za úspešne dešifrované.
Verzia: 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 je kontrolovaná výnimka dostupná od Java 7 v balíku javax.crypto modulu java.base. Dedí z BadPaddingException, ale v tomto prípade signalizuje neúspešné overenie značky AEAD, nie bežný problém s paddingom. Konštruktor AEADBadTagException() neposkytuje podrobnú správu; AEADBadTagException(String msg) ju prijíma.
AEAD autentifikuje šifrované údaje a prípadné ďalšie autentizované údaje (AAD), ktoré sa nešifrujú. Pri dešifrovaní vyvolá Cipher.doFinal(...) túto výnimku, ak značka nesúhlasí. Samotná výnimka nerozlišuje medzi manipuláciou, poškodením a nezhodnými vstupmi, ako sú kľúč, IV alebo AAD.
Po chybe údaje odmietnite; nepoužívajte žiadny čiastočný otvorený text. Ak spracúvate AEADBadTagException a BadPaddingException oddelene, umiestnite konkrétnejší blok catch ako prvý. Nezakladajte logiku programu na texte správy výnimky.
Príklad zmení jeden bit značky a očakáva Authentication failed. Pevný kľúč a IV slúžia iba na izolovanú ukážku: pri skutočnom šifrovaní GCM nikdy neopakujte IV s rovnakým kľúčom. Dokumentácia sa vzťahuje na Java SE 21; produkčné runtime prostredie repozitára nebolo potvrdené.
Prí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ýsledok
Authentication failed
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.