CKTIS / Java
GCMParameterSpec — paramètres du mode GCM
GCMParameterSpec fournit à Cipher un vecteur d’initialisation et la longueur de l’étiquette d’authentification. L’objet lui-même ne chiffre pas les données et ne garantit pas l’unicité de l’IV.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
public GCMParameterSpec(int tLen, byte[] src)
public GCMParameterSpec(int tLen, byte[] src, int offset, int len)
int getTLen()
byte[] getIV()GCMParameterSpec, dans javax.crypto.spec, décrit les paramètres d’un Cipher en mode GCM. tLen indique la longueur de l’étiquette d’authentification en bits, et non en octets ; ce n’est pas la longueur de la clé.
Un constructeur accepte l’IV entier ou une partie de src sélectionnée par offset et len, en octets. Il copie les données d’entrée ; getIV() renvoie également une nouvelle copie. getTLen() renvoie la longueur de l’étiquette.
Une valeur tLen négative, null ou des limites de tranche incorrectes provoquent IllegalArgumentException. La création de l’objet ne garantit pas qu’un fournisseur cryptographique accepte la longueur d’étiquette choisie.
Pour AES/GCM/NoPadding, transmettez ces paramètres à Cipher.init(...). Ne réutilisez jamais un IV pour chiffrer avec la même clé : cela permet des attaques par falsification. L’exemple montre uniquement la copie de tableaux, et non la génération sécurisée d’un IV.
Exemples
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]);
}
}Résultat
128 12 7
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.