PowerBuilder

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.

PowerBuilder

integer li_rc
integer li_Success
oleobject loo_Ssh1
oleobject loo_Ssh2
oleobject loo_Imap

li_Success = 0

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

loo_Ssh1 = create oleobject
li_rc = loo_Ssh1.ConnectToNewObject("Chilkat.Ssh")
if li_rc < 0 then
    destroy loo_Ssh1
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Connect directly to the 1st SSH server.
li_Success = loo_Ssh1.Connect("serverssh1.com",22)
if li_Success <> 1 then
    Write-Debug loo_Ssh1.LastErrorText
    destroy loo_Ssh1
    return
end if

// Authenticate using login/password:
li_Success = loo_Ssh1.AuthenticatePw("ssh1Login","ssh1Password")
if li_Success <> 1 then
    Write-Debug loo_Ssh1.LastErrorText
    destroy loo_Ssh1
    return
end if

// 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.
loo_Ssh2 = create oleobject
li_rc = loo_Ssh2.ConnectToNewObject("Chilkat.Ssh")

li_Success = loo_Ssh2.ConnectThroughSsh(loo_Ssh1,"serverssh2.com",22)
if li_Success <> 1 then
    Write-Debug loo_Ssh2.LastErrorText
    destroy loo_Ssh1
    destroy loo_Ssh2
    return
end if

// Authenticate with ssh2...
li_Success = loo_Ssh2.AuthenticatePw("ssh2Login","ssh2Password")
if li_Success <> 1 then
    Write-Debug loo_Ssh2.LastErrorText
    destroy loo_Ssh1
    destroy loo_Ssh2
    return
end if

loo_Imap = create oleobject
li_rc = loo_Imap.ConnectToNewObject("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
li_Success = loo_Imap.UseSsh(loo_Ssh2)
if li_Success <> 1 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Ssh1
    destroy loo_Ssh2
    destroy loo_Imap
    return
end if

loo_Imap.Ssl = 1
loo_Imap.Port = 993

// Connect to an IMAP server (through the multi-hop SSH tunnel)
li_Success = loo_Imap.Connect("imap.someimapserver.com")
if li_Success <> 1 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Ssh1
    destroy loo_Ssh2
    destroy loo_Imap
    return
end if

// Login
li_Success = loo_Imap.Login("myLogin","myPassword")
if li_Success <> 1 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Ssh1
    destroy loo_Ssh2
    destroy loo_Imap
    return
end if

// 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.
li_Success = loo_Imap.CreateMailbox("newFolder")
if li_Success <> 1 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Ssh1
    destroy loo_Ssh2
    destroy loo_Imap
    return
end if

Write-Debug "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.
li_Success = loo_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.
loo_Ssh2.Disconnect()

loo_Ssh1.Disconnect()


destroy loo_Ssh1
destroy loo_Ssh2
destroy loo_Imap