(Visual FoxPro) POP3 over Multiple Hop SSH

Demonstrates how to read POP3 email (using TCP or TLS) tunneled through mulitple-hop SSH. The scheme looks like this:

Application => ServerSSH1 => ServerSSH2 => POP3Server

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

LOCAL loSsh1
LOCAL lnSuccess
LOCAL loSsh2
LOCAL loMailman
LOCAL lnNumMessages
LOCAL i
LOCAL loEmail

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Ssh')
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.
* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Ssh')
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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.MailMan')
loMailman = CreateObject('Chilkat.MailMan')

* Tell the mailman object to connect to the POP3 server though the ssh2 tunnel (which itself is routed through ssh1).
* The connection looks like this:  Application => ServerSSH1 => ServerSSH2 => POP3Server
lnSuccess = loMailman.UseSsh(loSsh2)
IF (lnSuccess <> 1) THEN
    ? loMailman.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    RELEASE loMailman
    CANCEL
ENDIF

* Set the POP3 server's hostname
loMailman.MailHost = "pop.someMailServer.com"

* Set the POP3 login/password.
loMailman.PopUsername = "myLogin"
loMailman.PopPassword = "myPassword"

* Establish the POP3 connection through the ssh2 tunnel.
lnSuccess = loMailman.Pop3BeginSession()
IF (lnSuccess <> 1) THEN
    ? loMailman.LastErrorText
    RELEASE loSsh1
    RELEASE loSsh2
    RELEASE loMailman
    CANCEL
ENDIF

* Get the number of messages in the mailbox.
lnNumMessages = loMailman.GetMailboxCount()

i = 1

DO WHILE i <= lnNumMessages

    loEmail = loMailman.FetchByMsgnum(i)
    IF (loMailman.LastMethodSuccess <> 1) THEN
        ? loMailman.LastErrorText
        RELEASE loSsh1
        RELEASE loSsh2
        RELEASE loMailman
        CANCEL
    ENDIF

    ? loEmail.From + ": " + loEmail.Subject + CHR(10)
    RELEASE loEmail

    i = i + 1
ENDDO

* Close the connection with the POP3 server.  (This closes the tunnel through ssh2)
* The connection with ssh2 is still alive, and may be used for more connections.
lnSuccess = loMailman.Pop3EndSession()

* 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 loMailman