класс ActiveSupport::MessageVerifier

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

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

Запоминание:

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

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

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

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

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

MessageVerifier по умолчанию создаёт HMAC-подписи с использованием алгоритма хеширования SHA1. Если вы хотите использовать другой алгоритм хеширования, вы можете изменить его, передав :digest в качестве параметра при инициализации верификатора:

@verifier = ActiveSupport::MessageVerifier.new('s3Krit', digest: 'SHA256')

Ограничение сообщений на конкретную цель

По умолчанию любое сообщение может быть использовано во всём приложении. Но их также можно ограничить определённой :purpose.

token = @verifier.generate("this is the chair", purpose: :login)

Затем эту же цель необходимо передать при проверке, чтобы получить данные обратно:

@verifier.verified(token, purpose: :login)    # => "this is the chair"
@verifier.verified(token, purpose: :shipping) # => nil
@verifier.verified(token)                     # => nil

@verifier.verify(token, purpose: :login)      # => "this is the chair"
@verifier.verify(token, purpose: :shipping)   # => ActiveSupport::MessageVerifier::InvalidSignature
@verifier.verify(token)                       # => ActiveSupport::MessageVerifier::InvalidSignature

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

token = @verifier.generate("the conversation is lively")
@verifier.verified(token, purpose: :scare_tactics) # => nil
@verifier.verified(token)                          # => "the conversation is lively"

@verifier.verify(token, purpose: :scare_tactics)   # => ActiveSupport::MessageVerifier::InvalidSignature
@verifier.verify(token)                            # => "the conversation is lively"

Устаревание сообщений

По умолчанию сообщения хранятся вечно, и проверка через год по-прежнему вернёт исходное значение. Но сообщения можно установить на истечение в определённое время с помощью :expires_in или :expires_at.

@verifier.generate(parcel, expires_in: 1.month)
@verifier.generate(doowad, expires_at: Time.now.end_of_year)

Затем сообщения можно проверить и вернуть до времени истечения срока действия. После этого метод verified возвращает nil, а verify генерирует ActiveSupport::MessageVerifier::InvalidSignature.

Ротация ключей

MessageVerifier также поддерживает ротацию старых конфигураций, используя стек верификаторов. Вызовите rotate для создания и добавления верификатора, чтобы либо verified либо verify также пытались выполнить проверку с резервным вариантом.

По умолчанию все прокрученные верификаторы используют значения основного верификатора, если не указано иное.

Вы бы задали новые значения по умолчанию для вашего верификатора:

verifier = ActiveSupport::MessageVerifier.new(@secret, digest: "SHA512", serializer: JSON)

Затем постепенно выводите старые значения из строя, добавляя их как резервные варианты. Любое сообщение, сгенерированное со старыми значениями, будет работать до тех пор, пока ротация не будет удалена.

verifier.rotate old_secret          # Fallback to an old secret instead of @secret.
verifier.rotate digest: "SHA256"    # Fallback to an old digest instead of SHA512.
verifier.rotate serializer: Marshal # Fallback to an old serializer instead of JSON.

Хотя вышеописанное, скорее всего, будет объединено в одну ротацию:

verifier.rotate old_secret, digest: "SHA256", serializer: Marshal