CKTIS / Java
Cipher: geauthenticeerde versleuteling met AES-GCM
Cipher biedt versleuteling en ontsleuteling via cryptografische Java-providers. AES-GCM beschermt de vertrouwelijkheid van gegevens en detecteert wijzigingen. Correct gebruik vereist een unieke IV per sleutel en verificatie van de authenticatietag.
Versie: 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 uit javax.crypto is een op klassen gebaseerde interface voor cryptografische bewerkingen die door een provider worden geïmplementeerd. Cipher.getInstance("AES/GCM/NoPadding") selecteert de transformatie: algoritme, modus en padding. Geef de volledige naam op in plaats van te vertrouwen op standaardinstellingen van de provider.
Cipher.init stelt de sleutel, parameters en richting in: Cipher.ENCRYPT_MODE betekent versleuteling en Cipher.DECRYPT_MODE ontsleuteling. GCMParameterSpec(128, iv) specificeert een authenticatietag van 128 bits en de IV. Cipher.updateAAD voegt geauthenticeerde maar niet-versleutelde gegevens toe; geef deze bij GCM door voordat je het bericht verwerkt. Voor ontsleuteling zijn dezelfde AAD en parameters vereist.
Cipher.doFinal voltooit de bewerking: bij GCM-versleuteling wordt de tag aan de ciphertext toegevoegd, en bij ontsleuteling wordt de tag gecontroleerd. Een afwijking veroorzaakt AEADBadTagException; verwerp het resultaat en behandel de gegevens pas als authentiek nadat de verificatie met succes is voltooid.
Gebruik bij versleuteling met dezelfde sleutel nooit een IV opnieuw. Roep vóór een volgende versleuteling init opnieuw aan met een nieuwe IV. De vaste, algemeen bekende sleutel en IV in het voorbeeld zijn alleen bedoeld voor een reproduceerbare demonstratie, niet voor productie; echte sleutels moeten veilig worden gegenereerd en opgeslagen.
Voorbeelden
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);
}
}Resultaat
Hello 21
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.