CKTIS / Java
MessageDigest — Hashes berechnen und vergleichen
MessageDigest berechnet Einweg-Hashes von Daten. Erfahre, wie du SHA-256 auswählst, Bytes verarbeitest, das Zurücksetzen nach digest verstehst und Ergebnisse mit isEqual vergleichst.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);MessageDigest aus java.security berechnet einen Einweg-Hash von Bytes, statt Daten zu verschlüsseln. SHA-256 liefert 256 Bit, also 32 Byte. Hexadezimaltext ist lediglich eine Darstellung des Ergebnisses; wähle beim Umwandeln von Text in Bytes ausdrücklich eine Kodierung wie StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") bezieht eine Implementierung von einem kryptografischen Dienstanbieter. Wird der angeforderte Algorithmus nicht unterstützt, tritt NoSuchAlgorithmException auf; Java SE 21 schreibt die Unterstützung von SHA-256 vor.
Der Aufruf md.digest(input) auf einer MessageDigest-Instanz fügt input zu den bereits gesammelten Daten hinzu und schließt die Berechnung ab. Bei der Verarbeitung in Teilen rufe zuerst update(...) und anschließend digest() auf. Nach Abschluss der Berechnung wird das Objekt auf seinen Ausgangszustand zurückgesetzt: Der nächste Aufruf setzt die vorherige Nachricht nicht fort.
MessageDigest.isEqual(a, b) vergleicht Länge und Inhalt der Hashes. Ersetze die Methode nicht durch ==, denn damit werden Array-Referenzen verglichen. Sie bietet nicht für alle Argumente und Umgebungen uneingeschränkt eine Garantie für konstante Laufzeit. Ein Hash allein authentifiziert keinen Absender und ist keine Verschlüsselung.
Diese Dokumentation bezieht sich auf Java SE 21, die Laufzeitumgebung des Repositorys. Die Laufzeitumgebung im Produktivbetrieb wurde nicht bestätigt.
Beispiele
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));
}
}Ergebnis
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.