Class: Lockbox::Encryptor

Inherits:
Object
  • Object
show all
Defined in:
lib/lockbox/encryptor.rb

Instance Method Summary collapse

Constructor Details

#initialize(**options) ⇒ Encryptor

Returns a new instance of Encryptor.



3
4
5
6
7
8
9
10
 
# File 'lib/lockbox/encryptor.rb', line 3

def initialize(**options)
  options = Lockbox.default_options.merge(options)
  previous_versions = options.delete(:previous_versions)

  @boxes =
    [Box.new(**options)] +
    Array(previous_versions).map { |v| Box.new(key: options[:key], **v) }
end

Instance Method Details

#decrypt(ciphertext, **options) ⇒ Object 



17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
 
# File 'lib/lockbox/encryptor.rb', line 17

def decrypt(ciphertext, **options)
  ciphertext = check_string(ciphertext, "ciphertext")

  # ensure binary
  if ciphertext.encoding != Encoding::BINARY
    # dup to prevent mutation
    ciphertext = ciphertext.dup.force_encoding(Encoding::BINARY)
  end

  @boxes.each_with_index do |box, i|
    begin
      return box.decrypt(ciphertext, **options)
    rescue => e
      # returning DecryptionError instead of PaddingError
      # is for end-user convenience, not for security
      error_classes = [DecryptionError, PaddingError]
      error_classes << RbNaCl::LengthError if defined?(RbNaCl::LengthError)
      error_classes << RbNaCl::CryptoError if defined?(RbNaCl::CryptoError)
      if error_classes.any? { |ec| e.is_a?(ec) }
        raise DecryptionError, "Decryption failed" if i == @boxes.size - 1
      else
        raise e
      end
    end
  end
end

#decrypt_io(io, **options) ⇒ Object 



50
51
52
53
54
 
# File 'lib/lockbox/encryptor.rb', line 50

def decrypt_io(io, **options)
  new_io = Lockbox::IO.new(decrypt(io.read, **options))
  copy_metadata(io, new_io)
  new_io
end

#decrypt_str(ciphertext, **options) ⇒ Object 



56
57
58
59
 
# File 'lib/lockbox/encryptor.rb', line 56

def decrypt_str(ciphertext, **options)
  message = decrypt(ciphertext, **options)
  message.force_encoding(Encoding::UTF_8)
end

#encrypt(message, **options) ⇒ Object 



12
13
14
15
 
# File 'lib/lockbox/encryptor.rb', line 12

def encrypt(message, **options)
  message = check_string(message, "message")
  @boxes.first.encrypt(message, **options)
end

#encrypt_io(io, **options) ⇒ Object 



44
45
46
47
48
 
# File 'lib/lockbox/encryptor.rb', line 44

def encrypt_io(io, **options)
  new_io = Lockbox::IO.new(encrypt(io.read, **options))
  copy_metadata(io, new_io)
  new_io
end