CKTIS / Java
MessageDigest — izračun in primerjava zgoščenih vrednosti
MessageDigest izračuna enosmerne zgoščene vrednosti podatkov. Oglejte si izbiro SHA-256, obdelavo bajtov, ponastavitev po digest in primerjavo rezultatov z isEqual.
Različica: 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čuna enosmerno zgoščeno vrednost bajtov, namesto da bi podatke šifriral. SHA-256 vrne 256 bitov oziroma 32 bajtov. Šestnajstiški zapis je le predstavitev rezultata; pri pretvorbi besedila v bajte izrecno izberite kodiranje, na primer StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") pridobi implementacijo od ponudnika kriptografskih storitev. Če zahtevani algoritem ni podprt, se sproži NoSuchAlgorithmException; Java SE 21 zahteva podporo za SHA-256.
Klic md.digest(input) na primerku razreda MessageDigest doda input že zbranim podatkom in zaključi izračun. Pri obdelavi po delih pokličite update(...) in nato digest(). Po končanem izračunu se objekt vrne v začetno stanje: naslednji klic ne nadaljuje prejšnjega sporočila.
MessageDigest.isEqual(a, b) primerja dolžino in vsebino zgoščenih vrednosti. Ne zamenjajte je z ==, ki primerja reference na polja. Te metode ne obravnavajte kot brezpogojnega jamstva za konstanten čas pri vseh argumentih in v vseh okoljih. Sama zgoščena vrednost ne preveri pristnosti pošiljatelja in ni šifriranje.
Ta dokumentacija se nanaša na Java SE 21, izvajalno okolje repozitorija. Produkcijsko izvajalno okolje ni bilo potrjeno.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.