Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

AEADBadTagException — błąd uwierzytelniania szyfrogramu

AEADBadTagException oznacza, że Cipher działający w trybie AEAD, takim jak GCM lub CCM, nie zdołał zweryfikować znacznika uwierzytelniającego. Dane należy odrzucić, a nie traktować ich jako poprawnie odszyfrowane.

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

Składnia

import javax.crypto.AEADBadTagException;

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

javax.crypto.AEADBadTagException jest wyjątkiem kontrolowanym dostępnym od Java 7, w pakiecie javax.crypto modułu java.base. Dziedziczy po BadPaddingException, ale w tym przypadku sygnalizuje nieudaną weryfikację znacznika AEAD, a nie zwykły problem z dopełnieniem. Konstruktor AEADBadTagException() nie ustawia komunikatu szczegółowego; AEADBadTagException(String msg) przyjmuje taki komunikat.

AEAD uwierzytelnia szyfrowane dane oraz opcjonalne dodatkowe dane uwierzytelniane (AAD), które nie są szyfrowane. Przy odszyfrowywaniu Cipher.doFinal(...) zgłasza ten wyjątek, jeśli znacznik nie pasuje. Sam wyjątek nie rozstrzyga, czy przyczyną jest manipulacja, uszkodzenie danych czy niezgodne dane wejściowe, takie jak klucz, IV lub AAD.

Po błędzie odrzuć dane; nie wykorzystuj żadnego częściowego tekstu jawnego. Jeśli obsługujesz osobno AEADBadTagException i BadPaddingException, umieść bardziej szczegółowy blok catch jako pierwszy. Nie uzależniaj logiki od treści komunikatu wyjątku.

Przykład zmienia jeden bit znacznika i oczekuje Authentication failed. Stały klucz i IV służą wyłącznie izolowanej demonstracji: w rzeczywistym szyfrowaniu GCM nigdy nie powtarzaj IV z tym samym kluczem. Zakres dokumentacji to Java SE 21; środowisko produkcyjne repozytorium nie zostało potwierdzone.

Przykłady

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

Wynik

Authentication failed

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła