класс ActiveSupport::MessageVerifier

Родитель:: Объект

MessageVerifier упрощает генерацию и проверку подписанных сообщений, чтобы предотвратить их подделку.

Это полезно в таких случаях, как токены "запомнить меня" и ссылки на отписку, когда хранилище сессий не подходит или недоступно.

Запомнить меня:

cookies[:remember_me] = @verifier.generate([@user.id, 2.weeks.from_now])

В фильтре аутентификации:

id, time = @verifier.verify(cookies[:remember_me])
if time < Time.now
  self.current_user = User.find(id)
end

По умолчанию используется Marshal для сериализации сообщения. Если вы хотите использовать другой метод сериализации, вы можете установить сериализатор в хеш-опций при инициализации:

@verifier = ActiveSupport::MessageVerifier.new('s3Krit', serializer: YAML)

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

new(secret, options = {}) Показать исходный код

# File activesupport/lib/active_support/message_verifier.rb, line 29
def initialize(secret, options = {})
  @secret = secret
  @digest = options[:digest] || 'SHA1'
  @serializer = options[:serializer] || Marshal
end

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

generate(value) Показать исходный код

# File activesupport/lib/active_support/message_verifier.rb, line 51
def generate(value)
  data = ::Base64.strict_encode64(@serializer.dump(value))
  "#{data}--#{generate_digest(data)}"
end

verify(signed_message) Показать исходный код

# File activesupport/lib/active_support/message_verifier.rb, line 35
def verify(signed_message)
  raise InvalidSignature if signed_message.blank?

  data, digest = signed_message.split("--")
  if data.present? && digest.present? && secure_compare(digest, generate_digest(data))
    begin
      @serializer.load(::Base64.strict_decode64(data))
    rescue ArgumentError => argument_error
      raise InvalidSignature if argument_error.message =~ %r{invalid base64}
      raise
    end
  else
    raise InvalidSignature
  end
end