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

CKTIS / Java

SecretKeySpec — une clé à partir d’un tableau d’octets

SecretKeySpec encapsule des octets de clé existants et un nom d’algorithme. Elle copie les données, mais ne vérifie pas leur validité cryptographique.

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

Syntaxe

new SecretKeySpec(byte[] key, String algorithm)
new SecretKeySpec(byte[] key, int offset, int len, String algorithm)

javax.crypto.spec.SecretKeySpec implémente SecretKey et KeySpec, indépendamment d’un fournisseur. Elle encapsule des octets bruts ; elle ne génère pas de clé et n’en dérive pas une à partir d’un mot de passe.

Le constructeur copie le tableau entier ou len octets à partir de offset. Il ne vérifie pas la validité de la clé pour l’algorithme. La surcharge à deux arguments rejette null et un tableau vide avec IllegalArgumentException.

getAlgorithm() renvoie le nom de l’algorithme, getFormat() renvoie RAW et getEncoded() renvoie une nouvelle copie des octets. La copie ne signifie ni chiffrement ni stockage sécurisé.

L’exemple montre les deux copies défensives. Les octets fixes sont réservés à la démonstration ; ne les utilisez pas comme clé en production.

Exemples

import javax.crypto.spec.SecretKeySpec;

public class Main {
    public static void main(String[] args) {
        byte[] bytes = new byte[16];
        bytes[0] = 7;
        SecretKeySpec key = new SecretKeySpec(bytes, "AES");
        bytes[0] = 9;
        byte[] exported = key.getEncoded();
        exported[0] = 11;
        System.out.println(key.getAlgorithm());
        System.out.println(key.getFormat());
        System.out.println(key.getEncoded()[0]);
    }
}

Résultat

AES
RAW
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