Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

GCMParameterSpec — parametri načina GCM

GCMParameterSpec objektu Cipher daje inicijalizacijski vektor i duljinu autentikacijske oznake. Sam objekt ne šifrira podatke niti jamči jedinstvenost IV-a.

Verzija: 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 u načinu GCM. tLen označava duljinu autentikacijske oznake u bitovima, a ne u bajtovima; to nije duljina ključa.

Konstruktor prihvaća cijeli IV ili dio niza src odabran pomoću offset i len u bajtovima. Kopira ulazne podatke; i getIV() vraća novu kopiju. getTLen() vraća duljinu oznake.

Negativan tLen, null ili nevažeće granice isječka uzrokuju IllegalArgumentException. Uspješno stvaranje objekta ne jamči da kriptografski pružatelj podržava odabranu duljinu oznake.

Za AES/GCM/NoPadding proslijedi te parametre metodi Cipher.init(...). Nikad nemoj ponovno upotrijebiti IV pri šifriranju istim ključem: to omogućuje krivotvorenje poruka. Primjer prikazuje samo kopiranje polja, a ne sigurno generiranje IV-a.

Primjeri

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

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori