class OpenSSL::Digest

OpenSSL::Digest позволяет вычислять дайджесты сообщений (иногда их также называют «хешами») для произвольных данных, обеспечивая криптографическую безопасность; то есть Digest реализует безопасную одностороннюю функцию.

Односторонние функции обладают рядом полезных свойств. Например, для двух различных входных данных вероятность того, что они дадут одинаковый результат, крайне мала. В сочетании с тем, что каждый алгоритм дайджеста сообщения выдаёт результат фиксированной длины — всего несколько байтов, — это свойство позволяет использовать дайджесты для создания уникальных идентификаторов произвольных данных. Распространённый пример — создание уникального идентификатора для двоичных документов, хранящихся в базе данных.

Ещё одна полезная характеристика односторонних функций (что отражено и в их названии) заключается в том, что по дайджесту нельзя определить исходные данные, на основе которых он был получен; то есть единственный способ определить исходные данные — перебрать все возможные комбинации входных данных.

Эти характеристики также делают односторонние функции идеальным дополнением к алгоритмам подписи с открытым ключом: вместо подписания всего документа сначала вычисляется его хеш с помощью значительно более быстрого алгоритма дайджеста сообщения, а затем с использованием более медленного алгоритма с открытым ключом подписываются всего несколько байтов результата. Чтобы проверить целостность подписанного документа, достаточно повторно вычислить хеш и убедиться, что он совпадает с хешем в подписи.

Список всех алгоритмов дайджеста, поддерживаемых в вашей системе, можно получить, выполнив в терминале следующую команду:

openssl list -digest-algorithms

Среди алгоритмов дайджеста сообщений, поддерживаемых OpenSSL 1.1.1, есть:

• SHA224, SHA256, SHA384, SHA512, SHA512-224 и SHA512-256

• SHA3-224, SHA3-256, SHA3-384 и SHA3-512

• BLAKE2s256 и BLAKE2b512

Каждый из этих алгоритмов можно создать, указав его имя:

digest = OpenSSL::Digest.new('SHA256')

«Взлом» алгоритма дайджеста сообщения означает нарушение свойств его односторонней функции, то есть создание коллизии или поиск способа получить исходные данные более эффективным методом, чем полный перебор и т. п. Большинство поддерживаемых алгоритмов дайджеста можно считать взломанными в этом смысле, в том числе очень популярные алгоритмы MD5 и SHA1. Если для вас безопасность имеет первостепенное значение, следует использовать SHA224, SHA256, SHA384 или SHA512.

Хеширование файла

data = File.binread('document')
sha256 = OpenSSL::Digest.new('SHA256')
digest = sha256.digest(data)

Хеширование нескольких фрагментов данных за один раз

data1 = File.binread('file1')
data2 = File.binread('file2')
data3 = File.binread('file3')
sha256 = OpenSSL::Digest.new('SHA256')
sha256 << data1
sha256 << data2
sha256 << data3
digest = sha256.digest

Повторное использование экземпляра Digest

data1 = File.binread('file1')
sha256 = OpenSSL::Digest.new('SHA256')
digest1 = sha256.digest(data1)

data2 = File.binread('file2')
sha256.reset
digest2 = sha256.digest(data2)