CKTIS / Java
AEADBadTagException — napaka pri preverjanju šifriranega besedila
AEADBadTagException pomeni, da Cipher v načinu AEAD, kot sta GCM ali CCM, ni mogel preveriti avtentikacijske oznake. Podatke zavrnite, namesto da bi jih obravnavali kot uspešno dešifrirane.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
import javax.crypto.AEADBadTagException;
// public class AEADBadTagException extends BadPaddingException
new AEADBadTagException();
new AEADBadTagException("Authentication failed");javax.crypto.AEADBadTagException je preverjena izjema, ki je na voljo od Jave 7 v paketu javax.crypto modula java.base. Razširja BadPaddingException, vendar v tem primeru označuje neuspešno preverjanje oznake AEAD, ne običajne težave s paddingom. Konstruktor AEADBadTagException() ne poda podrobnega sporočila; AEADBadTagException(String msg) ga sprejme.
AEAD avtenticira šifrirane podatke in neobvezne dodatne avtenticirane podatke (AAD), ki niso šifrirani. Med dešifriranjem Cipher.doFinal(...) sproži to izjemo, če se oznaka ne ujema. Sama izjema ne pove, ali so vzrok poseg v podatke, poškodba ali neujemajoči se vhodi, kot so ključ, IV ali AAD.
Po napaki podatke zavrnite; ne uporabite delnega odprtega besedila. Če ločeno obravnavate AEADBadTagException in BadPaddingException, naj bo bolj specifični blok catch prvi. Programske logike ne zasnujte na besedilu sporočila izjeme.
Primer spremeni en bit oznake in pričakuje Authentication failed. Fiksni ključ in IV sta namenjena samo izoliranemu prikazu: pri pravem šifriranju GCM nikoli ne ponovite IV z istim ključem. Dokumentacija zajema Java SE 21; produkcijsko izvajalno okolje repozitorija ni bilo potrjeno.
Primeri
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");
}
}
}Rezultat
Authentication failed
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.