Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła