Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

GCMParameterSpec — parametri načina GCM

GCMParameterSpec objektu Cipher posreduje inicializacijski vektor in dolžino overitvene oznake. Sam objekt ne šifrira podatkov in ne zagotavlja enoličnosti IV.

Različica: 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 v načinu GCM. tLen določa dolžino overitvene oznake v bitih, ne v bajtih; to ni dolžina ključa.

Konstruktor sprejme celoten IV ali del src, izbran z offset in len v bajtih. Vhodne podatke kopira; tudi getIV() vrne novo kopijo. getTLen() vrne dolžino oznake.

Negativna vrednost tLen, null ali neveljavne meje izseka povzročijo IllegalArgumentException. Uspešna izdelava objekta ne zagotavlja, da ponudnik kriptografskih storitev podpira izbrano dolžino oznake.

Za AES/GCM/NoPadding te parametre posreduj metodi Cipher.init(...). Pri šifriranju z istim ključem nikoli znova ne uporabi IV: to omogoča ponarejanje sporočil. Primer prikazuje samo kopiranje polj, ne varnega ustvarjanja IV.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri