Home

Awesome

Doorkeeper Devise+Omniauth Client

Build Status

This app is an example of OAuth2 client. It was built in order to test the doorkeeper provider example. It uses rails, devise and omniauth gems. OAuth2 strategy is build on top of abstract OAuth2 strategy for OmniAuth

About Doorkeeper Gem

For more information about the gem, documentation, wiki and another resources, check out the project on GitHub.

Installation & Configuration

If you want to run the application by yourself here are the steps for you.

First you need to clone the repository from GitHub

git clone git@github.com:doorkeeper-gem/doorkeeper-devise-client.git

Install all the gems

bundle install

And migrate the database

bundle exec rake db:migrate

At this point the application should be ready to run, but it won't communicate correctly with the provider. You need to set up environment variables to indicate the oauth2 provider values. In your .env file, setup these variables

DOORKEEPER_APP_ID = "375c2e3fd..." # ID for your app registered at the provider
DOORKEEPER_APP_SECRET = "6a2fa82ab..." # Secret
DOORKEEPER_APP_URL = "http://the-provider.com" # URL to the provider

If you want to test it out you can use our sample provider using doorkeeper gem. It's available here. In order to add your application and get your application ID and SECRET click here.

Now you are ready to start the app

bundle exec rails s