Omniauth DingTalk Strategies

Strategy to authenticate with DingTalk via OAuth2 in OmniAuth.

Get your API key at: http://open-dev.dingtalk.com/ Note the appId and the appSecret.

For more details, read the DingTalk docs: https://open-doc.dingtalk.com/docs/doc.htm?spm=0.0.0.0.oVQWJc&treeId=168&articleId=104878&docType=1

Installation

Add to your Gemfile:

gem 'oauth2_dingtalk'

Then bundle install.

appId & appSecret

Go to: https://open-doc.dingtalk.com/docs/doc.htm?spm=a219a.7629140.0.0.o96KrM&treeId=168&articleId=104882&docType=1

Usage

Here's an example for adding the middleware to a Rails app in config/initializers/omniauth.rb:

Rails.application.config.middleware.use OmniAuth::Builder do
  provider :dingding, "Your_OAuth_App_ID", "Your_OAuth_App_Secret"
end

You can now access the OmniAuth DingTalk OAuth2 URL: /auth/dingding

For more examples please check out example/config.ru

Auth Hash

Here's an example of an authentication hash available in the callback by accessing request.env['omniauth.auth']:

{
  "provider": "dingding",
  "uid": "uid" # this is openid in DingTalk
}