Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Cipher: cifratura autenticata con AES-GCM

Cipher fornisce cifratura e decifratura tramite i provider crittografici di Java. AES-GCM protegge la riservatezza dei dati e rileva le modifiche. L’uso corretto richiede un IV univoco per ogni chiave e la verifica del tag di autenticazione.

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

Sintassi

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 di javax.crypto è un’interfaccia basata su classi per le operazioni crittografiche implementate da un provider. Cipher.getInstance("AES/GCM/NoPadding") seleziona la trasformazione: algoritmo, modalità e padding. Specifica il nome completo invece di affidarti alle impostazioni predefinite del provider.

Cipher.init imposta la chiave, i parametri e la direzione: Cipher.ENCRYPT_MODE indica la cifratura, mentre Cipher.DECRYPT_MODE indica la decifratura. GCMParameterSpec(128, iv) specifica un tag di autenticazione di 128 bit e l’IV. Cipher.updateAAD aggiunge dati autenticati ma non cifrati; in GCM, passali prima di elaborare il messaggio. La decifratura richiede AAD e parametri identici.

Cipher.doFinal completa l’operazione: la cifratura GCM aggiunge il tag al testo cifrato, mentre la decifratura lo verifica. Una mancata corrispondenza causa AEADBadTagException; rifiuta il risultato e non considerare autentici i dati prima che la verifica si concluda con successo.

Non riutilizzare mai un IV quando cifri con la stessa chiave. Prima di un’altra cifratura, richiama init con un nuovo IV. La chiave e l’IV fissi e noti pubblicamente nell’esempio servono solo per una dimostrazione riproducibile, non per la produzione; le chiavi reali devono essere generate e conservate in modo sicuro.

Esempi

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

Risultato

Hello
21

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti