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

CKTIS / Java

Mac : authentifier des messages avec HMAC

La classe javax.crypto.Mac calcule un code d’authentification de message à l’aide d’une clé secrète. Découvrez comment sélectionner HmacSHA256, initialiser l’objet avec une clé et terminer le calcul avec doFinal.

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

Syntaxe

Mac mac = Mac.getInstance("HmacSHA256");
mac.init(key);
byte[] tag = mac.doFinal(messageBytes);

Mac dans javax.crypto calcule un code d’authentification de message (MAC). Il permet de vérifier l’intégrité des données à l’aide d’une clé secrète partagée ; il ne chiffre pas le message. HMAC est une construction MAC fondée sur une fonction de hachage cryptographique.

Mac.getInstance("HmacSHA256") sélectionne une implémentation de l’algorithme parmi les fournisseurs cryptographiques. Mac.init(key) initialise l’objet avec une clé. Mac.doFinal(messageBytes) traite les octets et renvoie le tag. Vous pouvez également fournir des blocs avec update, puis appeler doFinal().

À la fin, doFinal rétablit l’état initialisé et conserve la clé pour le message suivant. Une autre clé nécessite un nouvel appel à init. L’absence d’initialisation provoque IllegalStateException ; une clé inadaptée peut provoquer InvalidKeyException, et un algorithme indisponible provoque NoSuchAlgorithmException.

L’exemple utilise une clé publique et courte uniquement pour un test reproductible. Ne l’utilisez pas en production : fournissez une clé secrète générée et protégée de manière appropriée. La documentation porte sur Java SE 21 ; l’environnement d’exécution de production n’a pas été attesté.

Exemples

import java.nio.charset.StandardCharsets;
import java.util.HexFormat;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

public class MacExample {
    public static void main(String[] args) throws Exception {
        // Public test key only; never use it in production.
        byte[] keyBytes = "key".getBytes(StandardCharsets.UTF_8);
        byte[] message = "The quick brown fox jumps over the lazy dog"
                .getBytes(StandardCharsets.UTF_8);

        Mac mac = Mac.getInstance("HmacSHA256");
        mac.init(new SecretKeySpec(keyBytes, "HmacSHA256"));
        byte[] tag = mac.doFinal(message);
        System.out.println(HexFormat.of().formatHex(tag));
    }
}

Résultat

f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8

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