lib/action_dispatch/middleware/session/cookie_store.rb
require 'active_support/core_ext/hash/keys' require 'active_support/core_ext/object/blank' require 'action_dispatch/middleware/session/abstract_store' require 'rack/session/cookie' module ActionDispatch module Session # This cookie-based session store is the Rails default. Sessions typically # contain at most a user_id and flash message; both fit within the 4K cookie # size limit. Cookie-based sessions are dramatically faster than the # alternatives. # # If you have more than 4K of session data or don't want your data to be # visible to the user, pick another session store. # # CookieOverflow is raised if you attempt to store more than 4K of data. # # A message digest is included with the cookie to ensure data integrity: # a user cannot alter his +user_id+ without knowing the secret key # included in the hash. New apps are generated with a pregenerated secret # in config/environment.rb. Set your own for old apps you're upgrading. # # Session options: # # * <tt>:secret</tt>: An application-wide key string. It's important that # the secret is not vulnerable to a dictionary attack. Therefore, you # should choose a secret consisting of random numbers and letters and # more than 30 characters. # # :secret => '449fe2e7daee471bffae2fd8dc02313d' # # * <tt>:digest</tt>: The message digest algorithm used to verify session # integrity defaults to 'SHA1' but may be any digest provided by OpenSSL, # such as 'MD5', 'RIPEMD160', 'SHA256', etc. # # To generate a secret key for an existing application, run # "rake secret" and set the key in config/initializers/secret_token.rb. # # Note that changing digest or secret invalidates all existing sessions! class CookieStore < Rack::Session::Cookie include Compatibility include StaleSessionCheck private def unpacked_cookie_data(env) env["action_dispatch.request.unsigned_session_cookie"] ||= begin stale_session_check! do request = ActionDispatch::Request.new(env) if data = request.cookie_jar.signed[@key] data.stringify_keys! end data || {} end end end def set_session(env, sid, session_data, options) session_data.merge!("session_id" => sid) end def set_cookie(env, session_id, cookie) request = ActionDispatch::Request.new(env) request.cookie_jar.signed[@key] = cookie end end end end