CKTIS / Java
Cipher: cifrado autenticado con AES-GCM
Cipher ofrece cifrado y descifrado mediante proveedores criptográficos de Java. AES-GCM protege la confidencialidad de los datos y detecta modificaciones. Para usarlo correctamente, se necesita un IV único para cada clave y verificar la etiqueta de autenticación.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
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 de javax.crypto es una interfaz basada en clases para operaciones criptográficas implementadas por un proveedor. Cipher.getInstance("AES/GCM/NoPadding") selecciona la transformación: algoritmo, modo y relleno. Indica el nombre completo en vez de depender de los valores predeterminados del proveedor.
Cipher.init establece la clave, los parámetros y la dirección: Cipher.ENCRYPT_MODE indica cifrado y Cipher.DECRYPT_MODE, descifrado. GCMParameterSpec(128, iv) especifica una etiqueta de autenticación de 128 bits y el IV. Cipher.updateAAD añade datos autenticados pero no cifrados; en GCM, pásalos antes de procesar el mensaje. El descifrado requiere los mismos AAD y parámetros.
Cipher.doFinal completa la operación: el cifrado GCM añade la etiqueta al texto cifrado, mientras que el descifrado la verifica. Si no coincide, se produce AEADBadTagException; rechaza el resultado y no consideres auténticos los datos hasta que la verificación termine correctamente.
Nunca repitas un IV al cifrar con la misma clave. Antes de otro cifrado, vuelve a llamar a init con un IV nuevo. La clave y el IV fijos y de conocimiento público del ejemplo son solo para una demostración reproducible, no para producción; las claves reales requieren generación y almacenamiento seguros.
Ejemplos
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);
}
}Resultado
Hello 21
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.