README.md

OmniAuth Office365

Gem to authenticate applications to the Office365 v2.0 REST API via OAuth2.

Note An unmaintained (at least as of this writing) omniauth-office365 gem exists at https://github.com/simi/omniauth-office365. However, it's built on an older, deprecated version of the API.

Setup

• Full documentation at https://msdn.microsoft.com/office/office365/api/use-outlook-rest-api.
• Developer Console: https://apps.dev.microsoft.com/
• Available Scopes: https://msdn.microsoft.com/office/office365/howto/authenticate-office-365-apis-using-v2#bk_Outlookscopes.

Note Depending on the which scopes you choose, a successful response may not contain an access_token. In that cases, an error will be raised in the oauth2 gem. There's a PR that should address this: oauth-xx/oauth2#243.

Standard setup:

  # Add to your initializers/omniauth.rb

  use OmniAuth::Builder do
    provider :office365, ENV['OFFICE365_APP_ID'], ENV['OFFICE365_APP_SECRET'], :scope => 'https://outlook.office.com/mail.read'
  end

Setup with Devise:

  # Add to your devise.rb

  config.omniauth :office365, ENV['OFFICE365_APP_ID'], ENV['OFFICE365_APP_SECRET'], :scope => 'https://outlook.office.com/mail.read'