класс ActionDispatch::RemoteIp::GetIp
Класс GetIp предназначен для отложенной обработки данных запроса с целью получения фактического IP-адреса. Если вызовется метод ActionDispatch::Request#remote_ip, этот класс рассчитает значение и затем кэширует его.
Публичные методы класса
# File actionpack/lib/action_dispatch/middleware/remote_ip.rb, line 103 def initialize(req, check_ip, proxies) @req = req @check_ip = check_ip @proxies = proxies end
Публичные методы экземпляра
# File actionpack/lib/action_dispatch/middleware/remote_ip.rb, line 128
def calculate_ip
# Set by the Rack web server, this is a single value.
remote_addr = ips_from(@req.remote_addr).last
# Could be a CSV list and/or repeated headers that were concatenated.
client_ips = ips_from(@req.client_ip).reverse!
forwarded_ips = ips_from(@req.x_forwarded_for).reverse!
# `Client-Ip` and `X-Forwarded-For` should not, generally, both be set. If they
# are both set, it means that either:
#
# 1) This request passed through two proxies with incompatible IP header
# conventions.
#
# 2) The client passed one of `Client-Ip` or `X-Forwarded-For`
# (whichever the proxy servers weren't using) themselves.
#
# Either way, there is no way for us to determine which header is the right one
# after the fact. Since we have no idea, if we are concerned about IP spoofing
# we need to give up and explode. (If you're not concerned about IP spoofing you
# can turn the `ip_spoofing_check` option off.)
should_check_ip = @check_ip && client_ips.last && forwarded_ips.last
if should_check_ip && !forwarded_ips.include?(client_ips.last)
# We don't know which came from the proxy, and which from the user
raise IpSpoofAttackError, "IP spoofing attack?! " \
"HTTP_CLIENT_IP=#{@req.client_ip.inspect} " \
"HTTP_X_FORWARDED_FOR=#{@req.x_forwarded_for.inspect}"
end
# We assume these things about the IP headers:
#
# - X-Forwarded-For will be a list of IPs, one per proxy, or blank
# - Client-Ip is propagated from the outermost proxy, or is blank
# - REMOTE_ADDR will be the IP that made the request to Rack
ips = forwarded_ips + client_ips
ips.compact!
# If every single IP option is in the trusted list, return the IP that's
# furthest away
filter_proxies(ips + [remote_addr]).first || ips.last || remote_addr
end Просматривает различные заголовки IP-адресов, чтобы определить IP-адрес, наиболее вероятно принадлежащий фактическому удалённому клиенту, который сделал запрос.
REMOTE_ADDR будет корректным, если запрос отправлен напрямую в процесс Ruby, например, на Heroku. Когда запрос обрабатывается прокси-сервером, таким как HAProxy или NGINX, IP-адрес исходного запроса будет помещён в заголовок X-Forwarded-For. Если есть несколько прокси, этот заголовок может содержать список IP-адресов. Другие прокси-сервисы устанавливают заголовок Client-Ip, поэтому мы также проверяем его.
Как обсуждалось в [этой записи о Rails подделке IP-адресов](web.archive.org/web/20170626095448/https://blog.gingerlime.com/2012/rails-ip-spoofing-vulnerabilities-and-protection/), хотя первый IP-адрес в списке, вероятно, является «исходным», он также может быть злонамеренно установлен клиентом.
Чтобы найти первый адрес, который, вероятно, точный, мы берём список IP-адресов, удаляем известные и доверенные прокси и затем берём последний оставшийся адрес, который, предположительно, был установлен одним из этих прокси.
# File actionpack/lib/action_dispatch/middleware/remote_ip.rb, line 172 def to_s @ip ||= calculate_ip end
Кэширует значение, возвращённое методом calculate_ip, и возвращает его для использования в ActionDispatch::Request.
Приватные методы экземпляра
# File actionpack/lib/action_dispatch/middleware/remote_ip.rb, line 192
def filter_proxies(ips) # :doc:
ips.reject do |ip|
@proxies.any? { |proxy| proxy === ip }
end
end # File actionpack/lib/action_dispatch/middleware/remote_ip.rb, line 177
def ips_from(header) # :doc:
return [] unless header
# Split the comma-separated list into an array of strings.
ips = header.strip.split(/[,\s]+/)
ips.select! do |ip|
# Only return IPs that are valid according to the IPAddr#new method.
range = IPAddr.new(ip).to_range
# We want to make sure nobody is sneaking a netmask in.
range.begin == range.end
rescue ArgumentError
nil
end
ips
end
© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.