Sha256: 8b12fc5f0eefd02f3a1f03c1ce7336cd4cb4577522f35f0d19c7c6373556a30a

Contents?: true

Size: 1.58 KB

Versions: 32

Compression:

Stored size: 1.58 KB

Contents

# frozen_string_literal: true

require "active_support/security_utils"
require "active_support/messages/rotator"

module ActiveSupport
  # The ActiveSupport::SecureCompareRotator is a wrapper around ActiveSupport::SecurityUtils.secure_compare
  # and allows you to rotate a previously defined value to a new one.
  #
  # It can be used as follow:
  #
  #   rotator = ActiveSupport::SecureCompareRotator.new('new_production_value')
  #   rotator.rotate('previous_production_value')
  #   rotator.secure_compare!('previous_production_value')
  #
  # One real use case example would be to rotate a basic auth credentials:
  #
  #   class MyController < ApplicationController
  #     def authenticate_request
  #       rotator = ActiveSupport::SecureCompareRotator.new('new_password')
  #       rotator.rotate('old_password')
  #
  #       authenticate_or_request_with_http_basic do |username, password|
  #         rotator.secure_compare!(password)
  #       rescue ActiveSupport::SecureCompareRotator::InvalidMatch
  #         false
  #       end
  #     end
  #   end
  class SecureCompareRotator
    include SecurityUtils
    prepend Messages::Rotator

    InvalidMatch = Class.new(StandardError)

    def initialize(value, **_options)
      @value = value
    end

    def secure_compare!(other_value, on_rotation: @on_rotation)
      secure_compare(@value, other_value) ||
        run_rotations(on_rotation) { |wrapper| wrapper.secure_compare!(other_value) } ||
        raise(InvalidMatch)
    end

    private
      def build_rotation(previous_value, _options)
        self.class.new(previous_value)
      end
  end
end

Version data entries

32 entries across 31 versions & 8 rubygems

Version Path
activesupport-7.0.8.6 lib/active_support/secure_compare_rotator.rb
activesupport-7.0.8.5 lib/active_support/secure_compare_rotator.rb
blacklight-spotlight-3.6.0.beta8 vendor/bundle/ruby/3.2.0/gems/activesupport-7.0.8.4/lib/active_support/secure_compare_rotator.rb
cm-admin-1.5.22 vendor/bundle/ruby/3.3.0/gems/activesupport-7.0.5.1/lib/active_support/secure_compare_rotator.rb
cm-admin-1.5.21 vendor/bundle/ruby/3.3.0/gems/activesupport-7.0.5.1/lib/active_support/secure_compare_rotator.rb
cm-admin-1.5.20 vendor/bundle/ruby/3.3.0/gems/activesupport-7.0.5.1/lib/active_support/secure_compare_rotator.rb
activesupport-7.0.8.4 lib/active_support/secure_compare_rotator.rb
activesupport-7.0.8.1 lib/active_support/secure_compare_rotator.rb
scrapbook-0.3.2 vendor/ruby/2.7.0/gems/activesupport-7.0.3.1/lib/active_support/secure_compare_rotator.rb
activesupport-7.0.8 lib/active_support/secure_compare_rotator.rb
activesupport-7.0.7.2 lib/active_support/secure_compare_rotator.rb
activesupport-7.0.7.1 lib/active_support/secure_compare_rotator.rb
activesupport-7.0.7 lib/active_support/secure_compare_rotator.rb
mlh-rubocop-config-1.0.2 vendor/bundle/ruby/3.2.0/gems/activesupport-7.0.6/lib/active_support/secure_compare_rotator.rb
fablicop-1.10.3 vendor/bundle/ruby/3.2.0/gems/activesupport-7.0.5/lib/active_support/secure_compare_rotator.rb
fablicop-1.10.3 vendor/bundle/ruby/3.2.0/gems/activesupport-7.0.6/lib/active_support/secure_compare_rotator.rb
activesupport-7.0.6 lib/active_support/secure_compare_rotator.rb
activesupport-7.0.5.1 lib/active_support/secure_compare_rotator.rb
scrapbook-0.3.1 vendor/ruby/2.7.0/gems/activesupport-7.0.3.1/lib/active_support/secure_compare_rotator.rb
rubypitaya-3.12.5 ./lib/rubypitaya/app-template/vendor/bundle/ruby/3.1.0/gems/activesupport-7.0.4/lib/active_support/secure_compare_rotator.rb