Module: Clearance::Authentication

Extended by:
ActiveSupport::Concern
Included in:
Controller
Defined in:
lib/clearance/authentication.rb

Instance Method Summary collapse

Instance Method Details

#authenticate(params) ⇒ User?

Authenticate a user with a provided email and password

Parameters:

  • params (ActionController::Parameters) —

    The parameters from the sign in form. params[:session][:email] and params[:session][:password] are required.

Returns:

  • (User, nil) —

    The user or nil if authentication fails.



26
27
28
29
30
 
# File 'lib/clearance/authentication.rb', line 26

def authenticate(params)
  Clearance.configuration.user_model.authenticate(
    params[:session][:email], params[:session][:password]
  )
end

#current_user ⇒ User?

Get the user from the current clearance session. Exposed as a helper_method, making it visible to views. Prefer #signed_in? or #signed_out? if you only want to check for the presence of a current user rather than access the actual user.

Returns:

  • (User, nil) —

    The user if one is signed in or nil otherwise.



38
39
40
 
# File 'lib/clearance/authentication.rb', line 38

def current_user
  clearance_session.current_user
end

#handle_unverified_request ⇒ Object

CSRF protection in Rails >= 3.0.4

http://weblog.rubyonrails.org/2011/2/8/csrf-protection-bypass-in-ruby-on-rails



104
105
106
107
 
# File 'lib/clearance/authentication.rb', line 104

def handle_unverified_request
  super
  sign_out
end

#sign_in(user, &block) ⇒ Object

Sign in the provided user. Signing in will run the stack of Configuration#sign_in_guards.

You can provide a block to this method to handle the result of that stack. Your block will receive either a SuccessStatus or FailureStatus

(user) do |status|
  if status.success?
    # ...
  else
    # ...
  end
end

For an example of how clearance uses this internally, see SessionsController#create.

Signing in will also regenerate the CSRF token for the current session, provided Configuration#rotate_csrf_on_sign_in? is set.

Parameters:



63
64
65
66
67
68
69
70
 
# File 'lib/clearance/authentication.rb', line 63

def (user, &block)
  clearance_session.(user, &block)

  if signed_in? && Clearance.configuration.rotate_csrf_on_sign_in?
    session.delete(:_csrf_token)
    form_authenticity_token
  end
end

#sign_out ⇒ Object

Destroy the current user's Clearance session. See Session#sign_out for specifics.



74
75
76
 
# File 'lib/clearance/authentication.rb', line 74

def sign_out
  clearance_session.sign_out
end

#signed_in? ⇒ Boolean

True if there is a currently-signed-in user. Exposed as a helper_method, making it available to views.

Using signed_in? is preferable to checking #current_user against nil as it will allow you to introduce a null user object more simply at a later date.

Returns:

  • (Boolean) 


86
87
88
 
# File 'lib/clearance/authentication.rb', line 86

def signed_in?
  clearance_session.signed_in?
end

#signed_out? ⇒ Boolean

True if there is no currently-signed-in user. Exposed as a helper_method, making it available to views.

Usings signed_out? is preferable to checking for presence of #current_user as it will allow you to introduce a null user object more simply at a later date.

Returns:

  • (Boolean) 


96
97
98
 
# File 'lib/clearance/authentication.rb', line 96

def signed_out?
  !signed_in?
end