Type:
Module

This module provides a framework for message digest libraries.

You may want to look at OpenSSL::Digest as it supports support more algorithms.

A cryptographic hash function is a procedure that takes data and return a fixed bit string : the hash value, also known as digest. Hash functions are also called one-way functions, it is easy to compute a digest from a message, but it is infeasible to generate a message from a digest.

Example

1
2
3
4
5
6
7
8
9
10
11
12
require 'digest'
 
# Compute a complete digest
sha256 = Digest::SHA256.new
digest = sha256.digest message
 
# Compute digest by chunks
sha256 = Digest::SHA256.new
sha256.update message1
sha256 << message2 # << is an alias for update
 
digest = sha256.digest

Digest algorithms

Different digest algorithms (or hash functions) are available :

HMAC

See FIPS PUB 198 The Keyed-Hash Message Authentication Code (HMAC)

RIPEMD-160

(as Digest::RMD160) see homes.esat.kuleuven.be/~bosselae/ripemd160.html

SHA1

See FIPS 180 Secure Hash Standard

SHA2 family

See FIPS 180 Secure Hash Standard which defines the following algorithms:

  • SHA512

  • SHA384

  • SHA256

The latest versions of the FIPS publications can be found here: csrc.nist.gov/publications/PubsFIPS.html

Additionally Digest::BubbleBabble encodes a digest as a sequence of consonants and vowels which is more recognizable and comparable than a hexadecimal digest. See en.wikipedia.org/wiki/Bubblebabble

<<
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::HMAC

<<(text) Instance Public methods Alias for:

2025-01-10 15:47:30
update
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::Instance

digest_obj.update(string) â digest_obj Instance Public methods Updates the digest

2025-01-10 15:47:30
reset
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::HMAC

hmac.reset â hmac Instance Public methods Resets the hmac to the initial state

2025-01-10 15:47:30
inspect
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::HMAC

hmac.inspect â string Instance Public methods Creates a printable version of

2025-01-10 15:47:30
digest
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::Class

Digest::Class.digest(string, *parameters) â hash_string Class Public methods Returns

2025-01-10 15:47:30
block_length
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::Instance

digest_obj.block_length â integer Instance Public methods Returns the block

2025-01-10 15:47:30
hexdigest
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::Class

Digest::Class.hexdigest(string[, ...]) â hash_string Class Public methods Returns

2025-01-10 15:47:30
<<
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::Instance

digest_obj Instance Public methods Updates

2025-01-10 15:47:30
digest_length
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::SHA2

digest_obj.digest_length â Integer Instance Public methods Returns the length

2025-01-10 15:47:30
==
  • References/Ruby on Rails/Ruby/Classes/Digest/Digest::Instance

digest_obj == another_digest_obj â booleandigest_obj == string â boolean Instance Public methods

2025-01-10 15:47:30