Set up your Facebook app at developers.facebook.com/setup/
Create the Rails app:
rails new YOUR_APP cd YOUR_APP
Add the following lines to your Gemfile:
gem "oauth2" gem "devise", :git => "git://github.com/plataformatec/devise.git" gem "devise_oauth2_authenticatable", :git => "git://github.com/jerryluk/devise_oauth2_authenticatable.git"
Run the following commands:
bundle install rails g devise:install rails g devise User rails g devise:oauth2_authenticatable APP_ID SECRET
Your DeviseCreateUsers migration should look like this:
class DeviseCreateUsers < ActiveRecord::Migration def self.up create_table(:users) do |t| t.database_authenticatable t.rememberable t.trackable t.oauth2_authenticatable t.string :email t.timestamps end add_index :users, :oauth2_uid, :unique => true end def self.down drop_table :users end end
Make sure user.rb has the following line:
devise :oauth2_authenticatable, ...
Add this to your application_controller.rb:
Add the sign in/sign out links to your applications.html.erb:
<% if user_signed_in? %> <%= link_to "Sign out", destroy_user_session_path %> <% else %> <%= link_to_oauth2 "Sign In with Facebook" %> <% end %>
The usual stuffs:
rm public/index.html rake db:create rake db:migrate rails s
Navigate your browser to localhost:3000, there are many things to fix but you are mostly there!
It currently works with FacebookGraph, to get started begin by registering a new application at
A generator is provided for creating your oauth yml file
rails g devise:oauth2_authenticatable
rails g devise:oauth2_authenticatable APP_ID SECRET 'email,offline_access,publish_stream'
for more details
It's based on the devise facebook gem provided by grimen
And uses the example provided in OAuth2 library provided by mbleigh
DB Migration :
add_column :users, :oauth2_uid, :integer, :limit => 8 # BIGINT unsigned / 64-bit int add_column :users, :oauth2_token, :string, :limit => 149 #  chars add_index :users, :oauth2_uid, :unique => true
A little souce of confusion when working with Facebook Graph
The api key and secret key are no the same a Facebook Connect/the old API.
The client id should be your application id and the client_key, should be your API key (not secret key)
Write tests :
Currently no tests have been written. My bad.
Generalize for OAuth2:
Add support for other OAuth2 services. Wrote this specifically for facebook graph, althought configuration arugments should be generalized to support other interfaces.
Description goes here.
Fork the project.
Make your feature addition or bug fix.
Add tests for it. This is important so I don't break it in a future version unintentionally.
Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
Send me a pull request. Bonus points for topic branches.
Copyright © 2010 bhbryant. See LICENSE for details.