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.

Ruby

require 'chilkat'

success = false

# 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()