CKTIS / Java
Cipher: autentifikované šifrovanie pomocou AES-GCM
Cipher poskytuje šifrovanie a dešifrovanie prostredníctvom kryptografických poskytovateľov Javy. AES-GCM chráni dôvernosť údajov a odhaľuje ich zmeny. Správne použitie vyžaduje jedinečné IV pre každý kľúč a overenie autentifikačnej značky.
Verzia: 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 z javax.crypto je rozhranie založené na triede pre kryptografické operácie implementované poskytovateľom. Cipher.getInstance("AES/GCM/NoPadding") vyberá transformáciu: algoritmus, režim a dopĺňanie. Uveďte celý názov namiesto spoliehania sa na predvolené nastavenia poskytovateľa.
Cipher.init nastavuje kľúč, parametre a smer: Cipher.ENCRYPT_MODE znamená šifrovanie a Cipher.DECRYPT_MODE dešifrovanie. GCMParameterSpec(128, iv) určuje 128-bitovú autentifikačnú značku a IV. Cipher.updateAAD pridáva autentifikované, ale nezašifrované údaje; v GCM ich odovzdajte pred spracovaním správy. Dešifrovanie vyžaduje rovnaké AAD a parametre.
Cipher.doFinal dokončí operáciu: pri šifrovaní v režime GCM pripojí značku k šifrovému textu, pri dešifrovaní ju overí. Nezhoda spôsobí AEADBadTagException; výsledok odmietnite a nepovažujte údaje za autentické, kým sa overenie úspešne neskončí.
Pri šifrovaní rovnakým kľúčom nikdy neopakujte IV. Pred ďalším šifrovaním znova zavolajte init s novým IV. Pevne nastavený, verejne známy kľúč a IV v príklade slúžia iba na opakovateľnú ukážku, nie na produkčné použitie; skutočné kľúče treba bezpečne generovať a ukladať.
Prí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ýsledok
Hello 21
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.