OpenAuth2 is a thin OAuth2 wrapper written on top of Faraday in Ruby. The goal is a simple, well documented, easy to use interface for all your OAuth2 needs.
- This software is alpha, you're either very brave or very foolish to use this in production of rockets or anything else.
To begin, let's setup the configuration. Here we're assuming connection to Facebook api. OpenAuth2 supports Google and Facebook out of the box (more to come soon). Other sites can be configured manually.
require 'open_auth2' # get this info by signing your app at developers.facebook.com client_id = 'enter in your own value' client_secret = 'enter in your own value' redirect_uri = 'enter in your own value' config = OpenAuth2::Config.new do |c| # indicate what kind of provider you want to use # Accepts: OpenAuth2::Provider::Default, OpenAuth2::Provider::Facebook, OpenAuth2::Provider::Google c.provider = OpenAuth2::Provider::Facebook c.client_id = client_id c.client_secret = client_secret c.redirect_uri = redirect_uri c.scope = ['publish_stream'] end
Next, initialize a
client object, which we'll use to make requests and pass in the
config object we created earlier.
client = OpenAuth2::Client.new(config)
To start the OAuth2 exotic dance, you'll need to obtain a 'code' from the server, which you can then use to request an 'access_token'. Redirect the user/yourself to this url to obtain that 'code'.
build_code_url takes optional params hash, which will be bundled into the url.
token.build_code_url(:scope => 'publish_stream')
Access token is used to sign the request so the server can identify the client sending the request. If you already have an access token, add it to the client with a block.
client.access_token = 'enter in your value' client.refresh_token = 'enter in your value'
GET Access Token
If you don't have an access token, we'll need to ask the server for it.
token#configure is similar to
token = OpenAuth2::Token.new(config) # asks Facebook for access_token token.get # the following methods are now available token.access_token token.refresh_token token.token_expires_at token.token_expired? token.token_arrived_at
GET Refresh Token
# tells Facebook api to extend the expiration of the access_token token.refresh
To make an api call, simply call
get with your path.
get accepts a Hash as second argument, which can be used to pass in additional parameters.
client.get('/cocacola', :limit => 1)
Since various OAuth2 providers differ in their implementation, OpenAuth2 provides a simple plugin system to accomodate the differences, rather than 'one shoe fits all' approach. Facebook and Google plugins are builtin, but it is trivial to add new ones.
There are only two requirements:
- Can contain #options method
- Can contain #before_client_post method
- Can contain #after_token_post method
To use the plugin, call
Config#provider= with name of the provider.
module OpenAuth2 module Provider class ThirdApi options :response_type => 'code', :access_token_grant_name => 'authorization_code', :refresh_token_grant_name => 'refresh_token', :refresh_token_name => :refresh_token, :scope =>  before_client_post do |params| params[:url] += '?extra_params' end after_token_post do |response_body, config| token = response_body.gsub('access_token=', '') config.access_token = token end end end end
See examples/ for more ... (its a surprise).
- MRI 1.9.2
- MRI 1.9.3
- jRuby (jruby --1.9 rspec)
- Rubinius 2.0.0dev (RBXOPT=-X19 rbx- S rspec)
$ gem install open_auth2
OpenAuth2's git repo is available on GitHub:
You will need these gems to get tests to pass:
- SimpleCov (optional for coverage)
See meta for more info on contributing and technology used to create this gem.
(The MIT License)
Copyright (c) 2014, Senthil A email@example.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software isfurnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.