Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

AEADBadTagException — errore di autenticazione del testo cifrato

AEADBadTagException significa che un Cipher in modalità AEAD, come GCM o CCM, non è riuscito a verificare il tag di autenticazione. I dati vanno rifiutati, non considerati decifrati correttamente.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

import javax.crypto.AEADBadTagException;

// public class AEADBadTagException extends BadPaddingException
new AEADBadTagException();
new AEADBadTagException("Authentication failed");

javax.crypto.AEADBadTagException è un’eccezione controllata disponibile da Java 7, nel package javax.crypto del modulo java.base. Estende BadPaddingException, ma in questo caso segnala il fallimento della verifica del tag AEAD, non un normale problema di padding. Il costruttore AEADBadTagException() non fornisce un messaggio dettagliato; AEADBadTagException(String msg) ne accetta uno.

AEAD autentica i dati cifrati e gli eventuali dati aggiuntivi autenticati (AAD), che non vengono cifrati. Durante la decifratura, Cipher.doFinal(...) genera questa eccezione se il tag non corrisponde. L’eccezione da sola non permette di distinguere tra manomissione, corruzione o input non corrispondenti, come la chiave, l’IV o l’AAD.

Dopo un errore, rifiuta i dati; non usare alcun testo in chiaro parziale. Se gestisci separatamente AEADBadTagException e BadPaddingException, inserisci per primo il blocco catch più specifico. Non basare la logica del programma sul testo del messaggio dell’eccezione.

L’esempio inverte un bit del tag e si aspetta Authentication failed. La chiave e l’IV fissi servono solo per una dimostrazione isolata: nella cifratura GCM reale, non riutilizzare mai un IV con la stessa chiave. La documentazione riguarda Java SE 21; l’ambiente di produzione del repository non è stato attestato.

Esempi

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");
        }
    }
}

Risultato

Authentication failed

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti