123456789_123456789_123456789_123456789_123456789_

Class: WEBrick::HTTPProxyServer

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
Instance Chain:
Inherits: WEBrick::HTTPServer
Defined in: lib/webrick/httpproxy.rb

Overview

An HTTP Proxy server which proxies GET, HEAD and POST requests.

To create a simple proxy server:

require 'webrick'
require 'webrick/httpproxy'

proxy = WEBrick::HTTPProxyServer.new Port: 8000

trap 'INT'  do proxy.shutdown end
trap 'TERM' do proxy.shutdown end

proxy.start

See .new for proxy-specific configuration items.

Modifying proxied responses

To modify content the proxy server returns use the :ProxyContentHandler option:

handler = proc do |req, res|
  if res['content-type'] == 'text/plain' then
    res.body << "\nThis content was proxied!\n"
  end
end

proxy =
  WEBrick::HTTPProxyServer.new Port: 8000, ProxyContentHandler: handler

Constant Summary

Class Method Summary

HTTPServer - Inherited

.new

Creates a new HTTP server according to config

GenericServer - Inherited

.new

Creates a new generic server from config.

Instance Attribute Summary

GenericServer - Inherited

#config

The server configuration.

#listeners

Sockets listening for connections.

#logger

The server logger.

#status

The server status.

#tokens

Tokens control the number of outstanding clients.

Instance Method Summary

HTTPServer - Inherited

#access_log

Logs req and res in the access logs.

#do_OPTIONS

The default OPTIONS request handler says GET, HEAD, POST and OPTIONS requests are allowed.

#lookup_server

Finds the appropriate virtual host to handle req

#mount

Mounts servlet on dir passing options to the servlet at creation time.

#mount_proc

Mounts proc or block on dir and calls it with a HTTPRequest and HTTPResponse

#run

Processes requests on sock

#search_servlet

Finds a servlet for path

#service

Services req and fills in res

#ssl_servername_callback

ServerNameIndication callback.

#umount
#unmount

Unmounts dir

#orig_virtual_host

Check whether server is also SSL server.

#virtual_host

Adds server as a virtual host.

GenericServer - Inherited

#[]

Retrieves key from the configuration.

#run

You must subclass GenericServer and implement #run which accepts a TCP client socket.

#shutdown

Shuts down the server and all listening sockets.

#ssl_servername_callback

ServerNameIndication callback.

#start

Starts the server and runs the block for each connection.

#stop

Stops the server from accepting new connections.

#listen

Updates listen to enable SSL when the SSL configuration is active.

#setup_ssl_context

Sets up an SSL context for config

#ssl_context

SSL context for the server when run in SSL mode.

#accept_client

Accepts a TCP client socket from the TCP server socket svr and returns the client socket.

#alarm_shutdown_pipe,
#call_callback

Calls the callback callback_name from the configuration with args

#cleanup_listener, #cleanup_shutdown_pipe, #setup_shutdown_pipe,
#start_thread

Starts a server thread for the client socket sock that runs the given block.

Constructor Details

.new(config = {}, default = Config::HTTP) ⇒ HTTPProxyServer

Proxy server configurations. The proxy server handles the following configuration items in addition to those supported by HTTPServer:

:ProxyAuthProc

Called with a request and response to authorize a request

:ProxyVia

Appended to the via header

:ProxyURI

The proxy server's URI

:ProxyContentHandler

Called with a request and response and allows modification of the response

:ProxyTimeout

Sets the proxy timeouts to 30 seconds for open and 60 seconds for read operations

[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 84

def initialize(config={}, default=Config::HTTP)
  super(config, default)
  c = @config
  @via = "#{c[:HTTPVersion]} #{c[:ServerName]}:#{c[:Port]}"
end

Instance Method Details

#choose_header(src, dst) (private)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 243

def choose_header(src, dst)
  connections = split_field(src['connection'])
  src.each{|key, value|
    key = key.downcase
    if HopByHop.member?(key)          || # RFC2616: 13.5.1
       connections.member?(key)       || # RFC2616: 14.10
       ShouldNotTransfer.member?(key)    # pragmatics
      @logger.debug("choose_header: `#{key}: #{value}'")
      next
    end
    dst[key] = value
  }
end

#do_CONNECT(req, res)

This method is for internal use only.

Raises:

  • (HTTPStatus::InternalServerError)
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 133

def do_CONNECT(req, res)
  # Proxy Authentication
  proxy_auth(req, res)

  ua = Thread.current[:WEBrickSocket]  # User-Agent
  raise HTTPStatus::InternalServerError,
    "[BUG] cannot get socket" unless ua

  host, port = req.unparsed_uri.split(":", 2)
  # Proxy authentication for upstream proxy server
  if proxy = proxy_uri(req, res)
    proxy_request_line = "CONNECT #{host}:#{port} HTTP/1.0"
    if proxy.userinfo
      credentials = "Basic " + [proxy.userinfo].pack("m0")
    end
    host, port = proxy.host, proxy.port
  end

  begin
    @logger.debug("CONNECT: upstream proxy is `#{host}:#{port}'.")
    os = TCPSocket.new(host, port)     # origin server

    if proxy
      @logger.debug("CONNECT: sending a Request-Line")
      os << proxy_request_line << CRLF
      @logger.debug("CONNECT: > #{proxy_request_line}")
      if credentials
        @logger.debug("CONNECT: sending credentials")
        os << "Proxy-Authorization: " << credentials << CRLF
      end
      os << CRLF
      proxy_status_line = os.gets(LF)
      @logger.debug("CONNECT: read Status-Line from the upstream server")
      @logger.debug("CONNECT: < #{proxy_status_line}")
      if %r{^HTTP/\d\.\d\s+200\s*} =~ proxy_status_line
        while line = os.gets(LF)
          break if /\A(#{CRLF}|#{LF})\z/om =~ line
        end
      else
        raise HTTPStatus::BadGateway
      end
    end
    @logger.debug("CONNECT #{host}:#{port}: succeeded")
    res.status = HTTPStatus::RC_OK
  rescue => ex
    @logger.debug("CONNECT #{host}:#{port}: failed `#{ex.message}'")
    res.set_error(ex)
    raise HTTPStatus::EOFError
  ensure
    if handler = @config[:ProxyContentHandler]
      handler.call(req, res)
    end
    res.send_response(ua)
    access_log(@config, req, res)

    # Should clear request-line not to send the response twice.
    # see: HTTPServer#run
    req.parse(NullReader) rescue nil
  end

  begin
    while fds = IO::select([ua, os])
      if fds[0].member?(ua)
        buf = ua.readpartial(1024);
        @logger.debug("CONNECT: #{buf.bytesize} byte from User-Agent")
        os.write(buf)
      elsif fds[0].member?(os)
        buf = os.readpartial(1024);
        @logger.debug("CONNECT: #{buf.bytesize} byte from #{host}:#{port}")
        ua.write(buf)
      end
    end
  rescue
    os.close
    @logger.debug("CONNECT #{host}:#{port}: closed")
  end

  raise HTTPStatus::EOFError
end

#do_GET(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 213

def do_GET(req, res)
  perform_proxy_request(req, res) do |http, path, header|
    http.get(path, header)
  end
end

#do_HEAD(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 219

def do_HEAD(req, res)
  perform_proxy_request(req, res) do |http, path, header|
    http.head(path, header)
  end
end

#do_OPTIONS(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 231

def do_OPTIONS(req, res)
  res['allow'] = "GET,HEAD,POST,OPTIONS,CONNECT"
end

#do_POST(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 225

def do_POST(req, res)
  perform_proxy_request(req, res) do |http, path, header|
    http.post(path, req.body || "", header)
  end
end

#perform_proxy_request(req, res) (private)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 304

def perform_proxy_request(req, res)
  uri = req.request_uri
  path = uri.path.dup
  path << "?" << uri.query if uri.query
  header = setup_proxy_header(req, res)
  upstream = setup_upstream_proxy_authentication(req, res, header)
  response = nil

  http = Net::HTTP.new(uri.host, uri.port, upstream.host, upstream.port)
  http.start do
    if @config[:ProxyTimeout]
      ##################################   these issues are
      http.open_timeout = 30   # secs  #   necessary (maybe because
      http.read_timeout = 60   # secs  #   Ruby's bug, but why?)
      ##################################
    end
    response = yield(http, path, header)
  end

  # Persistent connection requirements are mysterious for me.
  # So I will close the connection in every response.
  res['proxy-connection'] = "close"
  res['connection'] = "close"

  # Convert Net::HTTP::HTTPResponse to WEBrick::HTTPResponse
  res.status = response.code.to_i
  choose_header(response, res)
  set_cookie(response, res)
  set_via(res)
  res.body = response.body
end

#proxy_auth(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 101

def proxy_auth(req, res)
  if proc = @config[:ProxyAuthProc]
    proc.call(req, res)
  end
  req.header.delete("proxy-authorization")
end

#proxy_service(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 113

def proxy_service(req, res)
  # Proxy Authentication
  proxy_auth(req, res)

  begin
    self.send("do_#{req.request_method}", req, res)
  rescue NoMethodError
    raise HTTPStatus::MethodNotAllowed,
      "unsupported method `#{req.request_method}'."
  rescue => err
    logger.debug("#{err.class}: #{err.message}")
    raise HTTPStatus::ServiceUnavailable, err.message
  end

  # Process contents
  if handler = @config[:ProxyContentHandler]
    handler.call(req, res)
  end
end

#proxy_uri(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 108

def proxy_uri(req, res)
  # should return upstream proxy server's URI
  return @config[:ProxyURI]
end

#service(req, res)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 91

def service(req, res)
  if req.request_method == "CONNECT"
    do_CONNECT(req, res)
  elsif req.unparsed_uri =~ %r!^http://!
    proxy_service(req, res)
  else
    super(req, res)
  end
end

#set_via(h) (private)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 275

def set_via(h)
  if @config[:ProxyVia]
    if  h['via']
      h['via'] << ", " << @via
    else
      h['via'] = @via
    end
  end
end

#setup_proxy_header(req, res) (private)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 285

def setup_proxy_header(req, res)
  # Choose header fields to transfer
  header = Hash.new
  choose_header(req, header)
  set_via(header)
  return header
end

#setup_upstream_proxy_authentication(req, res, header) (private)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 293

def setup_upstream_proxy_authentication(req, res, header)
  if upstream = proxy_uri(req, res)
    if upstream.userinfo
      header['proxy-authorization'] =
        "Basic " + [upstream.userinfo].pack("m0")
    end
    return upstream
  end
  return FakeProxyURI
end

#split_field(f) (private)

This method is for internal use only.
[ GitHub ]

  
# File 'lib/webrick/httpproxy.rb', line 241

def split_field(f) f ? f.split(/,\s+/).collect{|i| i.downcase } : [] end