CKTIS / Java
AEADBadTagException — fout bij authenticatie van cijfertekst
AEADBadTagException betekent dat een Cipher in een AEAD-modus, zoals GCM of CCM, de authenticatietag niet kon verifiëren. Verwerp de gegevens in plaats van ze als correct ontsleuteld te behandelen.
Versie: 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 is een gecontroleerde uitzondering die sinds Java 7 beschikbaar is in het pakket javax.crypto van de module java.base. De uitzondering breidt BadPaddingException uit, maar geeft hier aan dat de verificatie van de AEAD-tag is mislukt, niet dat er een gewoon paddingprobleem is. De constructor AEADBadTagException() levert geen gedetailleerd bericht; AEADBadTagException(String msg) accepteert er een.
AEAD authenticeert versleutelde gegevens en optionele aanvullende geauthenticeerde gegevens (AAD), die niet worden versleuteld. Tijdens het ontsleutelen werpt Cipher.doFinal(...) deze uitzondering als de tag niet overeenkomt. De uitzondering maakt op zichzelf geen onderscheid tussen manipulatie, beschadiging of niet-overeenkomende invoer, zoals de sleutel, IV of AAD.
Verwerp de gegevens na een fout; gebruik geen gedeeltelijke platte tekst. Als je AEADBadTagException en BadPaddingException afzonderlijk afhandelt, zet dan het specifiekere catch-blok eerst. Baseer programmalogica niet op de tekst van het uitzonderingsbericht.
Het voorbeeld keert één bit van de tag om en verwacht Authentication failed. De vaste sleutel en IV zijn uitsluitend bedoeld voor een geïsoleerde demonstratie: hergebruik bij echte GCM-versleuteling nooit een IV met dezelfde sleutel. De documentatie betreft Java SE 21; de productieomgeving van de repository is niet bevestigd.
Voorbeelden
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");
}
}
}Resultaat
Authentication failed
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.