CKTIS / Java
MessageDigest — obliczanie i porównywanie skrótów
MessageDigest oblicza jednokierunkowe skróty danych. Poznaj wybór SHA-256, przetwarzanie bajtów, resetowanie stanu po digest oraz porównywanie wyników przez isEqual.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);MessageDigest z java.security oblicza jednokierunkowy skrót bajtów, a nie szyfruje danych. SHA-256 zwraca 256 bitów, czyli 32 bajty. Zapis szesnastkowy jest tylko reprezentacją wyniku; przy zamianie tekstu na bajty jawnie wybieraj kodowanie, np. StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") pobiera implementację od dostawcy usług kryptograficznych. Brak obsługi żądanego algorytmu powoduje NoSuchAlgorithmException; Java SE 21 wymaga obsługi SHA-256.
Wywołanie md.digest(input) na obiekcie MessageDigest dodaje input do dotychczas zgromadzonych danych i kończy obliczenie. Przy przetwarzaniu fragmentami wywołuj update(...), a następnie digest(). Po zakończeniu obliczenia obiekt wraca do stanu początkowego: kolejne wywołanie nie kontynuuje poprzedniej wiadomości.
MessageDigest.isEqual(a, b) porównuje długości i zawartość skrótów. Nie zastępuj go operatorem ==, który porównuje referencje tablic. Nie traktuj tej metody jako bezwarunkowej gwarancji stałego czasu dla wszystkich argumentów i środowisk. Sam skrót nie uwierzytelnia nadawcy i nie jest szyfrowaniem.
Dokumentacja dotyczy Java SE 21, czyli środowiska uruchomieniowego repozytorium. Środowisko uruchomieniowe na produkcji nie zostało potwierdzone.
Przykłady
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));
}
}Wynik
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.