WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

GCMParameterSpec — Parameter für den GCM-Modus

GCMParameterSpec übergibt einem Cipher einen Initialisierungsvektor und die Länge des Authentifizierungs-Tags. Das Objekt selbst verschlüsselt keine Daten und gewährleistet keine eindeutige IV.

Version: 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 aus javax.crypto.spec beschreibt Parameter für einen GCM-Cipher. tLen gibt die Länge des Authentifizierungs-Tags in Bits an, nicht in Bytes; es ist nicht die Schlüssellänge.

Ein Konstruktor akzeptiert die gesamte IV oder einen durch offset und len in Bytes ausgewählten Teil von src. Die Eingabe wird kopiert; auch getIV() gibt eine neue Kopie zurück. getTLen() gibt die Tag-Länge zurück.

Ein negatives tLen, null oder ungültige Grenzen des Teilbereichs führen zu IllegalArgumentException. Eine erfolgreiche Erstellung garantiert nicht, dass ein Kryptografieanbieter die gewählte Tag-Länge unterstützt.

Übergib diese Parameter für AES/GCM/NoPadding an Cipher.init(...). Verwende beim Verschlüsseln mit demselben Schlüssel niemals eine IV erneut: Dadurch werden Fälschungsangriffe ermöglicht. Das Beispiel zeigt lediglich das Kopieren von Arrays, nicht die sichere Erzeugung einer IV.

Beispiele

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]);
    }
}

Ergebnis

128
12
7

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen