Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

AEADBadTagException — chyba overenia šifrovaného textu

AEADBadTagException znamená, že Cipher pracujúci v režime AEAD, napríklad GCM alebo CCM, nedokázal overiť autentizačnú značku. Údaje odmietnite a nepovažujte ich za úspešne dešifrované.

Verzia: 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 je kontrolovaná výnimka dostupná od Java 7 v balíku javax.crypto modulu java.base. Dedí z BadPaddingException, ale v tomto prípade signalizuje neúspešné overenie značky AEAD, nie bežný problém s paddingom. Konštruktor AEADBadTagException() neposkytuje podrobnú správu; AEADBadTagException(String msg) ju prijíma.

AEAD autentifikuje šifrované údaje a prípadné ďalšie autentizované údaje (AAD), ktoré sa nešifrujú. Pri dešifrovaní vyvolá Cipher.doFinal(...) túto výnimku, ak značka nesúhlasí. Samotná výnimka nerozlišuje medzi manipuláciou, poškodením a nezhodnými vstupmi, ako sú kľúč, IV alebo AAD.

Po chybe údaje odmietnite; nepoužívajte žiadny čiastočný otvorený text. Ak spracúvate AEADBadTagException a BadPaddingException oddelene, umiestnite konkrétnejší blok catch ako prvý. Nezakladajte logiku programu na texte správy výnimky.

Príklad zmení jeden bit značky a očakáva Authentication failed. Pevný kľúč a IV slúžia iba na izolovanú ukážku: pri skutočnom šifrovaní GCM nikdy neopakujte IV s rovnakým kľúčom. Dokumentácia sa vzťahuje na Java SE 21; produkčné runtime prostredie repozitára nebolo potvrdené.

Prí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ýsledok

Authentication failed

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje