Rails authentication with email & password.

We have clearance, Clarence.

Clearance was extracted out of Hoptoad.

• Documentation at RDoc.info.
• Patches welcome via Github Issues.
• #thoughtbot IRC channel on freenode.
• Mailing list on Google Groups.

Clearance is a Rails engine for Rails 3.

Include the gem in your Gemfile:

gem "clearance"

Make sure the development database exists, then run the generator:

rails generate clearance:install

This:

• inserts Clearance::User into your User model
• inserts Clearance::Authentication into your ApplicationController
• creates a migration that either creates a users table or adds only missing columns

Use the 0.8.x series of Clearance if you have a Rails 2 app.

If you want to authenticate users for a controller action, use the authenticate method in a before_filter.

class WidgetsController < ApplicationController
  before_filter :authenticate
  def index
    @widgets = Widget.all
  end
end

To change any of provided actions, subclass a Clearance controller...

class SessionsController < Clearance::SessionsController
  def new
    # my special new action
  end
  def url_after_create
    my_special_path
  end
end

and add your route in config/routes.rb:

resource :session, :controller => 'sessions'

See config/routes.rb for all the routes Clearance provides.

Actions that redirect (create, update, and destroy) in Clearance controllers can be overridden by re-defining url_after_(action) methods as seen above.

As your app evolves, you want to know that authentication still works. If you use Cucumber, run the Clearance features generator:

rails generate clearance:features

Edit your Gemfile to include:

gem 'factory_girl_rails'

Edit config/enviroments/test.rb to include the following:

config.action_mailer.default_url_options = { :host => 'localhost:3000' }

Then run your tests!

rake

Clearance can also generate Formtastic views:

rails generate clearance:views

Clearance is intended to be small, simple, well-tested, and easy to extend. Check out some of the ways people have extended Clearance:

• Clearance HTTP Auth
• Clearance Twitter
• Clearance Admin

Clearance is maintained and funded by thoughtbot, inc

Thank you to all the contributors!

The names and logos for thoughtbot are trademarks of thoughtbot, inc.

Clearance is Copyright © 2009-2011 thoughtbot. It is free software, and may be redistributed under the terms specified in the LICENSE file.