This gem contains the StackExchange strategy for OmniAuth.
StackExchange uses the OAuth2 flow, you can read about it here: https://api.stackexchange.com/docs/authentication
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 => 'https://github.com/nashby/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"
end
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 api key to uniquely identify the StackExchange site you wish to authenticate against. A list of valid site api keys can be found at https://api.stackexchange.com/docs/sites. You have two options for passing the site api key, the first by passing the key along as a query string parameter on the url you use to call into StackExchange as follows:
/auth/stackexchange?site=stackoverflow
If a value is not passed via the url, the gem uses the one specified in the omniauth.rb file as follows where you will have to replace site_api_key with the value you the site you wish to authenticate against (e.g. stackoverflow or superuser):
Rails.application.config.middleware.use OmniAuth::Builder do
provider :stackexchange, "client_id", "client_secret", public_key: "key", site: 'site_api_key'
end
Now just follow the README at: https://github.com/intridea/omniauth
OmniAuth StackExchange is tested under 1.9.3.
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Copyright (c) 2012 by Vasiliy Ermolovich