CKTIS / Java
GCMParameterSpec — parametri načina GCM
GCMParameterSpec objektu Cipher posreduje inicializacijski vektor in dolžino overitvene oznake. Sam objekt ne šifrira podatkov in ne zagotavlja enoličnosti IV.
Različica: 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 v načinu GCM. tLen določa dolžino overitvene oznake v bitih, ne v bajtih; to ni dolžina ključa.
Konstruktor sprejme celoten IV ali del src, izbran z offset in len v bajtih. Vhodne podatke kopira; tudi getIV() vrne novo kopijo. getTLen() vrne dolžino oznake.
Negativna vrednost tLen, null ali neveljavne meje izseka povzročijo IllegalArgumentException. Uspešna izdelava objekta ne zagotavlja, da ponudnik kriptografskih storitev podpira izbrano dolžino oznake.
Za AES/GCM/NoPadding te parametre posreduj metodi Cipher.init(...). Pri šifriranju z istim ključem nikoli znova ne uporabi IV: to omogoča ponarejanje sporočil. Primer prikazuje samo kopiranje polj, ne varnega ustvarjanja IV.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.