Module: Warden::Hooks

Included in:
Manager
Defined in:
lib/warden/hooks.rb

Instance Method Summary collapse

Instance Method Details

#_after_failed_fetchObject

Provides access to the callback array for after_failed_fetch :api: private



145
146
147
# File 'lib/warden/hooks.rb', line 145

def _after_failed_fetch
  @_after_failed_fetch ||= []
end

#_after_set_userObject

Provides access to the array of after_set_user blocks to run :api: private



67
68
69
# File 'lib/warden/hooks.rb', line 67

def _after_set_user # :nodoc:
  @_after_set_user ||= []
end

#_before_failureObject

Provides access to the callback array for before_failure :api: private



117
118
119
# File 'lib/warden/hooks.rb', line 117

def _before_failure
  @_before_failure ||= []
end

#_before_logoutObject

Provides access to the callback array for before_logout :api: private



173
174
175
# File 'lib/warden/hooks.rb', line 173

def _before_logout
  @_before_logout ||= []
end

#_on_requestObject

Provides access to the callback array for before_logout :api: private



198
199
200
# File 'lib/warden/hooks.rb', line 198

def _on_request
  @_on_request ||= []
end

#_run_callbacks(kind, *args) ⇒ Object

Hook to _run_callbacks asserting for conditions.



7
8
9
10
11
12
13
14
15
16
17
# File 'lib/warden/hooks.rb', line 7

def _run_callbacks(kind, *args) #:nodoc:
  options = args.last # Last callback arg MUST be a Hash

  send("_#{kind}").each do |callback, conditions|
    invalid = conditions.find do |key, value|
      value.is_a?(Array) ? !value.include?(options[key]) : (value != options[key])
    end

    callback.call(*args) unless invalid
  end
end

#after_authentication(options = {}, method = :push, &block) ⇒ Object

after_authentication is just a wrapper to after_set_user, which is only invoked when the user is set through the authentication path. The options and yielded arguments are the same as in after_set_user.

:api: public



76
77
78
# File 'lib/warden/hooks.rb', line 76

def after_authentication(options = {}, method = :push, &block)
  after_set_user(options.merge(:event => :authentication), method, &block)
end

#after_failed_fetch(options = {}, method = :push, &block) ⇒ Object

A callback that runs if no user could be fetched, meaning there is now no user logged in.

Parameters: <options> Some options which specify when the callback should be executed

scope  - Executes the callback only if it matches the scope(s) given

<block> A block to contain logic for the callback

Block Parameters: |user, auth, scope|
  user - The authenticated user for the current scope
  auth - The warden proxy object
  opts - any options passed into the authenticate call including :scope

Example:

Warden::Manager.after_failed_fetch do |user, auth, opts|
  I18n.locale = :en
end

:api: public

Raises:

  • (BlockNotGiven)


138
139
140
141
# File 'lib/warden/hooks.rb', line 138

def after_failed_fetch(options = {}, method = :push, &block)
  raise BlockNotGiven unless block_given?
  _after_failed_fetch.send(method, [block, options])
end

#after_fetch(options = {}, method = :push, &block) ⇒ Object

after_fetch is just a wrapper to after_set_user, which is only invoked when the user is fetched from session. The options and yielded arguments are the same as in after_set_user.

:api: public



85
86
87
# File 'lib/warden/hooks.rb', line 85

def after_fetch(options = {}, method = :push, &block)
  after_set_user(options.merge(:event => :fetch), method, &block)
end

#after_set_user(options = {}, method = :push, &block) ⇒ Object

A callback hook set to run every time after a user is set. This callback is triggered the first time one of those three events happens during a request: :authentication, :fetch (from session) and :set_user (when manually set). You can supply as many hooks as you like, and they will be run in order of declaration.

If you want to run the callbacks for a given scope and/or event, you can specify them as options. See parameters and example below.

Parameters: <options> Some options which specify when the callback should be executed

scope  - Executes the callback only if it matches the scope(s) given
only   - Executes the callback only if it matches the event(s) given
except - Executes the callback except if it matches the event(s) given

<block> A block where you can set arbitrary logic to run every time a user is set

Block Parameters: |user, auth, opts|
  user - The user object that is being set
  auth - The raw authentication proxy object.
  opts - any options passed into the set_user call including :scope

Example:

Warden::Manager.after_set_user do |user,auth,opts|
  scope = opts[:scope]
  if auth.session["#{scope}.last_access"].to_i > (Time.now - 5.minutes)
    auth.logout(scope)
    throw(:warden, :scope => scope, :reason => "Times Up")
  end
  auth.session["#{scope}.last_access"] = Time.now
end

Warden::Manager.after_set_user :except => :fetch do |user,auth,opts|
  user. += 1
end

:api: public

Raises:

  • (BlockNotGiven)


53
54
55
56
57
58
59
60
61
62
63
# File 'lib/warden/hooks.rb', line 53

def after_set_user(options = {}, method = :push, &block)
  raise BlockNotGiven unless block_given?

  if options.key?(:only)
    options[:event] = options.delete(:only)
  elsif options.key?(:except)
    options[:event] = [:set_user, :authentication, :fetch] - Array(options.delete(:except))
  end

  _after_set_user.send(method, [block, options])
end

#before_failure(options = {}, method = :push, &block) ⇒ Object

A callback that runs just prior to the failure application being called. This callback occurs after PATH_INFO has been modified for the failure (default /unauthenticated) In this callback you can mutate the environment as required by the failure application If a Rails controller were used for the failure_app for example, you would need to set request[:action] = :unauthenticated

Parameters: <options> Some options which specify when the callback should be executed

scope  - Executes the callback only if it matches the scope(s) given

<block> A block to contain logic for the callback

Block Parameters: |env, opts|
  env - The rack env hash
  opts - any options passed into the authenticate call including :scope

Example:

Warden::Manager.before_failure do |env, opts|
  params = Rack::Request.new(env).params
  params[:action] = :unauthenticated
  params[:warden_failure] = opts
end

:api: public

Raises:

  • (BlockNotGiven)


110
111
112
113
# File 'lib/warden/hooks.rb', line 110

def before_failure(options = {}, method = :push, &block)
  raise BlockNotGiven unless block_given?
  _before_failure.send(method, [block, options])
end

#before_logout(options = {}, method = :push, &block) ⇒ Object

A callback that runs just prior to the logout of each scope.

Parameters: <options> Some options which specify when the callback should be executed

scope  - Executes the callback only if it matches the scope(s) given

<block> A block to contain logic for the callback

Block Parameters: |user, auth, scope|
  user - The authenticated user for the current scope
  auth - The warden proxy object
  opts - any options passed into the authenticate call including :scope

Example:

Warden::Manager.before_logout do |user, auth, opts|
  user.forget_me!
end

:api: public

Raises:

  • (BlockNotGiven)


166
167
168
169
# File 'lib/warden/hooks.rb', line 166

def before_logout(options = {}, method = :push, &block)
  raise BlockNotGiven unless block_given?
  _before_logout.send(method, [block, options])
end

#on_request(options = {}, method = :push, &block) ⇒ Object

A callback that runs on each request, just after the proxy is initialized

Parameters: <block> A block to contain logic for the callback

Block Parameters: |proxy|
  proxy - The warden proxy object for the request

Example:

user = "A User"
Warden::Manager.on_request do |proxy|
  proxy.set_user = user
end

:api: public

Raises:

  • (BlockNotGiven)


191
192
193
194
# File 'lib/warden/hooks.rb', line 191

def on_request(options = {}, method = :push, &block)
  raise BlockNotGiven unless block_given?
  _on_request.send(method, [block, options])
end