Sha256: 8ba284ff5f934450e3bc21f7e22d9b6d8a0b672e2e5efa530e3a43f780368d80

Contents?: true

Size: 1.54 KB

Versions: 73

Compression:

Stored size: 1.54 KB

Contents

# frozen_string_literal: true

module ActiveRecord
  module SecureToken
    extend ActiveSupport::Concern

    module ClassMethods
      # Example using #has_secure_token
      #
      #   # Schema: User(token:string, auth_token:string)
      #   class User < ActiveRecord::Base
      #     has_secure_token
      #     has_secure_token :auth_token
      #   end
      #
      #   user = User.new
      #   user.save
      #   user.token # => "pX27zsMN2ViQKta1bGfLmVJE"
      #   user.auth_token # => "77TMHrHJFvFDwodq8w7Ev2m7"
      #   user.regenerate_token # => true
      #   user.regenerate_auth_token # => true
      #
      # <tt>SecureRandom::base58</tt> is used to generate the 24-character unique token, so collisions are highly unlikely.
      #
      # Note that it's still possible to generate a race condition in the database in the same way that
      # {validates_uniqueness_of}[rdoc-ref:Validations::ClassMethods#validates_uniqueness_of] can.
      # You're encouraged to add a unique index in the database to deal with this even more unlikely scenario.
      def has_secure_token(attribute = :token)
        # Load securerandom only when has_secure_token is used.
        require "active_support/core_ext/securerandom"
        define_method("regenerate_#{attribute}") { update! attribute => self.class.generate_unique_secure_token }
        before_create { send("#{attribute}=", self.class.generate_unique_secure_token) unless send("#{attribute}?") }
      end

      def generate_unique_secure_token
        SecureRandom.base58(24)
      end
    end
  end
end

Version data entries

73 entries across 73 versions & 7 rubygems

Version Path
activerecord-5.2.6 lib/active_record/secure_token.rb
activerecord-6.0.3.7 lib/active_record/secure_token.rb
activerecord-5.2.4.6 lib/active_record/secure_token.rb
activerecord-6.0.3.6 lib/active_record/secure_token.rb
activerecord-5.2.5 lib/active_record/secure_token.rb
activerecord-6.0.3.5 lib/active_record/secure_token.rb
activerecord-5.2.4.5 lib/active_record/secure_token.rb
activerecord-6.0.3.4 lib/active_record/secure_token.rb
activerecord-5.2.4.4 lib/active_record/secure_token.rb
activerecord-6.0.3.3 lib/active_record/secure_token.rb
activerecord-6.0.3.2 lib/active_record/secure_token.rb
activerecord-6.0.3.1 lib/active_record/secure_token.rb
activerecord-5.2.4.3 lib/active_record/secure_token.rb
activerecord-6.0.3 lib/active_record/secure_token.rb
activerecord-6.0.3.rc1 lib/active_record/secure_token.rb
activerecord-6.0.2.2 lib/active_record/secure_token.rb
activerecord-5.2.4.2 lib/active_record/secure_token.rb
argon-1.3.1 vendor/bundle/ruby/2.7.0/gems/activerecord-6.0.2.1/lib/active_record/secure_token.rb
symbolic_enum-1.1.5 vendor/bundle/ruby/2.7.0/gems/activerecord-6.0.2.1/lib/active_record/secure_token.rb
activerecord-6.0.2.1 lib/active_record/secure_token.rb