Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

53 lines (35 sloc) 1.802 kB

TwitterAuth

TwitterAuth is a plugin to provide a standard authentication stack using Twitter as an SSO provider. This is obviously most useful and therefore targeted at apps that intend to heavily use the Twitter API.

Note: TwitterAuth uses Rails Engines functionality from Rails 2.3 and is therefore incompatible with earlier versions of Rails.

Getting Started

First, install either by gem or by plugin:

config.gem 'mbleigh-twitter-auth', :source => 'http://gems.github.com/'

OR

script/plugin install git://github.com/mbleigh/twitter-auth.git

Next, to get started, you will need to generate the migration for the User model that TwitterAuth uses. It's simple:

script/generate migration twitter_auth_migration

If you look in the migration you will see that there are some information fields pre-populated (name, location, etc). These will automatically be retrieved from Twitter at each login and therefor kept both accessible and fresh for your usage.

Believe it or not, that's it! You now have access to the standard suite of restful-auth controller helpers such as:

  • login_required
  • current_user
  • logged_in?

And you also have the ability to login through the built-in SessionController. Just run the app and point your browser to '/login' to get started! You don't need to sign up because it will automatically create new users if the logging in user has never logged in before.

Caveats

This is extremely alpha code and has not been thoroughly spec'ed or even inspected. Use at your own risk as the functionality is likely to change drastically even in the near future.

Copyright (c) 2009 Michael Bleigh and Intridea, Inc., released under the MIT license

Jump to Line
Something went wrong with that request. Please try again.