CKTIS / Java
Cipher: overjeno šifriranje z AES-GCM
Cipher omogoča šifriranje in dešifriranje prek kriptografskih ponudnikov Jave. AES-GCM varuje zaupnost podatkov in zazna spremembe. Pravilna uporaba zahteva enoličen IV za vsak ključ in preverjanje avtentikacijske oznake.
Različica: 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 je vmesnik, zasnovan na razredu, za kriptografske operacije, ki jih izvaja ponudnik. Cipher.getInstance("AES/GCM/NoPadding") izbere transformacijo: algoritem, način in dopolnjevanje. Navedite polno ime, namesto da se zanašate na privzete nastavitve ponudnika.
Cipher.init nastavi ključ, parametre in smer: Cipher.ENCRYPT_MODE pomeni šifriranje, Cipher.DECRYPT_MODE pa dešifriranje. GCMParameterSpec(128, iv) določa 128-bitno avtentikacijsko oznako in IV. Cipher.updateAAD doda avtenticirane, vendar nešifrirane podatke; v GCM jih posredujte pred obdelavo sporočila. Dešifriranje zahteva enake AAD in parametre.
Cipher.doFinal zaključi operacijo: pri šifriranju GCM doda oznako šifriranemu besedilu, pri dešifriranju pa jo preveri. Neujemanje povzroči AEADBadTagException; rezultat zavrnite in podatkov ne obravnavajte kot pristnih, dokler preverjanje ni uspešno končano.
Pri šifriranju z istim ključem nikoli znova ne uporabite IV. Pred naslednjim šifriranjem znova pokličite init z novim IV. Nespremenljivi, javno znani ključ in IV v primeru sta namenjena samo ponovljivi predstavitvi, ne uporabi v produkciji; prave ključe je treba varno ustvariti in shraniti.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.