(Ruby) IMAP over Multiple Hop SSH

Demonstrates how to read IMAP email (using TCP or TLS) tunneled through mulitple-hop SSH. The scheme looks like this:

Application => ServerSSH1 => ServerSSH2 => IMAPServer

The ConnectThroughSsh and UseSsh methods are added in Chilkat version 9.5.0.55 to accomplish this task.

Chilkat Ruby Downloads install from rubygems.org gem install chilkat or download... Ruby Library for Windows, MacOS, Linux, Alpine Linux

require 'chilkat'

# This example assumes the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.

ssh1 = Chilkat::CkSsh.new()

# Connect directly to the 1st SSH server.
success = ssh1.Connect("serverssh1.com",22)
if (success != true)
    print ssh1.lastErrorText() + "\n";
    exit
end

# Authenticate using login/password:
success = ssh1.AuthenticatePw("ssh1Login","ssh1Password")
if (success != true)
    print ssh1.lastErrorText() + "\n";
    exit
end

# Connect through the 1st SSH connection to reach a 2nd SSH server.
# Note: Any number of SSH connections may be simultaneously tunneled through a single
# existing SSH connection.
ssh2 = Chilkat::CkSsh.new()
success = ssh2.ConnectThroughSsh(ssh1,"serverssh2.com",22)
if (success != true)
    print ssh2.lastErrorText() + "\n";
    exit
end

# Authenticate with ssh2...
success = ssh2.AuthenticatePw("ssh2Login","ssh2Password")
if (success != true)
    print ssh2.lastErrorText() + "\n";
    exit
end

imap = Chilkat::CkImap.new()

# Tell the IMAP object to connect to the IMAP server though the ssh2 tunnel (which itself is routed through ssh1).
# The connection looks like this:  Application => ServerSSH1 => ServerSSH2 => IMAPServer
success = imap.UseSsh(ssh2)
if (success != true)
    print imap.lastErrorText() + "\n";
    exit
end

imap.put_Ssl(true)
imap.put_Port(993)

# Connect to an IMAP server (through the multi-hop SSH tunnel)
success = imap.Connect("imap.someimapserver.com")
if (success != true)
    print imap.lastErrorText() + "\n";
    exit
end

# Login
success = imap.Login("myLogin","myPassword")
if (success != true)
    print imap.lastErrorText() + "\n";
    exit
end

# Do whatever needs to be done...  for example,

# Create the new email folder (sub-mailbox) on the IMAP server.
# If no folder path is provided, the new folder is a sub-mailbox of Inbox.
success = imap.CreateMailbox("newFolder")
if (success != true)
    print imap.lastErrorText() + "\n";
    exit
end

print "Success." + "\n";

# Close the connection with the IMAP server.  (This closes the tunnel through ssh2)
# The connection with ssh2 is still alive, and may be used for more connections.
success = imap.Disconnect()

# Close the connection with ssh2.  (This closes the the tunnel through ssh1.)
# The connection with ssh1 is still alive, and may be used for more connections.
ssh2.Disconnect()

ssh1.Disconnect()