Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti