Class: Argon2::Engine

Inherits:
Object
  • Object
show all
Defined in:
lib/argon2/engine.rb,
lib/argon2/ffi_engine.rb

Overview

The engine class shields users from the FFI interface. It is generally not advised to directly use this class.

Class Method Summary collapse

Class Method Details

.argon2_verify(pwd, hash, secret) ⇒ Object

Raises:



98
99
100
101
102
103
104
105
106
107
# File 'lib/argon2/ffi_engine.rb', line 98

def self.argon2_verify(pwd, hash, secret)
  secretlen = secret.nil? ? 0 : secret.bytesize
  passwordlen = pwd.nil? ? 0 : pwd.bytesize

  ret = Ext.wrap_argon2_verify(hash, pwd, passwordlen, secret, secretlen)
  return false if ERRORS[ret.abs] == 'ARGON2_DECODING_FAIL'
  raise ArgonHashFail, ERRORS[ret.abs] unless ret.zero?

  true
end

.hash_argon2i(password, salt, t_cost, m_cost, out_len = nil) ⇒ Object

Raises:



49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
# File 'lib/argon2/ffi_engine.rb', line 49

def self.hash_argon2i(password, salt, t_cost, m_cost, out_len = nil)
  out_len = (out_len || Constants::OUT_LEN).to_i
  raise ArgonHashFail, "Invalid output length" if out_len < 1

  result = ''
  FFI::MemoryPointer.new(:char, out_len) do |buffer|
    ret = Ext.argon2i_hash_raw(t_cost, 1 << m_cost, 1, password,
                               password.length, salt, salt.length,
                               buffer, out_len)
    raise ArgonHashFail, ERRORS[ret.abs] unless ret.zero?

    result = buffer.read_string(out_len)
  end
  result.unpack('H*').join
end

.hash_argon2id(password, salt, t_cost, m_cost, p_cost, out_len = nil) ⇒ Object

Raises:



65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# File 'lib/argon2/ffi_engine.rb', line 65

def self.hash_argon2id(password, salt, t_cost, m_cost, p_cost, out_len = nil)
  out_len = (out_len || Constants::OUT_LEN).to_i
  raise ArgonHashFail, "Invalid output length" if out_len < 1

  result = ''
  FFI::MemoryPointer.new(:char, out_len) do |buffer|
    ret = Ext.argon2id_hash_raw(t_cost, 1 << m_cost, p_cost, password,
                                password.length, salt, salt.length,
                                buffer, out_len)
    raise ArgonHashFail, ERRORS[ret.abs] unless ret.zero?

    result = buffer.read_string(out_len)
  end
  result.unpack('H*').join
end

.hash_argon2id_encode(password, salt, t_cost, m_cost, p_cost, secret) ⇒ Object

Raises:



81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
# File 'lib/argon2/ffi_engine.rb', line 81

def self.hash_argon2id_encode(password, salt, t_cost, m_cost, p_cost, secret)
  result = ''
  secretlen = secret.nil? ? 0 : secret.bytesize
  passwordlen = password.nil? ? 0 : password.bytesize
  raise ArgonHashFail, "Invalid salt size" if salt.length != Constants::SALT_LEN

  FFI::MemoryPointer.new(:char, Constants::ENCODE_LEN) do |buffer|
    ret = Ext.argon2_wrap(buffer, password, passwordlen,
                          salt, salt.length, t_cost, (1 << m_cost),
                          p_cost, secret, secretlen)
    raise ArgonHashFail, ERRORS[ret.abs] unless ret.zero?

    result = buffer.read_string(Constants::ENCODE_LEN)
  end
  result.delete "\0"
end

.saltgenObject



8
9
10
# File 'lib/argon2/engine.rb', line 8

def self.saltgen
  SecureRandom.random_bytes(Argon2::Constants::SALT_LEN)
end