WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Cipher: authentifizierte Verschlüsselung mit AES-GCM

Cipher ermöglicht Ver- und Entschlüsselung über kryptografische Java-Provider. AES-GCM schützt die Vertraulichkeit von Daten und erkennt Änderungen. Die korrekte Verwendung erfordert eine eindeutige IV pro Schlüssel und die Prüfung des Authentifizierungstags.

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

Syntax

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 aus javax.crypto ist eine klassenbasierte Schnittstelle zu kryptografischen Operationen, die von einem Provider implementiert werden. Cipher.getInstance("AES/GCM/NoPadding") wählt die Transformation aus: Algorithmus, Modus und Padding. Gib den vollständigen Namen an, statt dich auf Provider-Standardeinstellungen zu verlassen.

Cipher.init legt Schlüssel, Parameter und Richtung fest: Cipher.ENCRYPT_MODE steht für Verschlüsselung, Cipher.DECRYPT_MODE für Entschlüsselung. GCMParameterSpec(128, iv) gibt einen 128-Bit-Authentifizierungstag und die IV an. Cipher.updateAAD fügt authentifizierte, aber nicht verschlüsselte Daten hinzu; übergib sie bei GCM vor der Verarbeitung der Nachricht. Für die Entschlüsselung müssen AAD und Parameter identisch sein.

Cipher.doFinal schließt den Vorgang ab: Bei der GCM-Verschlüsselung wird der Tag an den Chiffretext angehängt, bei der Entschlüsselung wird er geprüft. Bei einer Abweichung wird AEADBadTagException ausgelöst. Verwirf das Ergebnis und behandle die Daten erst dann als authentisch, wenn die Prüfung erfolgreich abgeschlossen wurde.

Verwende beim Verschlüsseln mit demselben Schlüssel niemals eine IV erneut. Rufe vor einer weiteren Verschlüsselung init erneut mit einer neuen IV auf. Der feste, öffentlich bekannte Schlüssel und die IV im Beispiel dienen nur einer reproduzierbaren Demonstration, nicht dem Produktionseinsatz; echte Schlüssel müssen sicher erzeugt und gespeichert werden.

Beispiele

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

Ergebnis

Hello
21

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen