README.md

Omniauth::MicrosoftGraph

Microsoft Graph OAuth2 Strategy for OmniAuth. Can be used to authenticate with Office365 or other MS services, and get a token for the Microsoft Graph Api. I fetches group memberships and optional schema extensions.

Installation

Add this line to your application's Gemfile:

gem 'omniauth-microsoft_graph', git: 'https://github.com/m4c3/omniauth-microsoft_graph'

And then execute:

$ bundle

Or install it yourself as:

$ gem install omniauth-microsoft_graph

Usage

include your Azure cententials and optional extensions in your .env file

AZURE_CLIENT_ID='11111111-1111-1111-1111-111111111111'
AZURE_TENANT_ID='00000000-0000-0000-0000-000000000000'
AZURE_CLIENT_SECRET='XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX'
AZURE_EXTENSIONS='extension_00000000000000000000000000000000_something'

in Rails

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :microsoft_graph,
    {
      client_id: ENV['AZURE_CLIENT_ID'],
      client_secret: ENV['AZURE_CLIENT_SECRET'],
      tenant_id: ENV['AZURE_TENANT_ID'],
      extensions: ENV['AZURE_EXTENSIONS']
    }
end

Or the alternative format for use with devise:

config.omniauth :microsoft_graph,
      client_id: ENV['AZURE_CLIENT_ID'],
      client_secret: ENV['AZURE_CLIENT_SECRET'],
      tenant_id: ENV['AZURE_TENANT_ID'],
      extensions: ENV['AZURE_EXTENSIONS']

Contributing

1. Fork it ( https://github.com/m4c3/omniauth-microsoft_graph/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request