Class: Net::SSH::Proxy::HTTP

Inherits:
Object
  • Object
show all
Defined in:
lib/net/ssh/proxy/http.rb

Overview

An implementation of an HTTP proxy. To use it, instantiate it, then pass the instantiated object via the :proxy key to Net::SSH.start:

require 'net/ssh/proxy/http'

proxy = Net::SSH::Proxy::HTTP.new('proxy_host', proxy_port)
Net::SSH.start('host', 'user', :proxy => proxy) do |ssh|
  ...
end

If the proxy requires authentication, you can pass :user and :password to the proxy's constructor:

proxy = Net::SSH::Proxy::HTTP.new('proxy_host', proxy_port,
   :user => "user", :password => "password")

Note that HTTP digest authentication is not supported; Basic only at this point.

Direct Known Subclasses

HTTPS

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(proxy_host, proxy_port = 80, options = {}) ⇒ HTTP

Create a new socket factory that tunnels via the given host and port. The options parameter is a hash of additional settings that can be used to tweak this proxy connection. Specifically, the following options are supported:

  • :user => the user name to use when authenticating to the proxy

  • :password => the password to use when authenticating


44
45
46
47
48
# File 'lib/net/ssh/proxy/http.rb', line 44

def initialize(proxy_host, proxy_port=80, options={})
  @proxy_host = proxy_host
  @proxy_port = proxy_port
  @options = options
end

Instance Attribute Details

#optionsObject (readonly)

The map of additional options that were given to the object at initialization.


35
36
37
# File 'lib/net/ssh/proxy/http.rb', line 35

def options
  @options
end

#proxy_hostObject (readonly)

The hostname or IP address of the HTTP proxy.


28
29
30
# File 'lib/net/ssh/proxy/http.rb', line 28

def proxy_host
  @proxy_host
end

#proxy_portObject (readonly)

The port number of the proxy.


31
32
33
# File 'lib/net/ssh/proxy/http.rb', line 31

def proxy_port
  @proxy_port
end

Instance Method Details

#open(host, port, connection_options) ⇒ Object

Return a new socket connected to the given host and port via the proxy that was requested when the socket factory was instantiated.

Raises:


52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
# File 'lib/net/ssh/proxy/http.rb', line 52

def open(host, port, connection_options)
  socket = establish_connection(connection_options[:timeout])
  socket.write "CONNECT #{host}:#{port} HTTP/1.1\r\n"
  socket.write "Host: #{host}:#{port}\r\n"
    
  if options[:user]
    credentials = ["#{options[:user]}:#{options[:password]}"].pack("m*").gsub(/\s/, "")
    socket.write "Proxy-Authorization: Basic #{credentials}\r\n"
  end
    
  socket.write "\r\n"
    
  resp = parse_response(socket)
    
  return socket if resp[:code] == 200
    
  socket.close
  raise ConnectError, resp.inspect
end