CKTIS / Java
GCMParameterSpec — parametri načina GCM
GCMParameterSpec objektu Cipher daje inicijalizacijski vektor i duljinu autentikacijske oznake. Sam objekt ne šifrira podatke niti jamči jedinstvenost IV-a.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()GCMParameterSpec iz paketa javax.crypto.spec opisuje parametre za Cipher u načinu GCM. tLen označava duljinu autentikacijske oznake u bitovima, a ne u bajtovima; to nije duljina ključa.
Konstruktor prihvaća cijeli IV ili dio niza src odabran pomoću offset i len u bajtovima. Kopira ulazne podatke; i getIV() vraća novu kopiju. getTLen() vraća duljinu oznake.
Negativan tLen, null ili nevažeće granice isječka uzrokuju IllegalArgumentException. Uspješno stvaranje objekta ne jamči da kriptografski pružatelj podržava odabranu duljinu oznake.
Za AES/GCM/NoPadding proslijedi te parametre metodi Cipher.init(...). Nikad nemoj ponovno upotrijebiti IV pri šifriranju istim ključem: to omogućuje krivotvorenje poruka. Primjer prikazuje samo kopiranje polja, a ne sigurno generiranje IV-a.
Primjeri
import javax.crypto.spec.GCMParameterSpec;
public class Main {
public static void main(String[] args) {
byte[] iv = new byte[12];
iv[0] = 7;
GCMParameterSpec spec = new GCMParameterSpec(128, iv);
iv[0] = 9;
byte[] copy = spec.getIV();
copy[0] = 11;
System.out.println(spec.getTLen());
System.out.println(spec.getIV().length);
System.out.println(spec.getIV()[0]);
}
}Rezultat
128 12 7
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.