module ActionDispatch::Http::FilterParameters

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 sub-hashes of the params hash to filter. Filtering only certain sub-keys from a hash is possible by using the dot notation: 'credit_card.number'. If a block is given, each key and value of the params hash and all sub-hashes are passed to it, where the value or the key can be replaced using String#replace or similar methods.

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"] = [ "credit_card.code" ]
=> replaces { credit_card: {code: "xxxx"} } with "[FILTERED]", does not
change { file: { code: "xxxx"} }

env["action_dispatch.parameter_filter"] = -> (k, v) do
  v.reverse! if k.match?(/secret/i)
end
=> reverses the value to all keys matching /secret/i

Public Class Methods

new() click to toggle source
Calls superclass method
# File lib/action_dispatch/http/filter_parameters.rb, line 34
def initialize
  super
  @filtered_parameters = nil
  @filtered_env        = nil
  @filtered_path       = nil
end

Public Instance Methods

filtered_env() click to toggle source

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

# File lib/action_dispatch/http/filter_parameters.rb, line 49
def filtered_env
  @filtered_env ||= env_filter.filter(@env)
end
filtered_parameters() click to toggle source

Returns a hash of parameters with all sensitive data replaced.

# File lib/action_dispatch/http/filter_parameters.rb, line 42
def filtered_parameters
  @filtered_parameters ||= parameter_filter.filter(parameters)
rescue ActionDispatch::Http::Parameters::ParseError
  @filtered_parameters = {}
end
filtered_path() click to toggle source

Reconstructs a path with all sensitive GET parameters replaced.

# File lib/action_dispatch/http/filter_parameters.rb, line 54
def filtered_path
  @filtered_path ||= query_string.empty? ? path : "#{path}?#{filtered_query_string}"
end

Private Instance Methods

env_filter() click to toggle source
# File lib/action_dispatch/http/filter_parameters.rb, line 65
def env_filter # :doc:
  user_key = fetch_header("action_dispatch.parameter_filter") {
    return NULL_ENV_FILTER
  }
  parameter_filter_for(Array(user_key) + ENV_MATCH)
end
filtered_query_string() click to toggle source
# File lib/action_dispatch/http/filter_parameters.rb, line 76
def filtered_query_string # :doc:
  parts = query_string.split(/([&;])/)
  filtered_parts = parts.map do |part|
    if part.include?("=")
      key, value = part.split("=", 2)
      parameter_filter.filter(key => value).first.join("=")
    else
      part
    end
  end
  filtered_parts.join("")
end
parameter_filter() click to toggle source
# File lib/action_dispatch/http/filter_parameters.rb, line 59
def parameter_filter # :doc:
  parameter_filter_for fetch_header("action_dispatch.parameter_filter") {
    return NULL_PARAM_FILTER
  }
end
parameter_filter_for(filters) click to toggle source
# File lib/action_dispatch/http/filter_parameters.rb, line 72
def parameter_filter_for(filters) # :doc:
  ActiveSupport::ParameterFilter.new(filters)
end