Module: ActionDispatch::Http::FilterParameters

Extended by:
ActiveSupport::Concern
Included in:
Request
Defined in:
lib/action_dispatch/http/filter_parameters.rb

Overview

Allows you to specify sensitive parameters which will be replaced from the request log by looking in the query string of the request and all subhashes of the params hash to filter. If a block is given, each key and value of the params hash and all subhashes is passed to it, the value or key can be replaced using String#replace or similar method.

Examples:

env["action_dispatch.parameter_filter"] = [:password]
=> replaces the value to all keys matching /password/i with "[FILTERED]"

env["action_dispatch.parameter_filter"] = [:foo, "bar"]
=> replaces the value to all keys matching /foo|bar/i with "[FILTERED]"

env["action_dispatch.parameter_filter"] = lambda do |k,v|
  v.reverse! if k =~ /secret/i
end
=> reverses the value to all keys matching /secret/i

Instance Method Summary collapse

Instance Method Details

#filtered_env ⇒ Object

Return a hash of request.env with all sensitive data replaced.



35
36
37
 
# File 'lib/action_dispatch/http/filter_parameters.rb', line 35

def filtered_env
  @filtered_env ||= env_filter.filter(@env)
end

#filtered_parameters ⇒ Object

Return a hash of parameters with all sensitive data replaced.



30
31
32
 
# File 'lib/action_dispatch/http/filter_parameters.rb', line 30

def filtered_parameters
  @filtered_parameters ||= parameter_filter.filter(parameters)
end

#filtered_path ⇒ Object

Reconstructed a path with all sensitive GET parameters replaced.



40
41
42
 
# File 'lib/action_dispatch/http/filter_parameters.rb', line 40

def filtered_path
  @filtered_path ||= query_string.empty? ? path : "#{path}?#{filtered_query_string}"
end