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

Метод decrypt_and_verify вызовет исключение ActiveSupport::MessageEncryptor::InvalidMessage, если предоставленные данные нельзя расшифровать или проверить.

crypt.decrypt_and_verify('not encrypted data') # => ActiveSupport::MessageEncryptor::InvalidMessage

Ограничение сообщений определённой целью

По умолчанию любое сообщение можно использовать во всём приложении. Но их также можно ограничить определённой :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"