跳至内容 跳至搜索

Action Dispatch HTTP 过滤器 Parameters

允许您指定敏感查询字符串和 POST 参数以从请求日志中过滤。

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

有关过滤器行为的更多信息,请参阅 ActiveSupport::ParameterFilter

方法
E
F
N
P

常量

KV_RE = "[^&;=]+"
 
PAIR_RE = %r{(#{KV_RE})=(#{KV_RE})}
 

类公共方法

new()

# 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

实例公共方法

filtered_env()

返回一个 request.env 哈希,其中所有敏感数据均已替换。

# File actionpack/lib/action_dispatch/http/filter_parameters.rb, line 37
def filtered_env
  @filtered_env ||= env_filter.filter(@env)
end

filtered_parameters()

返回一个参数哈希,其中所有敏感数据均已替换。

# 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()

使用所有敏感 GET 参数替换后,重建路径。

# 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

parameter_filter()

返回用于在此请求中过滤的 ActiveSupport::ParameterFilter 对象。

# 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

实例私有方法

env_filter()

# 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_query_string()

# File actionpack/lib/action_dispatch/http/filter_parameters.rb, line 69
def filtered_query_string # :doc:
  query_string.gsub(PAIR_RE) do |_|
    parameter_filter.filter($1 => $2).first.join("=")
  end
end

parameter_filter_for(filters)

# File actionpack/lib/action_dispatch/http/filter_parameters.rb, line 63
def parameter_filter_for(filters) # :doc:
  ActiveSupport::ParameterFilter.new(filters)
end