Xbase++

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.

Xbase++

LOCAL nSuccess
LOCAL oSsh1
LOCAL oSsh2
LOCAL oImap

nSuccess := 0

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

oSsh1 := CreateObject("Chilkat.Ssh")

//  Connect directly to the 1st SSH server.
nSuccess := oSsh1:Connect("serverssh1.com", 22)
IF (nSuccess != 1)
    ? oSsh1:LastErrorText
    oSsh1:destroy()
    RETURN
ENDIF

//  Authenticate using login/password:
nSuccess := oSsh1:AuthenticatePw("ssh1Login", "ssh1Password")
IF (nSuccess != 1)
    ? oSsh1:LastErrorText
    oSsh1:destroy()
    RETURN
ENDIF

//  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.
oSsh2 := CreateObject("Chilkat.Ssh")
nSuccess := oSsh2:ConnectThroughSsh(oSsh1, "serverssh2.com", 22)
IF (nSuccess != 1)
    ? oSsh2:LastErrorText
    oSsh1:destroy()
    oSsh2:destroy()
    RETURN
ENDIF

//  Authenticate with ssh2...
nSuccess := oSsh2:AuthenticatePw("ssh2Login", "ssh2Password")
IF (nSuccess != 1)
    ? oSsh2:LastErrorText
    oSsh1:destroy()
    oSsh2:destroy()
    RETURN
ENDIF

oImap := CreateObject("Chilkat.Imap")

//  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
nSuccess := oImap:UseSsh(oSsh2)
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oSsh1:destroy()
    oSsh2:destroy()
    oImap:destroy()
    RETURN
ENDIF

oImap:Ssl := 1
oImap:Port := 993

//  Connect to an IMAP server (through the multi-hop SSH tunnel)
nSuccess := oImap:Connect("imap.someimapserver.com")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oSsh1:destroy()
    oSsh2:destroy()
    oImap:destroy()
    RETURN
ENDIF

//  Login
nSuccess := oImap:Login("myLogin", "myPassword")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oSsh1:destroy()
    oSsh2:destroy()
    oImap:destroy()
    RETURN
ENDIF

//  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.
nSuccess := oImap:CreateMailbox("newFolder")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oSsh1:destroy()
    oSsh2:destroy()
    oImap:destroy()
    RETURN
ENDIF

? "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.
nSuccess := oImap: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.
oSsh2:Disconnect()

oSsh1:Disconnect()

oSsh1:destroy()
oSsh2:destroy()
oImap:destroy()