DataFlex

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.

DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Variant vSsh1
    Handle hoSsh1
    Variant vSsh2
    Handle hoSsh2
    Handle hoImap
    String sTemp1

    Move False To iSuccess

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

    Get Create (RefClass(cComChilkatSsh)) To hoSsh1
    If (Not(IsComObjectCreated(hoSsh1))) Begin
        Send CreateComObject of hoSsh1
    End

    // Connect directly to the 1st SSH server.
    Get ComConnect Of hoSsh1 "serverssh1.com" 22 To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoSsh1 To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Authenticate using login/password:
    Get ComAuthenticatePw Of hoSsh1 "ssh1Login" "ssh1Password" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoSsh1 To sTemp1
        Showln sTemp1
        Procedure_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.
    Get Create (RefClass(cComChilkatSsh)) To hoSsh2
    If (Not(IsComObjectCreated(hoSsh2))) Begin
        Send CreateComObject of hoSsh2
    End
    Get pvComObject of hoSsh1 to vSsh1
    Get ComConnectThroughSsh Of hoSsh2 vSsh1 "serverssh2.com" 22 To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoSsh2 To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Authenticate with ssh2...
    Get ComAuthenticatePw Of hoSsh2 "ssh2Login" "ssh2Password" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoSsh2 To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatImap)) To hoImap
    If (Not(IsComObjectCreated(hoImap))) Begin
        Send CreateComObject of hoImap
    End

    // 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
    Get pvComObject of hoSsh2 to vSsh2
    Get ComUseSsh Of hoImap vSsh2 To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Set ComSsl Of hoImap To True
    Set ComPort Of hoImap To 993

    // Connect to an IMAP server (through the multi-hop SSH tunnel)
    Get ComConnect Of hoImap "imap.someimapserver.com" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Login
    Get ComLogin Of hoImap "myLogin" "myPassword" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_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.
    Get ComCreateMailbox Of hoImap "newFolder" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Showln "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.
    Get ComDisconnect Of hoImap To iSuccess

    // 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.
    Send ComDisconnect To hoSsh2

    Send ComDisconnect To hoSsh1


End_Procedure