OmniAuth join.me Strategy
A join.me OAuth2 strategy for OmniAuth.
For more details, read the join.me documentation.
Installation
Add this line to your application's Gemfile:
gem "omniauth-joinme"
And then execute:
$ bundle
Or install it yourself as:
$ gem install omniauth-joinme
Usage
Register your application with join.me to receive an API key: https://developer.join.me/member/register
This is an example that you might put into a Rails initializer at config/initializers/omniauth.rb
:
Rails.application.config.middleware.use OmniAuth::Builder do
provider :joinme, ENV["JOINME_CLIENT_ID"], ENV["JOINME_SECRET"]
end
You can now access the OmniAuth join.me OAuth2 URL: /auth/joinme
.
Granting Additional Permissions to Your Application
With the join.me API, you have the ability to specify which permissions you want users to grant your application. For more details, read the join.me documentation.
By default, omniauth-joinme requests the following permissions:
"user_info"
You can configure the scope option:
provider :joinme, ENV["JOINME_CLIENT_ID"], ENV["JOINME_SECRET"], scope: "user_info start_meeting"
Contributing
- Fork it
- 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 new Pull Request
License
The gem is available as open source under the terms of the MIT License.