123456789_123456789_123456789_123456789_123456789_

Module: ActionDispatch::Http::FilterParameters

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Included In:
Defined in: actionpack/lib/action_dispatch/http/filter_parameters.rb

Overview

Action Dispatch HTTP Filter Parameters

Allows you to specify sensitive query string and POST parameters to filter from the request log.

# Replaces values with "[FILTERED]" for keys that match /foo|bar/i.
env["action_dispatch.parameter_filter"] = [:foo, "bar"]

For more information about filter behavior, see ::ActiveSupport::ParameterFilter.

Instance Method Summary

Instance Method Details

#env_filter (private)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/filter_parameters.rb', line 56

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_env

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

[ GitHub ]

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

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

#filtered_parameters

Returns a hash of parameters with all sensitive data replaced.

[ GitHub ]

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

def filtered_parameters
  @filtered_parameters ||= parameter_filter.filter(parameters)
rescue ActionDispatch::Http::Parameters::ParseError
  @filtered_parameters = {}
end

#filtered_path

Reconstructs a path with all sensitive GET parameters replaced.

[ GitHub ]

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

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

#filtered_query_string (private)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/filter_parameters.rb', line 67

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

#initialize

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/filter_parameters.rb', line 21

def initialize
  super
  @filtered_parameters = nil
  @filtered_env        = nil
  @filtered_path       = nil
  @parameter_filter    = nil
end

#parameter_filter

Returns the ::ActiveSupport::ParameterFilter object used to filter in this request.

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/filter_parameters.rb', line 47

def parameter_filter
  @parameter_filter ||= if has_header?("action_dispatch.parameter_filter")
    parameter_filter_for get_header("action_dispatch.parameter_filter")
  else
    NULL_PARAM_FILTER
  end
end

#parameter_filter_for(filters) (private)

[ GitHub ]

  
# File 'actionpack/lib/action_dispatch/http/filter_parameters.rb', line 63

def parameter_filter_for(filters) # :doc:
  ActiveSupport::ParameterFilter.new(filters)
end