Spec-Zone.ru › Ruby on Rails 7.1

класс ActiveRecord::Encryption::Cipher::Aes256Gcm

Родитель:
Object

Шифр 256-GCM.

По умолчанию он будет использовать случайные векторы инициализации. Для детерминированного шифрования он будет использовать хеш SHA-256 от текста, который нужно зашифровать, и секрета.

См. Encryptor

Константы

CIPHER_TYPE

Публичные методы класса

iv_length() Показать исходный код
# File activerecord/lib/active_record/encryption/cipher/aes256_gcm.rb, line 22
def iv_length
  OpenSSL::Cipher.new(CIPHER_TYPE).iv_len
end
key_length() Показать исходный код
# File activerecord/lib/active_record/encryption/cipher/aes256_gcm.rb, line 18
def key_length
  OpenSSL::Cipher.new(CIPHER_TYPE).key_len
end
new(secret, deterministic: false) Показать исходный код
# File activerecord/lib/active_record/encryption/cipher/aes256_gcm.rb, line 29
def initialize(secret, deterministic: false)
  @secret = secret
  @deterministic = deterministic
end

Если iv не предоставлен, он будет генерировать случайный iv при каждой операции шифрования (по умолчанию и рекомендуемая операция)

Публичные методы экземпляра

decrypt(encrypted_message) Показать исходный код
# File activerecord/lib/active_record/encryption/cipher/aes256_gcm.rb, line 55
def decrypt(encrypted_message)
  encrypted_data = encrypted_message.payload
  iv = encrypted_message.headers.iv
  auth_tag = encrypted_message.headers.auth_tag

  # Currently the OpenSSL bindings do not raise an error if auth_tag is
  # truncated, which would allow an attacker to easily forge it. See
  # https://github.com/ruby/openssl/issues/63
  raise ActiveRecord::Encryption::Errors::EncryptedContentIntegrity if auth_tag.nil? || auth_tag.bytes.length != 16

  cipher = OpenSSL::Cipher.new(CIPHER_TYPE)

  cipher.decrypt
  cipher.key = @secret
  cipher.iv = iv

  cipher.auth_tag = auth_tag
  cipher.auth_data = ""

  decrypted_data = encrypted_data.empty? ? encrypted_data : cipher.update(encrypted_data)
  decrypted_data << cipher.final

  decrypted_data
rescue OpenSSL::Cipher::CipherError, TypeError, ArgumentError
  raise ActiveRecord::Encryption::Errors::Decryption
end
encrypt(clear_text) Показать исходный код
# File activerecord/lib/active_record/encryption/cipher/aes256_gcm.rb, line 34
def encrypt(clear_text)
  # This code is extracted from +ActiveSupport::MessageEncryptor+. Not using it directly because we want to control
  # the message format and only serialize things once at the +ActiveRecord::Encryption::Message+ level. Also, this
  # cipher is prepared to deal with deterministic/non deterministic encryption modes.

  cipher = OpenSSL::Cipher.new(CIPHER_TYPE)
  cipher.encrypt
  cipher.key = @secret

  iv = generate_iv(cipher, clear_text)
  cipher.iv = iv

  encrypted_data = clear_text.empty? ? clear_text.dup : cipher.update(clear_text)
  encrypted_data << cipher.final

  ActiveRecord::Encryption::Message.new(payload: encrypted_data).tap do |message|
    message.headers.iv = iv
    message.headers.auth_tag = cipher.auth_tag
  end
end

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API