Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

GCMParameterSpec — parametre režimu GCM

GCMParameterSpec poskytuje objektu Cipher inicializačný vektor a dĺžku autentifikačnej značky. Samotný objekt údaje nešifruje ani nezaručuje jedinečnosť IV.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()

GCMParameterSpec z balíka javax.crypto.spec opisuje parametre pre Cipher v režime GCM. tLen udáva dĺžku autentifikačnej značky v bitoch, nie v bajtoch; nejde o dĺžku kľúča.

Konštruktor prijíma celý IV alebo časť src vybranú pomocou offset a len v bajtoch. Vstupné údaje kopíruje; aj getIV() vracia novú kópiu. getTLen() vracia dĺžku značky.

Záporné tLen, null alebo neplatné hranice výrezu spôsobia IllegalArgumentException. Úspešné vytvorenie objektu nezaručuje, že zvolenú dĺžku značky podporuje poskytovateľ kryptografických služieb.

Pre AES/GCM/NoPadding odovzdaj tieto parametre metóde Cipher.init(...). Pri šifrovaní tým istým kľúčom nikdy znova nepouži IV: umožňuje to falšovanie správ. Príklad ukazuje iba kopírovanie polí, nie bezpečné generovanie IV.

Prí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ýsledok

128
12
7

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje