GetMessageDigest: примеры (JAVA)

Короткие примеры

Пример 1. Получение SHA-256 хеша строки и вывод в hex.

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class Example1 {
    public static void main(String[] args) throws NoSuchAlgorithmException {
        MessageDigest md = MessageDigest.getInstance("SHA-256");
        byte[] digest = md.digest("hello".getBytes());
        System.out.println(bytesToHex(digest));
    }

    private static String bytesToHex(byte[] bytes) {
        StringBuilder sb = new StringBuilder();
        for (byte b : bytes) sb.append(String.format("%02x", b));
        return sb.toString();
    }
}

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

Пример 2. Быстрая утилита getMessageDigestHex возвращающая hex-строку для произвольных данных.

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

public class Util {
    public static String getMessageDigestHex(String algorithm, byte[] data) throws NoSuchAlgorithmException {
        MessageDigest md = MessageDigest.getInstance(algorithm);
        byte[] digest = md.digest(data);
        StringBuilder sb = new StringBuilder();
        for (byte b : digest) sb.append(String.format("%02x", b));
        return sb.toString();
    }

    public static void main(String[] args) throws NoSuchAlgorithmException {
        System.out.println(getMessageDigestHex("MD5", "hello".getBytes()));
    }
}

5d41402abc4b2a76b9719d911017c592

Пример 3. Получение алгоритма с указанием провайдера (возможный NoSuchProviderException при неверном имени).

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.security.NoSuchProviderException;

public class Example3 {
    public static void main(String[] args) throws NoSuchAlgorithmException, NoSuchProviderException {
        MessageDigest md = MessageDigest.getInstance("SHA-1", "SUN");
        byte[] digest = md.digest("hello".getBytes());
        System.out.println(bytesToHex(digest));
    }

    private static String bytesToHex(byte[] bytes) {
        StringBuilder sb = new StringBuilder();
        for (byte b : bytes) sb.append(String.format("%02x", b));
        return sb.toString();
    }
}

aaf4c61ddcc5e8a2dabede0f3b482cd9aea9434d

Похожие возможности в Java

• DigestInputStream - поток-обёртка, автоматически обновляющая MessageDigest при чтении данных; удобна для больших файлов.
• Mac (javax.crypto.Mac) - HMAC для аутентификации сообщений; предпочтительнее для проверки целостности с секретным ключом.
• Signature - асимметричные подписи, используется при необходимости подтверждения авторства, а не только целостности.
• Сторонние библиотеки (Guava Hashing, Apache Commons Codec DigestUtils) - предлагают удобные методы для хеширования и форматирования.

Когда что предпочесть:

• Для простого хеширования файлов и строк подойдёт MessageDigest.
• Для защиты от подделки с секретом - Mac (HMAC).
• Для электронной подписи с открытым ключом - Signature.
• Для удобства API и меньшего кода - Guava или Apache Commons для повседневных задач.

Альтернативы в других языках

Код на разных языках даёт тот же алгоритмический результат, но API отличается.

JavaScript (Node.js, SHA-256):

const crypto = require('crypto');
console.log(crypto.createHash('sha256').update('hello').digest('hex'));

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

Браузерный Web Crypto API (асинхронно):

const enc = new TextEncoder();
crypto.subtle.digest('SHA-256', enc.encode('hello')).then(buf => {
  const h = Array.from(new Uint8Array(buf)).map(b => b.toString(16).padStart(2,'0')).join('');
  console.log(h);
});

Python (hashlib):

import hashlib
print(hashlib.sha256(b'hello').hexdigest())

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

PHP (hash):

echo hash('sha256', 'hello');

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

C# (.NET):

using System;
using System.Security.Cryptography;
using System.Text;

class P { static void Main(){
  using(var sha = SHA256.Create()){
    var h = sha.ComputeHash(Encoding.UTF8.GetBytes("hello"));
    Console.WriteLine(BitConverter.ToString(h).Replace("-","").ToLower());
  }
}}

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

Go (golang):

package main
import (
  "crypto/sha256"
  "fmt"
)
func main(){
  h := sha256.Sum256([]byte("hello"))
  fmt.Printf("%x\n", h)
}

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

Отличия от Java:

• В Java требуется работа с провайдерами и возможные исключения, в многих скриптовых языках API более компактный.
• Браузерный Web Crypto API асинхронен и возвращает ArrayBuffer, тогда как серверные API часто блокирующие.
• HMAC и PBKDF2 реализуются отдельными объектами/функциями в разных средах.

Типичные ошибки

• Неверная интерпретация байтов: печать дайджеста как new String(digest) приводит к нечитаемому выводу.
• Неправильный алгоритм: указание несуществующего алгоритма вызывает NoSuchAlgorithmException.
• Переиспользование без reset: после digest объект автоматически сбрасывается, но при последовательных update/digest можно получить неожиданные результаты при неправильной логике.
• Сравнение через Arrays.equals для секретных значений: лучше MessageDigest.isEqual для уменьшения риска атак по времени.
• Игнорирование кодировок: использование разных Charset при конвертации строки в байты приводит к различным хешам.

Пример неправильного вывода:

MessageDigest md = MessageDigest.getInstance("MD5");
byte[] d = md.digest("hello".getBytes());
System.out.println(new String(d)); // не hex, не читаемо

����+��*v�	��
�

Пример обработки исключения при несуществующем алгоритме:

try {
  MessageDigest.getInstance("NONEXISTENT");
} catch (NoSuchAlgorithmException e) {
  System.out.println("Алгоритм не найден: " + e.getMessage());
}

Алгоритм не найден: NONEXISTENT MessageDigest not available

Изменения и примечания по версиям

• В более новых версиях Java добавлены реализации современных алгоритмов (например, SHA-3 появились в стандартной поставке начиная с Java 9/11 в зависимости от дистрибутива).
• Некоторые провайдеры могли изменить набор доступных алгоритмов и их имена; при переносе между JVM стоит проверять наличие требуемых провайдеров.
• MD5 и SHA-1 считаются устаревшими для криптографической защиты; в документации JDK и сообществах подчёркивается переход на SHA-2/ SHA-3 семейства.

Расширенные примеры использования

Пример 1. Подсчёт хеша большого файла с DigestInputStream.

import java.io.FileInputStream;
import java.security.DigestInputStream;
import java.security.MessageDigest;

public class FileHash {
  public static void main(String[] args) throws Exception {
    MessageDigest md = MessageDigest.getInstance("SHA-256");
    try (DigestInputStream dis = new DigestInputStream(new FileInputStream("/path/to/file"), md)) {
      byte[] buffer = new byte[8192];
      while (dis.read(buffer) != -1) { }
    }
    byte[] digest = md.digest();
    System.out.println(bytesToHex(digest));
  }

  private static String bytesToHex(byte[] bytes) {
    StringBuilder sb = new StringBuilder();
    for (byte b : bytes) sb.append(String.format("%02x", b));
    return sb.toString();
  }
}

(примерный вывод - hex хеш содержимого файла)

Пример 2. Параллельная обработка с клонированием MessageDigest для оптимизации.

MessageDigest md = MessageDigest.getInstance("SHA-256");
MessageDigest mdClone = (MessageDigest) md.clone();
byte[] h1 = md.digest("hello".getBytes());
// mdClone можно использовать в другом потоке, если реализация поддерживает clone()

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

Пример 3. Безопасное сравнение хешей.

byte[] a = MessageDigest.getInstance("SHA-256").digest("hello".getBytes());
byte[] b = MessageDigest.getInstance("SHA-256").digest("hello".getBytes());
System.out.println(MessageDigest.isEqual(a, b));

true

Пример 4. Использование ByteBuffer и update без промежуточных массивов.

import java.nio.ByteBuffer;
import java.security.MessageDigest;

ByteBuffer buf = ByteBuffer.wrap(new byte[]{'h','e','l','l','o'});
MessageDigest md = MessageDigest.getInstance("SHA-256");
md.update(buf);
byte[] d = md.digest();
System.out.println(bytesToHex(d));

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

Пример 5. Комбинация нескольких обновлений и частичный digest (инкрементальное хеширование).

MessageDigest md = MessageDigest.getInstance("SHA-256");
md.update("he".getBytes());
md.update("llo".getBytes());
byte[] d = md.digest();
System.out.println(bytesToHex(d));

2cf24dba5fb0a30e26e83b2ac5b9e29e1b161e5c1fa7425e73043362938b9824

Пример 6. HMAC отличается от простого хеша: для аутентификации нужен Mac.

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;

Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec("secret".getBytes(), "HmacSHA256"));
byte[] h = mac.doFinal("hello".getBytes());
System.out.println(bytesToHex(h));

(hex HMAC-SHA256 от "hello" с ключом "secret")

Пояснения: многие расширенные сценарии требуют учёта потоков, управления провайдерами и безопасности ключей. Для больших данных лучше использовать DigestInputStream и буферизацию, для секретов - Mac, а для подписей - Signature.