База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

MessageDigest — изчисляване и сравняване на хешове

MessageDigest изчислява еднопосочни хешове на данни. Научете как да изберете SHA-256, да обработвате байтове, да разбирате нулирането след digest и да сравнявате резултати с isEqual.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);

MessageDigest от java.security изчислява еднопосочен хеш на байтове, вместо да криптира данни. SHA-256 връща 256 бита, или 32 байта. Шестнадесетичният текст е само представяне на резултата; при преобразуване на текст в байтове изрично изберете кодиране като StandardCharsets.UTF_8.

MessageDigest.getInstance("SHA-256") получава реализация от доставчик на криптографски услуги. Ако заявеният алгоритъм не се поддържа, възниква NoSuchAlgorithmException; Java SE 21 изисква поддръжка на SHA-256.

Извикването на md.digest(input) върху обект от клас MessageDigest добавя input към вече натрупаните данни и завършва изчислението. При обработка на части извикайте update(...), а след това digest(). След завършване на изчислението обектът се връща в началното си състояние: следващото извикване не продължава предишното съобщение.

MessageDigest.isEqual(a, b) сравнява дължината и съдържанието на хешовете. Не я заменяйте с ==, който сравнява препратките към масивите. Не приемайте този метод за безусловна гаранция за постоянно време при всякакви аргументи и среди. Сам по себе си хешът не удостоверява подателя и не е криптиране.

Тази документация се отнася за Java SE 21, средата за изпълнение на хранилището. Производствената среда за изпълнение не е удостоверена.

Примери

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));
    }
}

Резултат

ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad
true

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници