CKTIS / Java
MessageDigest — calcolare e confrontare gli hash
MessageDigest calcola hash unidirezionali dei dati. Scopri come selezionare SHA-256, elaborare byte, capire il ripristino dopo digest e confrontare i risultati con isEqual.
Versione: Java SE 21; repository runtime, production runtime not attested
Sintassi
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);MessageDigest di java.security calcola un hash unidirezionale di byte, invece di cifrare i dati. SHA-256 restituisce 256 bit, cioè 32 byte. Il testo esadecimale è solo una rappresentazione del risultato; quando converti il testo in byte, scegli esplicitamente una codifica come StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") ottiene un’implementazione da un provider di servizi crittografici. Se l’algoritmo richiesto non è supportato, viene generata NoSuchAlgorithmException; Java SE 21 richiede il supporto di SHA-256.
La chiamata md.digest(input) su un’istanza di MessageDigest aggiunge input ai dati già accumulati e completa il calcolo. Per elaborare i dati a blocchi, chiama update(...) e poi digest(). Al termine del calcolo, l’oggetto torna allo stato iniziale: la chiamata successiva non continua il messaggio precedente.
MessageDigest.isEqual(a, b) confronta lunghezza e contenuto degli hash. Non sostituirlo con ==, che confronta i riferimenti agli array. Non considerare questo metodo una garanzia incondizionata di tempo costante per ogni argomento e ambiente. Un hash da solo non autentica il mittente e non è una cifratura.
Questa documentazione riguarda Java SE 21, l’ambiente di esecuzione del repository. L’ambiente di esecuzione in produzione non è stato attestato.
Esempi
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HexFormat;
public class DigestExample {
public static void main(String[] args) throws NoSuchAlgorithmException {
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] actual = md.digest("abc".getBytes(StandardCharsets.UTF_8));
byte[] expected = HexFormat.of().parseHex(
"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad");
System.out.println(HexFormat.of().formatHex(actual));
System.out.println(MessageDigest.isEqual(actual, expected));
}
}Risultato
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad true
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.