CKTIS / Java
GCMParameterSpec — parametry trybu GCM
GCMParameterSpec przekazuje do Cipher wektor inicjalizujący oraz długość znacznika uwierzytelniającego. Sam obiekt nie szyfruje danych ani nie zapewnia unikalności IV.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()GCMParameterSpec z pakietu javax.crypto.spec opisuje parametry dla Cipher w trybie GCM. tLen podaje długość znacznika uwierzytelniającego w bitach, nie bajtach; nie jest długością klucza.
Konstruktor przyjmuje cały IV lub fragment src wskazany przez offset i len w bajtach. Kopiuje dane wejściowe; getIV() również zwraca nową kopię. getTLen() zwraca długość znacznika.
Ujemne tLen, null lub nieprawidłowe granice fragmentu powodują IllegalArgumentException. Utworzenie obiektu nie gwarantuje, że dostawca kryptograficzny obsłuży wybraną długość znacznika.
Dla AES/GCM/NoPadding przekazuj te parametry do Cipher.init(...). Nie powtarzaj IV przy szyfrowaniu tym samym kluczem: grozi to fałszowaniem wiadomości. Przykład pokazuje tylko kopiowanie tablic, nie bezpieczne generowanie IV.
Przykłady
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]);
}
}Wynik
128 12 7
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.