lucifer

Lucifer is Rails plugin which utilizes the ezcrypto gem to encrypt/decrypt database columns transparently.

Why is it called Lucifer? en.wikipedia.org/wiki/Lucifer_(cipher)

Installation

  ./script/plugin install git://github.com/jmckible/lucifer.git

Lucifer looks for a key and salt in config/key.yml. See key.yml.example

Usage

Add Lucifer to a class like so:

  class Person < ActiveRecord::Base
    # Database columns - id(integer), ssn_b(binary)
    encrypt_attributes
  end

Lucifer will treat any binary column that ends in _b as encryptable.

  person = Person.new :ssn=>'000-00-0000'
  => Person...
  person.save
  => true
  Person.first.ssn
  => '000-00-0000'

If you check out the database, you’ll see

  > select * from people;
   ---------------------------------
  | id         | ssn_b              |
   ----------------------------------
  | 1          | U??6?7f%25(?????   |
   ---------------------------------

Configuration

You can customize Lucifer by passing options like so:

  class Person < ActiveRecord::Base
    encrypt_attributes :suffix=>'_encrypted', :key_file=>'lucifer.yml'
  end

• :suffix - You can override the _b selector with this option
• :key_file - If you’d like to use a different file in your config/ directory, pass the name here

Author

• Lucifer was created by Jordan McKible jordan.mckible.com
• Available on GitHub at github.com/jmckible/lucifer/tree/master