class Net::SSH::Proxy::Jump

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

require 'net/ssh/proxy/jump'

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

Attributes

jump_proxies[R]

The jump proxies

Public Class Methods

new(jump_proxies) click to toggle source

Create a new socket factory that tunnels via multiple jump proxes as [user@]host.

# File lib/net/ssh/proxy/jump.rb, line 23
def initialize(jump_proxies)
  @jump_proxies = jump_proxies
end

Public Instance Methods

build_proxy_command_equivalent(connection_options = nil) click to toggle source

We cannot build the ProxyCommand template until we know if the :config option was specified during `Net::SSH.start`.

# File lib/net/ssh/proxy/jump.rb, line 36
def build_proxy_command_equivalent(connection_options = nil)
  first_jump, extra_jumps = jump_proxies.split(",", 2)
  config = connection_options && connection_options[:config]
  uri = URI.parse("ssh://#{first_jump}")

  template = "ssh"
  template << " -l #{uri.user}"    if uri.user
  template << " -p #{uri.port}"    if uri.port
  template << " -J #{extra_jumps}" if extra_jumps
  template << " -F #{config}" if config != true && config
  template << " -W %h:%p "
  template << uri.host

  @command_line_template = template
end
open(host, port, connection_options = nil) click to toggle source

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

Calls superclass method Net::SSH::Proxy::Command#open
# File lib/net/ssh/proxy/jump.rb, line 29
def open(host, port, connection_options = nil)
  build_proxy_command_equivalent(connection_options)
  super
end