CKTIS / Java
GCMParameterSpec — parametry režimu GCM
GCMParameterSpec předává objektu Cipher inicializační vektor a délku autentizační značky. Samotný objekt data nešifruje ani nezajišťuje jedinečnost IV.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()GCMParameterSpec z balíčku javax.crypto.spec popisuje parametry pro Cipher v režimu GCM. tLen udává délku autentizační značky v bitech, nikoli v bajtech; nejde o délku klíče.
Konstruktor přijímá celý IV nebo část src vybranou pomocí offset a len v bajtech. Vstupní data kopíruje; také getIV() vrací novou kopii. getTLen() vrací délku značky.
Záporná hodnota tLen, null nebo neplatné hranice výřezu způsobí IllegalArgumentException. Úspěšné vytvoření objektu nezaručuje, že zvolenou délku značky podporuje poskytovatel kryptografických služeb.
Pro AES/GCM/NoPadding předej tyto parametry metodě Cipher.init(...). Při šifrování stejným klíčem nikdy znovu nepoužívej IV: umožňuje to podvržení zpráv. Příklad ukazuje pouze kopírování polí, nikoli bezpečné generování IV.
Pří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ýsledek
128 12 7
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.