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.