baaart / omniauth-quickbooks-oauth2

Implements an Omniauth strategy for Quickbooks using OAuth2.

omniauth-quickbooks-oauth2

This gem provides an Omniauth strategy to connect with Quickbooks (via Intuit) using OAuth2.

Installation

Add this line to your application's Gemfile:

gem 'omniauth-quickbooks-oauth2'

And then execute:

$ bundle

Or install it yourself as:

$ gem install omniauth-quickbooks-oauth2

Usage

In your omniauth initializer file (e.g. config/initializers/omniauth.rb), you will want to add the following:

Rails.application.config.middleware.use OmniAuth::Builder do
  ...
  provider(
    :quickbooks_oauth2,
    ENV['INTUIT_CLIENT_ID'],
    ENV['INTUIT_CLIENT_SECRET'],
    scope: 'com.intuit.quickbooks.accounting openid profile email phone address',
    sandbox: Rails.env.development?,
  )
  ...
end

NOTE: The above environment variable names and scope are just what I use in my particular project. The environment variables can be named whatever and you should consult Intuit's documentation to figure out which scopes your application should ask for.

ALSO NOTE: If the sandbox parameter is not explicitly set to false, then the strategy will default to using the sandbox endpoints for Intuit's API.

ALSO NOTE: If you request the profile, address, email, and/or phone scopes, you must also specify the openid scope or else Intuit will not allow the OAuth2 dance to happen.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/abeland/omniauth-quickbooks-oauth2.

License

The gem is available as open source under the terms of the MIT License.