Omniauth::Bungie::Oauth2

A Bungie OAuth2 strategy for Omniauth.

Installation

Add this line to your application's Gemfile:

gem 'omniauth-bungie-oauth2'

And then execute:

$ bundle

Usage

Settings

For full usage this gem You must create an application with authentication access on Bungie.net.

After this, you can integrate this strategy with your application. (More about A Bungie OAuth2 you can read on Help page)

For example, you can add the middleware to a Rails application in /config/application.rb:

config.middleware.use OmniAuth::Builder do
  provider :bungie,
    'x_api_key_from_bungie_app_settings',
    'authorization_url_from_bungie_app_settings',
    :origin => 'origin_url_if_you_need'
end

Rails integration

For integration with Rails You have to setup your strategy configuration in config/initializers/devise.rb:

Devise.setup do |config|
  config.omniauth :bungie,
    'x_api_key_from_bungie_app_settings',
    'authorization_url_from_bungie_app_settings',
    :origin => 'origin_url_if_you_need'
end

After this You should define omniauth callback in routes and controller.

routes.rb:

devise_for :users, :controllers => {
  :omniauth_callbacks => 'devise/omniauth_callbacks',
}

devise/omniauth_callbacks_controller.rb

class Devise::OmniauthCallbacksController < Devise::OmniauthCallbacksController
  def bungie
    @user = User.from_omniauth(request.env["omniauth.auth"])

    if @user.persisted?
      @user.remember_me = true

      sign_in_and_redirect @user, :event => :authentication

      set_flash_message(:notice, :success, :kind => 'Bungie') if is_navigational_format?
    else
      session["devise.bungie_data"] = request.env["omniauth.auth"]

      redirect_to '/'
    end
  end

  def failure
    redirect_to '/'
  end
end

Result

After all manipulation the request.env["omniauth.auth"] have the next fields:

• uid with BungieNetUser membershipId
• info with Destiny membershipId, membershipType and displayName
• extra with GetBungieAccount result

Configuration

This provider require two arguments and have one special option:

• api_key - X-Api-Key for Bungie API;
• auth_url - Autherization url;
• origin - Origin url;

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/RuBAN-GT/omniauth-bungie-oauth2. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

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

Fireteam

If you want to fight with Oryx with me or create any interesting applications for Destiny, you can add me (https://www.bungie.net/en/Profile/254/12488384).