CKTIS / Java
MessageDigest — izračun i usporedba hash vrijednosti
MessageDigest izračunava jednosmjerne hash vrijednosti podataka. Saznajte kako odabrati SHA-256, obraditi bajtove, razumjeti resetiranje nakon digest i usporediti rezultate pomoću isEqual.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);MessageDigest iz java.security izračunava jednosmjernu hash vrijednost bajtova umjesto da šifrira podatke. SHA-256 vraća 256 bitova, odnosno 32 bajta. Heksadekadski tekst samo je prikaz rezultata; pri pretvaranju teksta u bajtove izričito odaberite kodiranje, primjerice StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") dohvaća implementaciju od pružatelja kriptografskih usluga. Ako traženi algoritam nije podržan, dolazi do iznimke NoSuchAlgorithmException; Java SE 21 zahtijeva podršku za SHA-256.
Poziv md.digest(input) na instanci klase MessageDigest dodaje input već prikupljenim podacima i dovršava izračun. Za obradu u dijelovima pozovite update(...), a zatim digest(). Po dovršetku izračuna objekt se vraća u početno stanje: sljedeći poziv ne nastavlja prethodnu poruku.
MessageDigest.isEqual(a, b) uspoređuje duljinu i sadržaj hash vrijednosti. Nemojte je zamijeniti operatorom ==, koji uspoređuje reference na polja. Nemojte ovu metodu smatrati bezuvjetnim jamstvom konstantnog vremena za sve argumente i okruženja. Sama hash vrijednost ne autentificira pošiljatelja i nije šifriranje.
Ova se dokumentacija odnosi na Java SE 21, izvršno okruženje repozitorija. Produkcijsko izvršno okruženje nije potvrđeno.
Primjeri
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));
}
}Rezultat
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.