Visual FoxPro

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.

Visual FoxPro

LOCAL lnSuccess
LOCAL loSsh1
LOCAL loSsh2
LOCAL loImap

lnSuccess = 0

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

loSsh1 = CreateObject('Chilkat.Ssh')

* Connect directly to the 1st SSH server.
lnSuccess = loSsh1.Connect("serverssh1.com",22)
IF (lnSuccess <> 1) THEN
    ? loSsh1.LastErrorText
    RELEASE loSsh1
    CANCEL
ENDIF

* Authenticate using login/password:
lnSuccess = loSsh1.AuthenticatePw("ssh1Login","ssh1Password")
IF (lnSuccess <> 1) THEN
    ? loSsh1.LastErrorText
    RELEASE loSsh1
    CANCEL
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.
loSsh2 = CreateObject('Chilkat.Ssh')
lnSuccess = loSsh2.ConnectThroughSsh(loSsh1,"serverssh2.com",22)
IF (lnSuccess <> 1) THEN
    ? loSsh2.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    CANCEL
ENDIF

* Authenticate with ssh2...
lnSuccess = loSsh2.AuthenticatePw("ssh2Login","ssh2Password")
IF (lnSuccess <> 1) THEN
    ? loSsh2.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    CANCEL
ENDIF

loImap = 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
lnSuccess = loImap.UseSsh(loSsh2)
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    RELEASE loImap
    CANCEL
ENDIF

loImap.Ssl = 1
loImap.Port = 993

* Connect to an IMAP server (through the multi-hop SSH tunnel)
lnSuccess = loImap.Connect("imap.someimapserver.com")
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    RELEASE loImap
    CANCEL
ENDIF

* Login
lnSuccess = loImap.Login("myLogin","myPassword")
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    RELEASE loImap
    CANCEL
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.
lnSuccess = loImap.CreateMailbox("newFolder")
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    RELEASE loImap
    CANCEL
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.
lnSuccess = loImap.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.
loSsh2.Disconnect()

loSsh1.Disconnect()

RELEASE loSsh1
RELEASE loSsh2
RELEASE loImap