lucky_encrypted

attribute_encrypted in Crystal for Lucky lucky-framework encryption
0.4.0 Latest release released

lucky_encrypted

An type for Lucky framework Avram that's encrypt a string before saving to a database and decrypts when getting it from db.

it use defaults from Lucky's message encryptor class, which is using when last checked aes-256-cbc and the digest is sha1

You only need one column, as both the iv and the data is saved in one, splitted.

Installation

  1. Add the dependency to your shard.yml:

    dependencies:
      lucky_encrypted:
        github: microgit-com/lucky_encrypted
    
  2. Run shards install

Usage

  • add require "lucky_encrypted" in shards.cr

  • Create an column for the encrypted string you want to save with lucky migration, i use otp_secret as example.

  • set a config for LuckyEncrypted:

    # In config/lucky_encrypted.cr
    require "./server" # To get the configuration from the server
    LuckyEncrypted.configure do |settings|
      settings.secret = Lucky::Server.settings.secret_key_base
    end
    

    you can use lucky's secret key base or generate a different secret with lucky gen.secret_key

  • Add the type LuckyEncrypted::StringEncrypted as type for that column in the model:

      column otp_secret : LuckyEncrypted::StringEncrypted
    

it shall now work. (famous last words)

Development

using stdlib spec and all. so just use the test and so forth.

Contributing

  1. Fork it (https://github.com/microgit-com/lucky_encrypted/fork)
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Contributors

lucky_encrypted:
  github: microgit-com/lucky_encrypted
  version: ~> 0.4.0
License MIT
Crystal >= 1.0.0

Authors

Dependencies 2

  • avram ~> 0.23.0
    {'github' => 'luckyframework/avram', 'version' => '~> 0.23.0'}
  • lucky ~> 0.30.0
    {'github' => 'luckyframework/lucky', 'version' => '~> 0.30.0'}

Development Dependencies 0

Dependents 1

Last synced .
search fire star recently