CKTIS / Java
AEADBadTagException — neuspjela autentikacija šifriranog teksta
AEADBadTagException znači da Cipher koji radi u načinu AEAD, kao što su GCM ili CCM, nije mogao provjeriti autentikacijsku oznaku. Podatke odbacite umjesto da ih smatrate uspješno dešifriranima.
Verzija: 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 provjerena je iznimka dostupna od Jave 7, u paketu javax.crypto modula java.base. Nasljeđuje BadPaddingException, ali ovdje označava neuspjelu provjeru oznake AEAD, a ne uobičajen problem s paddingom. Konstruktor AEADBadTagException() ne daje detaljnu poruku; AEADBadTagException(String msg) prihvaća je.
AEAD autentificira šifrirane podatke i neobavezne dodatne autentificirane podatke (AAD), koji se ne šifriraju. Tijekom dešifriranja Cipher.doFinal(...) izbacuje ovu iznimku ako se oznaka ne podudara. Sama iznimka ne razlikuje neovlaštenu izmjenu, oštećenje ni nepodudarne ulazne podatke kao što su ključ, IV ili AAD.
Nakon pogreške odbacite podatke; nemojte upotrebljavati djelomični otvoreni tekst. Ako zasebno obrađujete AEADBadTagException i BadPaddingException, najprije postavite konkretniji blok catch. Programsku logiku nemojte temeljiti na tekstu poruke iznimke.
Primjer mijenja jedan bit oznake i očekuje Authentication failed. Fiksni ključ i IV služe samo za izoliranu demonstraciju: pri stvarnom GCM šifriranju nikad nemojte ponoviti IV s istim ključem. Dokumentacija se odnosi na Java SE 21; produkcijsko okruženje izvođenja repozitorija nije potvrđeno.
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.