Xbase++

Open an SSH Tunnel for POP3

Demonstrates the Chilkat MailMan.SshOpenTunnel method, which connects to an SSH server and opens an SSH tunnel for MailMan's SMTP or POP3 connections. The first argument is the SSH server's hostname or IP address and the second is the SSH port. This example opens a tunnel, authenticates, performs a POP3 operation through it, and closes the tunnel.

Background: An SSH tunnel (port forwarding) wraps another protocol's traffic inside an encrypted SSH connection. Here, MailMan's POP3 or SMTP session is carried through the SSH server rather than connecting directly. This is useful when a mail server is only reachable from inside a network you can reach via SSH, or when policy requires all traffic to traverse a bastion host. Opening the tunnel is step one; you must then authenticate to the SSH server before the tunnel carries traffic.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oMailman
LOCAL nCount

nSuccess := 0

//  Demonstrates the MailMan.SshOpenTunnel method, which connects to an SSH server and opens
//  an SSH tunnel for MailMan's SMTP or POP3 connections.  The 1st argument is the SSH server
//  hostname or IP address, and the 2nd is the SSH port.

oMailman := CreateObject("Chilkat.MailMan")

//  Configure the POP3 server connection.  These connections will travel through the tunnel.
oMailman:MailHost := "pop.example.com"
oMailman:MailPort := 995
oMailman:PopSsl := 1
oMailman:PopUsername := "user@example.com"
oMailman:PopPassword := "myPassword"

//  Open the SSH tunnel (port 22 is the standard SSH port).
nSuccess := oMailman:SshOpenTunnel("ssh.example.com", 22)
IF (nSuccess == 0)
    ? oMailman:LastErrorText
    oMailman:destroy()
    RETURN
ENDIF

//  Authenticate with the SSH server.
nSuccess := oMailman:SshAuthenticatePw("sshUser", "sshPassword")
IF (nSuccess == 0)
    ? oMailman:LastErrorText
    oMailman:destroy()
    RETURN
ENDIF

//  POP3 operations now travel through the SSH tunnel.
nCount := oMailman:GetMailboxCount()
IF (nCount < 0)
    ? "Failed to get the mailbox count."
ELSE
    ? "Mailbox count: " + Str(nCount)
ENDIF

//  Close the tunnel when finished.
nSuccess := oMailman:SshCloseTunnel()
IF (nSuccess == 0)
    ? oMailman:LastErrorText
    oMailman:destroy()
    RETURN
ENDIF

oMailman:destroy()