Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Mac: autenticare i messaggi con HMAC

La classe javax.crypto.Mac calcola un codice di autenticazione del messaggio usando una chiave segreta. Scopri come selezionare HmacSHA256, inizializzare l’oggetto con una chiave e terminare il calcolo con doFinal.

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

Sintassi

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

Mac di javax.crypto calcola un codice di autenticazione del messaggio (MAC). Consente di verificare l’integrità dei dati usando una chiave segreta condivisa; non cifra il messaggio. HMAC è una costruzione MAC basata su una funzione hash crittografica.

Mac.getInstance("HmacSHA256") seleziona un’implementazione dell’algoritmo tra i provider crittografici. Mac.init(key) inizializza l’oggetto con una chiave. Mac.doFinal(messageBytes) elabora i byte e restituisce il tag. In alternativa, puoi fornire blocchi tramite update e poi chiamare doFinal().

Al termine, doFinal ripristina lo stato inizializzato e conserva la chiave per il messaggio successivo. Per usare una chiave diversa è necessario chiamare di nuovo init. La mancata inizializzazione causa IllegalStateException; una chiave non adatta può causare InvalidKeyException, mentre un algoritmo non disponibile causa NoSuchAlgorithmException.

L’esempio usa una chiave pubblica e breve esclusivamente per un test ripetibile. Non usarla in produzione: fornisci una chiave segreta generata e protetta in modo adeguato. L’ambito della documentazione è Java SE 21; l’ambiente di runtime di produzione non è stato attestato.

Esempi

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));
    }
}

Risultato

f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti