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

CKTIS / Java

Cipher: autentizované šifrování pomocí AES-GCM

Cipher poskytuje šifrování a dešifrování prostřednictvím kryptografických poskytovatelů Javy. AES-GCM chrání důvěrnost dat a odhaluje jejich změny. Správné použití vyžaduje jedinečné IV pro každý klíč a ověření autentizační značky.

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

Syntaxe

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 je rozhraní založené na třídě pro kryptografické operace implementované poskytovatelem. Cipher.getInstance("AES/GCM/NoPadding") vybírá transformaci: algoritmus, režim a doplňování. Uveďte celý název, místo abyste spoléhali na výchozí nastavení poskytovatele.

Cipher.init nastavuje klíč, parametry a směr: Cipher.ENCRYPT_MODE znamená šifrování a Cipher.DECRYPT_MODE dešifrování. GCMParameterSpec(128, iv) určuje 128bitovou autentizační značku a IV. Cipher.updateAAD přidává autentizovaná, ale nezašifrovaná data; v GCM je předejte před zpracováním zprávy. Dešifrování vyžaduje totožné AAD a parametry.

Cipher.doFinal dokončí operaci: při šifrování v režimu GCM připojí značku k šifrovému textu, při dešifrování ji ověří. Neshoda způsobí AEADBadTagException; výsledek odmítněte a nepovažujte data za autentická, dokud ověření úspěšně neskončí.

Při šifrování stejným klíčem nikdy neopakujte IV. Před dalším šifrováním znovu zavolejte init s novým IV. Pevně nastavený, veřejně známý klíč a IV v příkladu slouží pouze k opakovatelné demonstraci, nikoli k produkčnímu použití; skutečné klíče je nutné bezpečně generovat a ukládat.

Příklady

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

Výsledek

Hello
21

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