Class: ActiveRecord::Encryption::Scheme
Relationships & Source Files | |
Inherits: | Object |
Defined in: | activerecord/lib/active_record/encryption/scheme.rb |
Overview
A container of attribute encryption options.
It validates and serves attribute encryption options.
See EncryptedAttributeType, Context
Class Method Summary
Instance Attribute Summary
- #deterministic? ⇒ Boolean readonly
- #downcase? ⇒ Boolean readonly
- #fixed? ⇒ Boolean readonly
- #ignore_case? ⇒ Boolean readonly
- #previous_schemes rw
- #support_unencrypted_data? ⇒ Boolean readonly
Instance Method Summary
Constructor Details
.new(key_provider: nil, key: nil, deterministic: nil, support_unencrypted_data: nil, downcase: nil, ignore_case: nil, previous_schemes: nil, **context_properties) ⇒ Scheme
# File 'activerecord/lib/active_record/encryption/scheme.rb', line 13
def initialize(key_provider: nil, key: nil, deterministic: nil, support_unencrypted_data: nil, downcase: nil, ignore_case: nil, previous_schemes: nil, **context_properties) # Initializing all attributes to nil as we want to allow a "not set" semantics so that we # can merge schemes without overriding values with defaults. See #merge @key_provider_param = key_provider @key = key @deterministic = deterministic @support_unencrypted_data = support_unencrypted_data @downcase = downcase || ignore_case @ignore_case = ignore_case @previous_schemes_param = previous_schemes @previous_schemes = Array.wrap(previous_schemes) @context_properties = context_properties validate_config! end
Instance Attribute Details
#deterministic? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'activerecord/lib/active_record/encryption/scheme.rb', line 39
def deterministic? !!@deterministic end
#downcase? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'activerecord/lib/active_record/encryption/scheme.rb', line 35
def downcase? @downcase end
#fixed? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'activerecord/lib/active_record/encryption/scheme.rb', line 47
def fixed? # by default deterministic encryption is fixed @fixed ||= @deterministic && (!@deterministic.is_a?(Hash) || @deterministic[:fixed]) end
#ignore_case? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'activerecord/lib/active_record/encryption/scheme.rb', line 31
def ignore_case? @ignore_case end
#previous_schemes (rw)
[ GitHub ]# File 'activerecord/lib/active_record/encryption/scheme.rb', line 11
attr_accessor :previous_schemes
#support_unencrypted_data? ⇒ Boolean
(readonly)
[ GitHub ]
# File 'activerecord/lib/active_record/encryption/scheme.rb', line 43
def support_unencrypted_data? @support_unencrypted_data.nil? ? ActiveRecord::Encryption.config.support_unencrypted_data : @support_unencrypted_data end
Instance Method Details
#compatible_with?(other_scheme) ⇒ Boolean
# File 'activerecord/lib/active_record/encryption/scheme.rb', line 73
def compatible_with?(other_scheme) deterministic? == other_scheme.deterministic? end
#key_provider
[ GitHub ]# File 'activerecord/lib/active_record/encryption/scheme.rb', line 52
def key_provider @key_provider_param || key_provider_from_key || deterministic_key_provider || default_key_provider end
#merge(other_scheme)
[ GitHub ]#to_h
[ GitHub ]# File 'activerecord/lib/active_record/encryption/scheme.rb', line 60
def to_h { key_provider: @key_provider_param, deterministic: @deterministic, downcase: @downcase, ignore_case: @ignore_case, previous_schemes: @previous_schemes_param, **@context_properties }.compact end
#with_context(&block)
[ GitHub ]# File 'activerecord/lib/active_record/encryption/scheme.rb', line 65
def with_context(&block) if @context_properties.present? ActiveRecord::Encryption.with_encryption_context(**@context_properties, &block) else block.call end end