Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

AEADBadTagException — échec de l’authentification du texte chiffré

AEADBadTagException signifie qu’un Cipher fonctionnant en mode AEAD, comme GCM ou CCM, n’a pas pu vérifier le tag d’authentification. Il faut rejeter les données plutôt que de les considérer comme correctement déchiffrées.

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

Syntaxe

import javax.crypto.AEADBadTagException;

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

javax.crypto.AEADBadTagException est une exception vérifiée disponible depuis Java 7, dans le package javax.crypto du module java.base. Elle hérite de BadPaddingException, mais signale ici l’échec de la vérification du tag AEAD, et non un problème de padding ordinaire. Le constructeur AEADBadTagException() ne fournit aucun message détaillé ; AEADBadTagException(String msg) en accepte un.

AEAD authentifie les données chiffrées et les données authentifiées supplémentaires facultatives (AAD), qui ne sont pas chiffrées. Lors du déchiffrement, Cipher.doFinal(...) lève cette exception si le tag ne correspond pas. L’exception seule ne permet pas de distinguer une manipulation d’une corruption ou d’entrées incompatibles, comme la clé, l’IV ou l’AAD.

Après un échec, rejetez les données ; n’utilisez aucun texte en clair partiel. Si vous gérez séparément AEADBadTagException et BadPaddingException, placez d’abord le bloc catch le plus spécifique. Ne fondez pas la logique du programme sur le texte du message d’exception.

L’exemple inverse un bit du tag et attend Authentication failed. La clé et l’IV fixes servent uniquement à une démonstration isolée : lors d’un véritable chiffrement GCM, ne réutilisez jamais un IV avec la même clé. La documentation porte sur Java SE 21 ; l’environnement d’exécution de production du dépôt n’a pas été attesté.

Exemples

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

Résultat

Authentication failed

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources