Tcl

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 Tcl Downloads

Download Chilkat for Tcl

Tcl


load ./chilkat.dll

set success 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.

set mailman [new_CkMailMan]

#  Configure the POP3 server connection.  These connections will travel through the tunnel.
CkMailMan_put_MailHost $mailman "pop.example.com"
CkMailMan_put_MailPort $mailman 995
CkMailMan_put_PopSsl $mailman 1
CkMailMan_put_PopUsername $mailman "user@example.com"
CkMailMan_put_PopPassword $mailman "myPassword"

#  Open the SSH tunnel (port 22 is the standard SSH port).
set success [CkMailMan_SshOpenTunnel $mailman "ssh.example.com" 22]
if {$success == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    exit
}

#  Authenticate with the SSH server.
set success [CkMailMan_SshAuthenticatePw $mailman "sshUser" "sshPassword"]
if {$success == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    exit
}

#  POP3 operations now travel through the SSH tunnel.
set count [CkMailMan_GetMailboxCount $mailman]
if {$count < 0} then {
    puts "Failed to get the mailbox count."
} else {
    puts "Mailbox count: $count"
}

#  Close the tunnel when finished.
set success [CkMailMan_SshCloseTunnel $mailman]
if {$success == 0} then {
    puts [CkMailMan_lastErrorText $mailman]
    delete_CkMailMan $mailman
    exit
}


delete_CkMailMan $mailman