Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

AEADBadTagException — chyba ověření šifrovaného textu

AEADBadTagException znamená, že Cipher pracující v režimu AEAD, například GCM nebo CCM, nedokázal ověřit autentizační značku. Data odmítněte a nepovažujte je za úspěšně dešifrovaná.

Verze: 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 je kontrolovaná výjimka dostupná od Java 7 v balíčku javax.crypto modulu java.base. Dědí z BadPaddingException, ale zde signalizuje neúspěšné ověření značky AEAD, nikoli běžný problém s paddingem. Konstruktor AEADBadTagException() neposkytuje podrobnou zprávu; AEADBadTagException(String msg) ji přijímá.

AEAD ověřuje šifrovaná data a případná další autentizovaná data (AAD), která se nešifrují. Při dešifrování vyvolá Cipher.doFinal(...) tuto výjimku, pokud značka nesouhlasí. Samotná výjimka nerozlišuje mezi manipulací, poškozením a neodpovídajícími vstupy, jako jsou klíč, IV nebo AAD.

Po chybě data odmítněte; nepoužívejte žádný částečný prostý text. Pokud zpracováváte AEADBadTagException a BadPaddingException odděleně, umístěte konkrétnější blok catch jako první. Nezakládejte logiku programu na textu zprávy výjimky.

Příklad změní jeden bit značky a očekává Authentication failed. Pevný klíč a IV slouží pouze pro izolovanou demonstraci: při skutečném šifrování GCM nikdy neopakujte IV se stejným klíčem. Dokumentace se vztahuje k Java SE 21; produkční běhové prostředí repozitáře nebylo potvrzeno.

Příklady

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

Výsledek

Authentication failed

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje