A Ruby on Rails example application with authentication built from scratch.
Ruby JavaScript
Latest commit d757521 Oct 1, 2012 @maprihoda Remove blank line
Permalink
Failed to load latest commit information.
app Annotate models Dec 19, 2011
bin Logging in with Omniauth Nov 28, 2011
config Add before_save :downcase_email filter Dec 19, 2011
db Logging in with Omniauth Nov 28, 2011
lib Refactor the authentication logic into a separate module Dec 12, 2011
log
public
script Initial commit Nov 11, 2011
spec Remove blank line Oct 1, 2012
.gitignore Initial commit Nov 11, 2011
.rspec
Gemfile
LICENCE
README.md
Rakefile Initial commit Nov 11, 2011
config.ru Initial commit Nov 11, 2011

README.md

primal_auth

A Ruby on Rails example application with authentication built from scratch.

Motivation

Full-featured solutions like the Devise engine are often a good choice when authentication is needed. However, I prefer to implement authentication in a Rails app from scratch as I find it much easier to customize than a Rails engine.

Tell me more

The authentication needs covered are:

  • Signing up
  • Confirming sign-up by email
  • Logging in/out (with email and password)
  • Logging in/out with Omniauth
  • Remembering logged in user
  • Resetting password
  • Tracking users (like e.g. last login, last activity, etc.)

The application is inspired by Ryan Bates' excellent railscasts on authentication and the nifty_authentication generator. I made several modifications to the original code base, added other features (Confirmable, Trackable, Omniauthable), wired everything together into a fully functional Ruby on Rails application, and thoroughly tested everything (mainly unit and integration tests with RSpec and Capybara).

It also takes inspiration from Devise.

Installation

Just git clone the application, cd to the root folder and run

bundle

and then

rake db:migrate

rails server -b localhost

The app works ok on Ruby ~> 1.9.2.

Tests

Run the tests with

bundle exec rspec spec

TODO

  • Lockable
  • Timeoutable
  • Account deletion
  • Migrate to Postgres + add indexes

Contributing

In case of any problems with the app, please file an issue here on Github.

If you want to contribute, please fork the project and send me a pull request (tested with RSpec).