Прогрессивное хеширование: метод update и finalize

Прогрессивное (инкрементальное) хеширование позволяет обрабатывать данные частями, не загружая их полностью в память. Это особенно важно при работе с большими файлами, потоками данных или при поэтапной обработке входной информации. В библиотеке Crypto-js этот механизм реализован через методы update и finalize.

Общая концепция

Вместо однократного вызова хеш-функции с полной строкой используется объект хешера, который принимает данные порциями:

  • update(data) — добавляет новую часть данных в вычисление хеша
  • finalize([data]) — завершает вычисление и возвращает итоговый хеш

После вызова finalize объект хешера считается завершённым и не должен использоваться повторно.

Создание хешера

Для начала создаётся экземпляр хеш-алгоритма:

const hash = CryptoJS.algo.SHA256.create();

Crypto-js поддерживает различные алгоритмы (SHA1, SHA256, SHA512, MD5 и др.), и каждый из них имеет одинаковый интерфейс для прогрессивной обработки.

Метод update

Метод update принимает строку или объект WordArray и добавляет его к внутреннему состоянию хешера.

hash.update("Часть 1 данных");
hash.update("Часть 2 данных");
hash.update("Часть 3 данных");

Особенности:

  • Данные не хешируются немедленно как финальный результат — они накапливаются
  • Можно вызывать неограниченное количество раз
  • Поддерживается последовательная обработка потоков

Метод finalize

Метод finalize завершает вычисление:

const result = hash.finalize();

Также допускается передача последней порции данных:

const result = hash.finalize("Последняя часть");

После вызова:

  • возвращается объект WordArray, содержащий хеш
  • внутреннее состояние фиксируется
  • дальнейшие вызовы update недопустимы

Пример полного цикла

const hash = CryptoJS.algo.SHA256.create();

hash.update("Hello ");
hash.update("World");

const digest = hash.finalize();

console.log(digest.toString(CryptoJS.enc.Hex));

Результат будет идентичен:

CryptoJS.SHA256("Hello World");

Внутреннее устройство

Crypto-js реализует буферизацию входных данных:

  • входящие данные накапливаются в блоках фиксированного размера
  • при достижении размера блока происходит частичная обработка
  • остаток сохраняется до следующего вызова update или finalize

Это обеспечивает:

  • эффективное использование памяти
  • возможность обработки потоков
  • соответствие стандартам хеширования (например, SHA-2)

Работа с бинарными данными

Для точного контроля над входом используется WordArray:

const wordArray = CryptoJS.enc.Utf8.parse("Данные");

hash.update(wordArray);

Это важно при работе с:

  • бинарными файлами
  • сетевыми потоками
  • нестандартными кодировками

Прогрессивное хеширование файлов

Типичный сценарий — обработка больших файлов по частям:

const hash = CryptoJS.algo.SHA256.create();

function processChunk(chunk) {
    hash.update(chunk);
}

// После обработки всех частей
const result = hash.finalize();

Такой подход:

  • снижает нагрузку на память
  • позволяет обрабатывать файлы любого размера
  • используется в браузерах при чтении через FileReader или Streams API

Повторное использование

После вызова finalize объект нельзя “сбросить”. Для нового вычисления создаётся новый экземпляр:

const newHash = CryptoJS.algo.SHA256.create();

Частые ошибки

1. Повторный вызов update после finalize

hash.finalize();
hash.update("ещё данные"); // ошибка логики

2. Ожидание строки вместо WordArray

const result = hash.finalize();
console.log(result); // объект, не строка

Правильно:

result.toString(CryptoJS.enc.Hex);

3. Несогласованная кодировка

Разные способы представления строки могут дать разные результаты:

CryptoJS.enc.Utf8.parse("text")
CryptoJS.enc.Latin1.parse("text")

Сравнение с однократным хешированием

Подход Особенности
Однократный Простота, подходит для небольших данных
Прогрессивный Масштабируемость, контроль, работа с потоками

Использование с HMAC

Прогрессивный подход также поддерживается для HMAC:

const hmac = CryptoJS.algo.HMAC.create(CryptoJS.algo.SHA256, "secret");

hmac.update("data1");
hmac.update("data2");

const result = hmac.finalize();

Практическое значение

Прогрессивное хеширование применяется в:

  • загрузке и проверке целостности файлов
  • потоковой обработке данных
  • криптографических протоколах
  • системах хранения (например, chunk-based hashing)

Производительность

Преимущества:

  • уменьшение пикового потребления памяти
  • возможность параллельной загрузки и обработки
  • гибкость при работе с большими объёмами

Недостатки:

  • немного более сложный код
  • необходимость контроля состояния объекта

Итоговое понимание механизма

  • create() — инициализация хешера
  • update() — накопление данных
  • finalize() — завершение и получение результата

Такой паттерн полностью повторяет поведение низкоуровневых криптографических API и обеспечивает максимальную гибкость при работе с данными любого размера.

Оглавление