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.