Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources