#Omnibucket
Installation
Add this line to your application's Gemfile:
gem 'omnibucket'
And then execute:
$ bundle
Usage
OmniAuth::Strategies::Bitbucket
is simply a Rack middleware. Read the OmniAuth docs for detailed instructions: https://github.com/intridea/omniauth.
First, create a new application at https://bitbucket.org/account/user/<your username>/api
. Your callback URL must be something like https://example.com/auth/bitbucket/callback
. For development you can use http://127.0.0.1:3000/auth/bitbucket/callback
.
Here's a quick example, adding the middleware to a Rails app in config/initializers/omniauth.rb
. This example assumes you're exporting your credentials as environment variables.
Notice that we'll always inject account
and emails
scopes, so we can retrieve the required information.
Rails.application.config.middleware.use OmniAuth::Builder do
provider :bitbucket,
ENV['BITBUCKET_CLIENT_ID'],
ENV['BITBUCKET_CLIENT_SECRET']
end
Now visit /auth/bitbucket
to start authentication against Bitbucket.
Contributing
- Fork omnibucket
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request