StackExchange OAuth strategy for OmniAuth
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
test Update ruby syntax Nov 19, 2016
.travis.yml Update .travis.yml Sep 19, 2015 Update Nov 26, 2016
Gemfile initial Jun 27, 2012
LICENSE initial Jun 27, 2012
Rakefile Update ruby syntax Nov 19, 2016

OmniAuth StackExchange TravisCI

This gem contains the StackExchange strategy for OmniAuth.

StackExchange uses the OAuth2 flow, you can read about it here:

How To Use It

So let's say you're using Rails, you need to add the strategy to your Gemfile:

gem 'omniauth-stackexchange'

You can pull them in directly from github e.g.:

gem 'omniauth-stackexchange', git: ''

Once these are in, you need to add the following to your config/initializers/omniauth.rb:

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :stackexchange, 'client_id', 'client_secret', public_key: 'key', site: 'stackoverflow'

or with Devise to your config/initializers/devise.rb

  config.omniauth :meetup, ENV['client_id'], ENV['client_secret'], callback_url: ''

Starting from version 1.4 in omniauth-oauth2 you must provide same callback url you have provided on API dashboard otherwise authentication won't work.

You will obviously have to put in your client_id, client_secret and public_key, which you get when you register your app with StackExchange (they call them Client Id, Client Secret and Key).

You will also need to specify a site option to uniquely identify the StackExchange site (e.g. stackoverflow or superuser) you wish to authenticate against. A list of valid site api keys can be found at It's stackoverflow by default.

If your application needs to be able to support multiple StackExchange sites, you can pass the site api key as the value for a GET parameter named sites (e.g. /auth/stackexchange?site=superuser)

Now just follow the README at:

Supported Rubies

OmniAuth StackExchange is tested under 1.9.3.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request


Copyright (c) 2012 by Vasiliy Ermolovich