Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Cipher: szyfrowanie uwierzytelnione AES-GCM

Cipher udostępnia szyfrowanie i deszyfrowanie przez dostawców kryptograficznych Javy. AES-GCM chroni poufność danych i wykrywa ich modyfikacje; poprawne użycie wymaga unikalnego IV dla danego klucza oraz sprawdzenia znacznika uwierzytelniającego.

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

Składnia

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 z javax.crypto to interfejs klasowy do operacji kryptograficznych realizowanych przez dostawcę. Cipher.getInstance("AES/GCM/NoPadding") wybiera transformację: algorytm, tryb i dopełnienie. Podawaj pełną nazwę, zamiast polegać na domyślnych ustawieniach dostawcy.

Cipher.init ustawia klucz, parametry i kierunek: Cipher.ENCRYPT_MODE oznacza szyfrowanie, a Cipher.DECRYPT_MODE — deszyfrowanie. GCMParameterSpec(128, iv) określa 128-bitowy znacznik uwierzytelniający oraz IV. Cipher.updateAAD dodaje dane uwierzytelniane, ale nieszyfrowane; w GCM przekaż je przed przetwarzaniem wiadomości. Deszyfrowanie wymaga identycznych AAD i parametrów.

Cipher.doFinal kończy operację: przy szyfrowaniu GCM dołącza znacznik do szyfrogramu, a przy deszyfrowaniu go sprawdza. Niezgodność powoduje AEADBadTagException; odrzuć wynik i nie traktuj danych jako autentycznych przed pomyślnym zakończeniem weryfikacji.

Nigdy nie powtarzaj IV przy szyfrowaniu tym samym kluczem. Przed kolejnym szyfrowaniem ponownie wywołaj init z nowym IV. Stały, publicznie znany klucz i IV w przykładzie służą wyłącznie powtarzalnej demonstracji, nie produkcji; rzeczywiste klucze wymagają bezpiecznego generowania i przechowywania.

Przykłady

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

Wynik

Hello
21

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

Źródła