CKTIS / Java
Cipher: autentificirano šifriranje pomoću AES-GCM-a
Cipher omogućuje šifriranje i dešifriranje putem kriptografskih pružatelja za Javu. AES-GCM štiti povjerljivost podataka i otkriva njihove izmjene. Ispravna upotreba zahtijeva jedinstveni IV za svaki ključ i provjeru autentifikacijske oznake.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
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 iz javax.crypto sučelje je zasnovano na klasi za kriptografske operacije koje implementira pružatelj. Cipher.getInstance("AES/GCM/NoPadding") odabire transformaciju: algoritam, način rada i nadopunu. Navedite puni naziv umjesto da se oslanjate na zadane postavke pružatelja.
Cipher.init postavlja ključ, parametre i smjer: Cipher.ENCRYPT_MODE znači šifriranje, a Cipher.DECRYPT_MODE dešifriranje. GCMParameterSpec(128, iv) određuje 128-bitnu autentifikacijsku oznaku i IV. Cipher.updateAAD dodaje autentificirane, ali nešifrirane podatke; u GCM-u ih predajte prije obrade poruke. Dešifriranje zahtijeva iste AAD i parametre.
Cipher.doFinal dovršava operaciju: šifriranje GCM-om dodaje oznaku šifriranom tekstu, a dešifriranje je provjerava. Nepodudaranje uzrokuje AEADBadTagException; odbacite rezultat i nemojte smatrati podatke autentičnima prije uspješnog dovršetka provjere.
Nikada nemojte ponovno upotrijebiti IV pri šifriranju istim ključem. Prije sljedećeg šifriranja ponovno pozovite init s novim IV-om. Fiksni, javno poznati ključ i IV u primjeru služe samo za ponovljivu demonstraciju, a ne za produkciju; stvarne ključeve treba sigurno generirati i pohraniti.
Primjeri
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);
}
}Rezultat
Hello 21
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.