Lua Requires Chilkat v9.5.0.55+

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 used to accomplish this task.

Lua

local chilkat = require("chilkat")

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

local ssh1 = chilkat.Ssh.new()

-- Connect directly to the 1st SSH server.
local success = ssh1:connect("serverssh1.com", 22)
if not success then
    print(ssh1.last_error_text)
    return
end

-- Authenticate using login/password:
success = ssh1:authenticate_pw("ssh1Login", "ssh1Password")
if not success then
    print(ssh1.last_error_text)
    return
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.
local ssh2 = chilkat.Ssh.new()
success = ssh2:connect_through_ssh(ssh1, "serverssh2.com", 22)
if not success then
    print(ssh2.last_error_text)
    return
end

-- Authenticate with ssh2...
success = ssh2:authenticate_pw("ssh2Login", "ssh2Password")
if not success then
    print(ssh2.last_error_text)
    return
end

local imap = chilkat.Imap.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:use_ssh(ssh2)
if not success then
    print(imap.last_error_text)
    return
end

imap.ssl = true
imap.port = 993

-- Connect to an IMAP server (through the multi-hop SSH tunnel)
success = imap:connect("imap.someimapserver.com")
if not success then
    print(imap.last_error_text)
    return
end

-- Login
success = imap:login("myLogin", "myPassword")
if not success then
    print(imap.last_error_text)
    return
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:create_mailbox("newFolder")
if not success then
    print(imap.last_error_text)
    return
end

print("Success.")

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