класс 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