класс ActionDispatch::RemoteIp

Родитель:: Объект

Этот промежуточный обработчик вычисляет IP-адрес удалённого клиента, который делает запрос. Он делает это, проверяя различные заголовки, которые могут содержать адрес, а затем выбирая последний установленный адрес, который не находится в списке доверенных IP-адресов. Это соответствует принципу, заданному, например, сервером Tomcat, с объяснением логики @gingerlime. Более подробное объяснение алгоритма приведено по адресу GetIp#calculate_ip.

Некоторые серверы Rack конкатенируют повторяющиеся заголовки, как того требует HTTP RFC 2616. Некоторые серверы Rack просто отбрасывают предыдущие заголовки и сообщают только значение, которое было установлено в последнем заголовке. Если вы находитесь за несколькими прокси-серверами (например, NGINX к HAProxy к Unicorn), вам следует проверить ваш сервер Rack, чтобы убедиться, что ваши данные корректны.

ЕСЛИ ВЫ НЕ ИСПОЛЬЗУЕТЕ ПРОКСИ, ЭТО ДЕЛАЕТ ВАС УЯЗВИМЫМ К ПОДМЕНЕ IP-АДРЕСА. Этот промежуточный обработчик предполагает, что есть как минимум один прокси-сервер, который устанавливает заголовки с IP-адресом удалённого клиента. Если вы не используете прокси, например, разместив приложение на Heroku без SSL, любой клиент может заявить о любом IP-адресе, установив заголовок X-Forwarded-For. Если вам это важно, вам необходимо явно отбросить или проигнорировать эти заголовки до запуска этого промежуточного обработчика.

Константы

TRUSTED_PROXIES: Список доверенных IP-адресов по умолчанию включает IP-адреса, которые гарантированно являются частными адресами по спецификации IP. Эти адреса не будут конечными IP-адресами клиента в рабочей среде и поэтому отбрасываются. Подробнее см. en.wikipedia.org/wiki/Private_network.

Атрибуты

check_ip[R]

proxies[R]

Публичные методы класса

new(app, ip_spoofing_check = true, custom_proxies = nil) Показать исходный код

# File actionpack/lib/action_dispatch/middleware/remote_ip.rb, line 62
def initialize(app, ip_spoofing_check = true, custom_proxies = nil)
  @app = app
  @check_ip = ip_spoofing_check
  @proxies = if custom_proxies.blank?
    TRUSTED_PROXIES
  elsif custom_proxies.respond_to?(:any?)
    custom_proxies
  else
    Array(custom_proxies) + TRUSTED_PROXIES
  end
end

Создать новый RemoteIp экземпляр промежуточного обработчика.

Опция ip_spoofing_check включена по умолчанию. При включении, если похоже, что клиент пытается скрыть свой собственный IP-адрес, вызывается исключение. Имеет смысл отключить эту проверку на сайтах, ориентированных на клиентов, не использующих IP-адреса (например, WAP-устройства) или за прокси-серверами, которые устанавливают заголовки некорректно или запутанно (например, AWS ELB).

Аргумент custom_proxies может принимать Array строк, объектов IPAddr или Regexp объектов, которые будут использоваться вместо TRUSTED_PROXIES. Если предоставлен один строковый, IPAddr или Regexp объект, он будет добавлен к TRUSTED_PROXIES. Любая настройка прокси поместит нужное значение посередине (или в начале) списка X-Forwarded-For, при этом ваши прокси-серверы будут после него. Если ваши прокси-серверы не должны удаляться, передайте их через параметр custom_proxies. Таким образом, промежуточный обработчик проигнорирует эти IP-адреса и вернёт нужный вам.

Публичные методы экземпляра

call(env) Показать исходный код

# File actionpack/lib/action_dispatch/middleware/remote_ip.rb, line 78
def call(env)
  req = ActionDispatch::Request.new env
  req.remote_ip = GetIp.new(req, check_ip, proxies)
  @app.call(req.env)
end

Поскольку IP-адрес может не потребоваться, мы сохраняем объект здесь без вычисления IP, чтобы не замедляться большинство запросов. Для запросов, которым нужно знать IP-адрес, метод GetIp#calculate_ip вычислит кешированный IP-адрес клиента.