Skip to main content

SciNote SSO Exploration

Doorkeeper

Files Referencing

  • Gemfile
  • Rakefile
  • token_authentication.rb
  • connected_device_logging.rb
  • access_tokens_controller.rb
  • sessions_controller.rb
  • connected_device.rb
  • user.rb
  • core_jwt.rb
  • application.rb
  • routes.rb
  • devise.rb
  • doorkeeper.rb
  • doorkeeper.en.yml
  • en.yml
  • migrations
  • tests (spec)

config/locales/doorkeeper.en.yml

en:
activerecord:
attributes:
doorkeeper/application:
name: 'Name'
redirect_uri: 'Redirect URI'

config/initializers/doorkeeper.rb

Key Variables

In the format of "variable name (default value)". If no default is specified, then it is commented out by default.

  • authorization_code_expires_in (10 minutes)
  • access_token_expires_in (2 hours)
  • access_token_generator ('Api::CoreJwt')
  • reuse_access_token
  • use_refresh_token
  • enable_application_owner
  • default_scopes
  • optional_scopes
  • client_credentials
  • access_token_methods
  • native_redirect_uri
  • force_ssl_in_redirect_uri
  • forbid_redirect_uri
  • grant_flows
  • WWW-Authenticate Realm

Full Code

Doorkeeper.configure do
# Change the ORM that doorkeeper will use (needs plugins)
orm :active_record

# This block will be called to check whether the resource owner is authenticated or not.
resource_owner_authenticator do
current_user || warden.authenticate!(scope: :user)
end

# If you want to restrict access to the web interface for adding oauth authorized applications, you need to declare the block below.
admin_authenticator do
current_user || redirect_to(new_admin_session_url)
end

# Authorization Code expiration time (default 10 minutes).
authorization_code_expires_in 10.minutes

# Access token expiration time (default 2 hours).
# If you want to disable expiration, set this to nil.
access_token_expires_in 2.hours

# Assign a custom TTL for implicit grants.
# custom_access_token_expires_in do |oauth_client|
# oauth_client.application.additional_settings.implicit_oauth_expiration
# end

# Use a custom class for generating the access token.
# https://github.com/doorkeeper-gem/doorkeeper#custom-access-token-generator
access_token_generator 'Api::CoreJwt'

# The controller Doorkeeper::ApplicationController inherits from.
# Defaults to ActionController::Base.
# https://github.com/doorkeeper-gem/doorkeeper#custom-base-controller
# base_controller 'DoorkeeperCustomController'

# Reuse access token for the same resource owner within an application (disabled by default)
# Rationale: https://github.com/doorkeeper-gem/doorkeeper/issues/383
# reuse_access_token

# Issue access tokens with refresh token (disabled by default)
use_refresh_token

# Provide support for an owner to be assigned to each registered application (disabled by default)
# Optional parameter confirmation: true (default false) if you want to enforce ownership of
# a registered application
# Note: you must also run the rails g doorkeeper:application_owner generator to provide the necessary support
# enable_application_owner confirmation: false

# Define access token scopes for your provider
# For more information go to
# https://github.com/doorkeeper-gem/doorkeeper/wiki/Using-Scopes
default_scopes :public
# optional_scopes :write, :update

# Change the way client credentials are retrieved from the request object.
# By default it retrieves first from the `HTTP_AUTHORIZATION` header, then
# falls back to the `:client_id` and `:client_secret` params from the `params` object.
# Check out https://github.com/doorkeeper-gem/doorkeeper/wiki/Changing-how-clients-are-authenticated
# for more information on customization
# client_credentials :from_basic, :from_params

# Change the way access token is authenticated from the request object.
# By default it retrieves first from the `HTTP_AUTHORIZATION` header, then
# falls back to the `:access_token` or `:bearer_token` params from the `params` object.
# Check out https://github.com/doorkeeper-gem/doorkeeper/wiki/Changing-how-clients-are-authenticated
# for more information on customization
# access_token_methods :from_bearer_authorization, :from_access_token_param, :from_bearer_param

# Change the native redirect uri for client apps
# When clients register with the following redirect uri, they won't be redirected to any server and the authorization code will be displayed within the provider
# The value can be any string. Use nil to disable this feature. When disabled, clients must provide a valid URL
# (Similar behaviour: https://developers.google.com/accounts/docs/OAuth2InstalledApp#choosingredirecturi)
#
# native_redirect_uri 'urn:ietf:wg:oauth:2.0:oob'

# Forces the usage of the HTTPS protocol in non-native redirect uris (enabled
# by default in non-development environments). OAuth2 delegates security in
# communication to the HTTPS protocol so it is wise to keep this enabled.
#
# Callable objects such as proc, lambda, block or any object that responds to
# #call can be used in order to allow conditional checks (to allow non-SSL
# redirects to localhost for example).
#
# force_ssl_in_redirect_uri !Rails.env.development?
#
# force_ssl_in_redirect_uri { |uri| uri.host != 'localhost' }

# Specify what redirect URI's you want to block during creation. Any redirect
# URI is whitelisted by default.
#
# You can use this option in order to forbid URI's with 'javascript' scheme
# for example.
#
# forbid_redirect_uri { |uri| uri.scheme.to_s.downcase == 'javascript' }

# Specify what grant flows are enabled in array of Strings. The valid
# strings and the flows they enable are:
#
# "authorization_code" => Authorization Code Grant Flow
# "implicit" => Implicit Grant Flow
# "password" => Resource Owner Password Credentials Grant Flow
# "client_credentials" => Client Credentials Grant Flow
#
# If not specified, Doorkeeper enables authorization_code and
# client_credentials.
#
# implicit and password grant flows have risks that you should understand
# before enabling:
# http://tools.ietf.org/html/rfc6819#section-4.4.2
# http://tools.ietf.org/html/rfc6819#section-4.4.3
#
grant_flows %w(authorization_code)

# Hook into the strategies' request & response life-cycle in case your
# application needs advanced customization or logging:
#
# before_successful_strategy_response do |request|
# puts "BEFORE HOOK FIRED! #{request}"
# end
#
# after_successful_strategy_response do |request, response|
# puts "AFTER HOOK FIRED! #{request}, #{response}"
# end

# Under some circumstances you might want to have applications auto-approved,
# so that the user skips the authorization step.
# For example if dealing with a trusted application.
# skip_authorization do |resource_owner, client|
# client.superapp? or resource_owner.admin?
# end

# WWW-Authenticate Realm (default "Doorkeeper").
# realm "Doorkeeper"
end

Omniauth

Full Code

# frozen_string_literal: true

require 'omniauth/strategies/custom_azure_active_directory'

AZURE_SETUP_PROC = lambda do |env|
settings = ApplicationSettings.instance
providers = settings.values['azure_ad_apps'].select { |v| v['enable_sign_in'] }
raise StandardError, 'No Azure AD config available for sign in' if providers.blank?

req = Rack::Request.new(env)

if providers.size > 1
if req.params['id_token'].present? # Callback phase
unverified_jwt_payload, = JWT.decode(req.params['id_token'], nil, false)
provider_conf = providers.select { |v| v['app_id'] == unverified_jwt_payload['aud'] }
else # Authorization phase
raise ActionController::ParameterMissing, 'Provider name is missing' if req.params['provider'].blank?

provider_conf = providers.find { |v| v['provider_name'] == req.params['provider'] }
end
raise StandardError, 'No Azure AD config available for sign in' if provider_conf.blank?
end

provider_conf ||= providers.first
env['omniauth.strategy'].options[:client_id] = provider_conf['app_id']
env['omniauth.strategy'].options[:client_secret] = provider_conf['client_secret']
env['omniauth.strategy'].options[:tenant_id] = provider_conf['tenant_id']
env['omniauth.strategy'].options[:sign_in_policy] = provider_conf['sign_in_policy']
env['omniauth.strategy'].options[:name] = 'customazureactivedirectory'
env['omniauth.strategy'].options[:conf_url] = provider_conf['conf_url']
conf_uri = URI.parse(provider_conf['conf_url'])
env['omniauth.strategy'].options[:base_azure_url] = "#{conf_uri.scheme || 'https'}://#{conf_uri.host}"
end

OKTA_SETUP_PROC = lambda do |env|
settings = ApplicationSettings.instance
provider_conf = settings.values['okta']
raise StandardError, 'No Okta config available for sign in' if provider_conf.blank?

oauth2_base_url =
if provider_conf['auth_server_id'].blank?
"https://#{provider_conf['domain']}/oauth2"
else
"https://#{provider_conf['domain']}/oauth2/#{provider_conf['auth_server_id']}"
end

client_options = {
site: "https://#{provider_conf['domain']}",
authorize_url: "#{oauth2_base_url}/v1/authorize",
token_url: "#{oauth2_base_url}/v1/token",
user_info_url: "#{oauth2_base_url}/v1/userinfo"
}
client_options[:audience] = provider_conf['audience'] if provider_conf['audience'].present?
if provider_conf['auth_server_id'].present?
client_options[:authorization_server] = provider_conf['auth_server_id']
client_options[:use_org_auth_server] = false
else
client_options[:use_org_auth_server] = true
end

env['omniauth.strategy'].options[:client_id] = provider_conf['client_id']
env['omniauth.strategy'].options[:client_secret] = provider_conf['client_secret']
env['omniauth.strategy'].options[:client_options] = client_options
end

Rails.application.config.middleware.use OmniAuth::Builder do
provider OmniAuth::Strategies::CustomAzureActiveDirectory, setup: AZURE_SETUP_PROC
end

Rails.application.config.middleware.use OmniAuth::Builder do
provider OmniAuth::Strategies::Okta, setup: OKTA_SETUP_PROC
end

OmniAuth.config.logger = Rails.logger