CKTIS / Java
GCMParameterSpec — parametre režimu GCM
GCMParameterSpec poskytuje objektu Cipher inicializačný vektor a dĺžku autentifikačnej značky. Samotný objekt údaje nešifruje ani nezaručuje jedinečnosť IV.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()GCMParameterSpec z balíka javax.crypto.spec opisuje parametre pre Cipher v režime GCM. tLen udáva dĺžku autentifikačnej značky v bitoch, nie v bajtoch; nejde o dĺžku kľúča.
Konštruktor prijíma celý IV alebo časť src vybranú pomocou offset a len v bajtoch. Vstupné údaje kopíruje; aj getIV() vracia novú kópiu. getTLen() vracia dĺžku značky.
Záporné tLen, null alebo neplatné hranice výrezu spôsobia IllegalArgumentException. Úspešné vytvorenie objektu nezaručuje, že zvolenú dĺžku značky podporuje poskytovateľ kryptografických služieb.
Pre AES/GCM/NoPadding odovzdaj tieto parametre metóde Cipher.init(...). Pri šifrovaní tým istým kľúčom nikdy znova nepouži IV: umožňuje to falšovanie správ. Príklad ukazuje iba kopírovanie polí, nie bezpečné generovanie IV.
Príklady
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]);
}
}Výsledok
128 12 7
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.