2009-12-30 17:19:33 +00:00
|
|
|
require 'devise/models/activatable'
|
|
|
|
|
|
|
|
module Devise
|
|
|
|
module Models
|
|
|
|
|
2010-01-24 23:22:45 +00:00
|
|
|
# Handles blocking a user access after a certain number of attempts.
|
|
|
|
# Lockable accepts two different strategies to unlock a user after it's
|
|
|
|
# blocked: email and time. The former will send an email to the user when
|
|
|
|
# the lock happens, containing a link to unlock it's account. The second
|
|
|
|
# will unlock the user automatically after some configured time (ie 2.hours).
|
|
|
|
# It's also possible to setup lockable to use both email and time strategies.
|
|
|
|
#
|
|
|
|
# Configuration:
|
|
|
|
#
|
|
|
|
# maximum_attempts: how many attempts should be accepted before blocking the user.
|
|
|
|
# unlock_strategy: unlock the user account by :time, :email or :both.
|
|
|
|
# unlock_in: the time you want to lock the user after to lock happens. Only
|
|
|
|
# available when unlock_strategy is :time or :both.
|
|
|
|
#
|
2009-12-30 17:19:33 +00:00
|
|
|
module Lockable
|
2010-02-17 11:35:38 +00:00
|
|
|
extend ActiveSupport::Concern
|
2009-12-30 17:19:33 +00:00
|
|
|
include Devise::Models::Activatable
|
|
|
|
|
|
|
|
# Lock an user setting it's locked_at to actual time.
|
2010-03-10 15:13:54 +00:00
|
|
|
def lock_access!
|
2010-03-28 21:09:28 +00:00
|
|
|
return true if access_locked?
|
2009-12-30 17:19:33 +00:00
|
|
|
self.locked_at = Time.now
|
2010-03-10 15:13:54 +00:00
|
|
|
|
2010-03-28 21:09:28 +00:00
|
|
|
if self.class.unlock_strategy_enabled?(:email)
|
2009-12-30 17:19:33 +00:00
|
|
|
generate_unlock_token
|
2010-01-24 01:40:32 +00:00
|
|
|
send_unlock_instructions
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
2010-01-09 15:12:24 +00:00
|
|
|
|
2010-02-16 13:31:49 +00:00
|
|
|
save(:validate => false)
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
|
|
|
|
2010-01-24 23:22:45 +00:00
|
|
|
# Unlock an user by cleaning locket_at and failed_attempts.
|
2010-03-10 15:13:54 +00:00
|
|
|
def unlock_access!
|
|
|
|
if_access_locked do
|
2009-12-30 17:19:33 +00:00
|
|
|
self.locked_at = nil
|
|
|
|
self.failed_attempts = 0
|
|
|
|
self.unlock_token = nil
|
2010-02-16 13:31:49 +00:00
|
|
|
save(:validate => false)
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2010-01-24 23:22:45 +00:00
|
|
|
# Verifies whether a user is locked or not.
|
2010-03-10 15:13:54 +00:00
|
|
|
def access_locked?
|
2010-01-24 01:40:32 +00:00
|
|
|
locked_at && !lock_expired?
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
# Send unlock instructions by email
|
|
|
|
def send_unlock_instructions
|
2010-02-17 11:25:20 +00:00
|
|
|
::Devise::Mailer.unlock_instructions(self).deliver
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
|
|
|
|
2010-01-24 23:22:45 +00:00
|
|
|
# Resend the unlock instructions if the user is locked.
|
2010-03-10 15:13:54 +00:00
|
|
|
def resend_unlock_token
|
2010-03-28 21:09:28 +00:00
|
|
|
if_access_locked { send_unlock_instructions }
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
# Overwrites active? from Devise::Models::Activatable for locking purposes
|
|
|
|
# by verifying whether an user is active to sign in or not based on locked?
|
|
|
|
def active?
|
2010-03-10 15:13:54 +00:00
|
|
|
super && !access_locked?
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
|
|
|
|
2010-01-24 01:40:32 +00:00
|
|
|
# Overwrites invalid_message from Devise::Models::Authenticatable to define
|
|
|
|
# the correct reason for blocking the sign in.
|
|
|
|
def inactive_message
|
2010-03-10 15:13:54 +00:00
|
|
|
access_locked? ? :locked : super
|
2010-01-24 01:40:32 +00:00
|
|
|
end
|
|
|
|
|
2009-12-30 17:19:33 +00:00
|
|
|
# Overwrites valid_for_authentication? from Devise::Models::Authenticatable
|
|
|
|
# for verifying whether an user is allowed to sign in or not. If the user
|
|
|
|
# is locked, it should never be allowed.
|
|
|
|
def valid_for_authentication?(attributes)
|
2010-01-13 17:23:04 +00:00
|
|
|
if result = super
|
|
|
|
self.failed_attempts = 0
|
|
|
|
else
|
2009-12-30 17:19:33 +00:00
|
|
|
self.failed_attempts += 1
|
2010-03-28 21:09:28 +00:00
|
|
|
lock_access! if failed_attempts > self.class.maximum_attempts
|
2009-12-30 17:19:33 +00:00
|
|
|
end
|
2010-02-16 13:31:49 +00:00
|
|
|
save(:validate => false) if changed?
|
2009-12-30 17:19:33 +00:00
|
|
|
result
|
|
|
|
end
|
|
|
|
|
|
|
|
protected
|
|
|
|
|
|
|
|
# Generates unlock token
|
|
|
|
def generate_unlock_token
|
|
|
|
self.unlock_token = Devise.friendly_token
|
|
|
|
end
|
|
|
|
|
|
|
|
# Tells if the lock is expired if :time unlock strategy is active
|
|
|
|
def lock_expired?
|
2010-03-28 21:09:28 +00:00
|
|
|
if self.class.unlock_strategy_enabled?(:time)
|
2010-01-24 01:40:32 +00:00
|
|
|
locked_at && locked_at < self.class.unlock_in.ago
|
2009-12-30 17:19:33 +00:00
|
|
|
else
|
|
|
|
false
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
# Checks whether the record is locked or not, yielding to the block
|
|
|
|
# if it's locked, otherwise adds an error to email.
|
2010-03-10 15:13:54 +00:00
|
|
|
def if_access_locked
|
|
|
|
if access_locked?
|
2009-12-30 17:19:33 +00:00
|
|
|
yield
|
|
|
|
else
|
2010-02-16 16:00:36 +00:00
|
|
|
self.errors.add(:email, :not_locked)
|
2009-12-30 17:19:33 +00:00
|
|
|
false
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
module ClassMethods
|
|
|
|
# Attempt to find a user by it's email. If a record is found, send new
|
|
|
|
# unlock instructions to it. If not user is found, returns a new user
|
|
|
|
# with an email not found error.
|
|
|
|
# Options must contain the user email
|
|
|
|
def send_unlock_instructions(attributes={})
|
|
|
|
lockable = find_or_initialize_with_error_by(:email, attributes[:email], :not_found)
|
2010-03-10 15:13:54 +00:00
|
|
|
lockable.resend_unlock_token unless lockable.new_record?
|
2009-12-30 17:19:33 +00:00
|
|
|
lockable
|
|
|
|
end
|
|
|
|
|
|
|
|
# Find a user by it's unlock token and try to unlock it.
|
|
|
|
# If no user is found, returns a new user with an error.
|
|
|
|
# If the user is not locked, creates an error for the user
|
|
|
|
# Options must have the unlock_token
|
2010-03-10 15:13:54 +00:00
|
|
|
def unlock_access_by_token(unlock_token)
|
|
|
|
lockable = find_or_initialize_with_error_by(:unlock_token, unlock_token)
|
|
|
|
lockable.unlock_access! unless lockable.new_record?
|
2009-12-30 17:19:33 +00:00
|
|
|
lockable
|
|
|
|
end
|
|
|
|
|
2010-03-28 21:09:28 +00:00
|
|
|
# Is the unlock enabled for the given unlock strategy?
|
|
|
|
def unlock_strategy_enabled?(strategy)
|
|
|
|
[:both, strategy].include?(self.unlock_strategy)
|
|
|
|
end
|
|
|
|
|
2009-12-30 17:19:33 +00:00
|
|
|
Devise::Models.config(self, :maximum_attempts, :unlock_strategy, :unlock_in)
|
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|
2010-01-24 01:40:32 +00:00
|
|
|
end
|