База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

AEADBadTagException — неуспешна автентикация на шифротекста

AEADBadTagException означава, че Cipher в режим AEAD, например GCM или CCM, не е успял да провери маркера за автентикация. Отхвърлете данните, вместо да ги приемате за успешно декриптирани.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

import javax.crypto.AEADBadTagException;

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

javax.crypto.AEADBadTagException е проверявано изключение, налично от Java 7 в пакета javax.crypto на модула java.base. То наследява BadPaddingException, но тук сигнализира за неуспешна проверка на маркера AEAD, а не за обикновен проблем с padding. Конструкторът AEADBadTagException() не предоставя подробно съобщение; AEADBadTagException(String msg) приема такова.

AEAD удостоверява криптираните данни и незадължителните допълнителни удостоверени данни (AAD), които не се криптират. При декриптиране Cipher.doFinal(...) хвърля това изключение, ако маркерът не съвпада. Самото изключение не различава подправяне от повреда или несъответстващи входни данни, като ключа, IV или AAD.

След грешка отхвърлете данните; не използвайте частичен открит текст. Ако обработвате AEADBadTagException и BadPaddingException отделно, поставете първо по-конкретния блок catch. Не основавайте програмната логика на текста на съобщението за изключението.

Примерът обръща един бит от маркера и очаква Authentication failed. Фиксираните ключ и IV са само за изолирана демонстрация: при реално GCM криптиране никога не повтаряйте IV със същия ключ. Документацията обхваща Java SE 21; производствената среда за изпълнение на хранилището не е потвърдена.

Примери

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

Резултат

Authentication failed

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници