класс ActiveSupport::MessageEncryptor

MessageEncryptor — простой способ шифрования значений, которые хранятся в ненадежном месте.

Текст шифра и вектор инициализации кодируются в base64 и возвращаются вам.

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

len   = ActiveSupport::MessageEncryptor.key_len
salt  = SecureRandom.random_bytes(len)
key   = ActiveSupport::KeyGenerator.new('password').generate_key(salt, len) # => "\x89\xE0\x156\xAC..."
crypt = ActiveSupport::MessageEncryptor.new(key)                            # => #<ActiveSupport::MessageEncryptor ...>
encrypted_data = crypt.encrypt_and_sign('my secret data')                   # => "NlFBTTMwOUV5UlA1QlNEN2xkY2d6eThYWWh..."
crypt.decrypt_and_verify(encrypted_data)                                    # => "my secret data"

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

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

token = crypt.encrypt_and_sign("this is the chair", purpose: :login)

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

crypt.decrypt_and_verify(token, purpose: :login)    # => "this is the chair"
crypt.decrypt_and_verify(token, purpose: :shipping) # => nil
crypt.decrypt_and_verify(token)                     # => nil

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

token = crypt.encrypt_and_sign("the conversation is lively")
crypt.decrypt_and_verify(token, purpose: :scare_tactics) # => nil
crypt.decrypt_and_verify(token)                          # => "the conversation is lively"

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

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

crypt.encrypt_and_sign(parcel, expires_in: 1.month)
crypt.encrypt_and_sign(doowad, expires_at: Time.now.end_of_year)

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

Включение новых ключей

MessageEncryptor также поддерживает обновление старых конфигураций, используя стек шифровальщиков. Вызовите rotate для создания и добавления шифровальщика, чтобы decrypt_and_verify также попробовал резервный вариант.

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

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

crypt = ActiveSupport::MessageEncryptor.new(@secret, cipher: "aes-256-gcm")

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

crypt.rotate old_secret            # Fallback to an old secret instead of @secret.
crypt.rotate cipher: "aes-256-cbc" # Fallback to an old cipher instead of aes-256-gcm.

Однако, если и секрет, и шифр были изменены одновременно, вышеуказанное следует объединить в:

crypt.rotate old_secret, cipher: "aes-256-cbc"