123456789_123456789_123456789_123456789_123456789_

Module: ActiveModel::SecurePassword::InstanceMethodsOnActivation

Relationships & Source Files
Defined in: activemodel/lib/active_model/secure_password.rb

Instance Attribute Summary

Instance Method Summary

Instance Attribute Details

#password (rw)

[ GitHub ]

  
# File 'activemodel/lib/active_model/secure_password.rb', line 100

attr_reader :password

#password=(unencrypted_password) (rw)

Encrypts the password into the password_digest attribute, only if the new password is not empty.

class User < ActiveRecord::Base
  has_secure_password validations: false
end

user = User.new
user.password = nil
user.password_digest # => nil
user.password = 'mUc3m00RsqyRe'
user.password_digest # => "$2a$10$4LEA7r4YmNHtvlAvHhsYAeZmk/xeUVtMTYqwIvYY76EW5GUqDiP4."
[ GitHub ]

  
# File 'activemodel/lib/active_model/secure_password.rb', line 114

def password=(unencrypted_password)
  if unencrypted_password.nil?
    self.password_digest = nil
  elsif !unencrypted_password.empty?
    @password = unencrypted_password
    cost = ActiveModel::SecurePassword.min_cost ? BCrypt::Engine::MIN_COST : BCrypt::Engine.cost
    self.password_digest = BCrypt::Password.create(unencrypted_password, cost: cost)
  end
end

#password_confirmation=(unencrypted_password) (writeonly)

[ GitHub ]

  
# File 'activemodel/lib/active_model/secure_password.rb', line 124

def password_confirmation=(unencrypted_password)
  @password_confirmation = unencrypted_password
end

Instance Method Details

#authenticate(unencrypted_password)

Returns self if the password is correct, otherwise false.

class User < ActiveRecord::Base
  has_secure_password validations: false
end

user = User.new(name: 'david', password: 'mUc3m00RsqyRe')
user.save
user.authenticate('notright')      # => false
user.authenticate('mUc3m00RsqyRe') # => user
[ GitHub ]

  
# File 'activemodel/lib/active_model/secure_password.rb', line 96

def authenticate(unencrypted_password)
  BCrypt::Password.new(password_digest).is_password?(unencrypted_password) && self
end