Module: OAuth2

Defined in:
lib/oauth2.rb,
lib/oauth2/error.rb,
lib/oauth2/client.rb,
lib/oauth2/version.rb,
lib/oauth2/response.rb,
lib/oauth2/access_token.rb,
lib/oauth2/authenticator.rb,
lib/oauth2/strategy/base.rb,
lib/oauth2/auth_sanitizer.rb,
lib/oauth2/strategy/implicit.rb,
lib/oauth2/strategy/password.rb,
lib/oauth2/strategy/assertion.rb,
lib/oauth2/strategy/auth_code.rb,
lib/oauth2/filtered_attributes.rb,
lib/oauth2/strategy/client_credentials.rb,
sig/oauth2.rbs,
sig/oauth2/error.rbs,
sig/oauth2/client.rbs,
sig/oauth2/version.rbs,
sig/oauth2/response.rbs,
sig/oauth2/strategy.rbs,
sig/oauth2/access_token.rbs,
sig/oauth2/thing_filter.rbs,
sig/oauth2/authenticator.rbs,
sig/oauth2/sanitized_logger.rbs,
sig/oauth2/filtered_attributes.rbs

Overview

simplecov:enable

Defined Under Namespace

Modules: FilteredAttributes, Strategy, Version Classes: AccessToken, Authenticator, Client, Error, Response, SanitizedLogger, ThingFilter

Constant Summary collapse

OAUTH_DEBUG =

When true, enables verbose HTTP logging via Faraday's logger middleware. Controlled by the OAUTH_DEBUG environment variable. Any case-insensitive value equal to "true" will enable debugging.

Returns:

  • (Boolean) 
ENV.fetch("OAUTH_DEBUG", "false").casecmp("true").zero?
DEFAULT_CONFIG =

Default configuration values for the oauth2 library.

Existing objects and logger wrappers snapshot filtering configuration during initialization. Changing these config values later affects only newly initialized objects and debug loggers.

Examples:

Toggle warnings

OAuth2.configure do |config|
  config[:silence_extra_tokens_warning] = false
  config[:silence_no_tokens_warning] = false
end

Customize filtered output markers and debug-log value filtering by key name

OAuth2.configure do |config|
  config[:filtered_label] = "[REDACTED]"
  config[:filtered_debug_keys] += ["client_assertion"]
end

Returns:

  • (SnakyHash::SymbolKeyed) —

    A mutable Hash-like config with symbol keys

SnakyHash::SymbolKeyed.new(
  silence_extra_tokens_warning: true,
  silence_no_tokens_warning: true,
  filtered_label: "[FILTERED]",
  filtered_debug_keys: %w[
    access_token
    refresh_token
    id_token
    client_secret
    assertion
    code_verifier
    token
  ]
)
CONFIG =

The current runtime configuration for the library.

Returns:

  • (SnakyHash::SymbolKeyed) 
DEFAULT_CONFIG.dup
ConnectionError = 
Class.new(Faraday::ConnectionFailed)
TimeoutError = 
Class.new(Faraday::TimeoutError)
VERSION =

Traditional Constant Location

Returns:

  • (String) 
Version::VERSION
AUTH_SANITIZER = 
begin
  auth_sanitizer_requirement = Gem::Requirement.new("~> 0.2", ">= 0.2.2")
  auth_sanitizer_loader_namespace = AnonymousLoader.load_path(
    gem_name: "auth-sanitizer",
    require_path: "auth_sanitizer/loader.rb",
    version_requirement: auth_sanitizer_requirement,
    version_file: "auth/sanitizer/version.rb"
  )

  auth_sanitizer_loader_namespace.
    const_get(:AuthSanitizer).
    const_get(:Loader).
    load_isolated
end

Class Method Summary collapse

Class Method Details

.config ⇒ Object

Returns:

  • (Object) 


79
80
81
 
# File 'lib/oauth2.rb', line 79

def config
  CONFIG
end

.configure {|config, arg0| ... } ⇒ void

This method returns an undefined value.

Configure global library behavior.

Yields the mutable configuration object so callers can update settings.

Yields:

Yield Parameters:

  • config (SnakyHash::SymbolKeyed) —

    the configuration object

  • arg0 (Object)

Yield Returns:

  • (void) 


89
90
91
 
# File 'lib/oauth2.rb', line 89

def configure
  yield config
end