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