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

CKTIS / Java

Cipher: удостоверено криптиране с AES-GCM

Cipher предоставя криптиране и декриптиране чрез криптографските доставчици на Java. AES-GCM защитава поверителността на данните и открива промени. Правилната употреба изисква уникален IV за всеки ключ и проверка на маркера за удостоверяване.

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

Синтаксис

Cipher cipher = Cipher.getInstance("AES/GCM/NoPadding");
cipher.init(Cipher.ENCRYPT_MODE, key, new GCMParameterSpec(128, iv));
cipher.updateAAD(aad);
byte[] ciphertextAndTag = cipher.doFinal(plaintext);

Cipher от javax.crypto е интерфейс, базиран на клас, за криптографски операции, реализирани от доставчик. Cipher.getInstance("AES/GCM/NoPadding") избира трансформацията: алгоритъм, режим и допълване. Посочвайте пълното име, вместо да разчитате на настройките по подразбиране на доставчика.

Cipher.init задава ключа, параметрите и посоката: Cipher.ENCRYPT_MODE означава криптиране, а Cipher.DECRYPT_MODE — декриптиране. GCMParameterSpec(128, iv) задава 128-битов маркер за удостоверяване и IV. Cipher.updateAAD добавя удостоверени, но некриптирани данни; при GCM ги подайте преди обработката на съобщението. Декриптирането изисква идентични AAD и параметри.

Cipher.doFinal завършва операцията: при криптиране с GCM маркерът се добавя към шифротекста, а при декриптиране се проверява. Несъответствие води до AEADBadTagException; отхвърлете резултата и не приемайте данните за автентични, преди проверката да завърши успешно.

Никога не използвайте повторно IV при криптиране със същия ключ. Преди следващо криптиране извикайте отново init с нов IV. Фиксираните, публично известни ключ и IV в примера са само за възпроизводима демонстрация, а не за продукционна употреба; реалните ключове трябва да се генерират и съхраняват сигурно.

Примери

import java.nio.charset.StandardCharsets;
import javax.crypto.Cipher;
import javax.crypto.spec.GCMParameterSpec;
import javax.crypto.spec.SecretKeySpec;

public class CipherDemo {
    public static void main(String[] args) throws Exception {
        // Fixed key and IV: reproducible demonstration only, never production.
        var key = new SecretKeySpec(new byte[16], "AES");
        byte[] iv = new byte[12];
        byte[] aad = "record:1".getBytes(StandardCharsets.UTF_8);
        byte[] plaintext = "Hello".getBytes(StandardCharsets.UTF_8);
        var parameters = new GCMParameterSpec(128, iv);

        Cipher encryptor = Cipher.getInstance("AES/GCM/NoPadding");
        encryptor.init(Cipher.ENCRYPT_MODE, key, parameters);
        encryptor.updateAAD(aad);
        byte[] ciphertextAndTag = encryptor.doFinal(plaintext);

        Cipher decryptor = Cipher.getInstance("AES/GCM/NoPadding");
        decryptor.init(Cipher.DECRYPT_MODE, key, parameters);
        decryptor.updateAAD(aad);
        byte[] recovered = decryptor.doFinal(ciphertextAndTag);

        System.out.println(new String(recovered, StandardCharsets.UTF_8));
        System.out.println(ciphertextAndTag.length);
    }
}

Резултат

Hello
21

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

Източници