Ruby

Use an Existing Socket SSH Tunnel

Demonstrates the Chilkat MailMan.UseSshTunnel method, which configures MailMan to use an existing SSH tunnel provided by a Socket object for its SMTP and POP3 connections. This example opens and authenticates a tunnel on a Socket, hands it to MailMan, and then verifies an SMTP login through it.

Background: Sharing one already-established SSH tunnel across objects avoids opening (and authenticating) a separate SSH connection for every component that needs to reach the remote network. Here the tunnel lives on a Socket object, which MailMan then routes its SMTP/POP3 traffic through. It is the Socket-based sibling of UseSsh, which shares an Ssh object instead.

Chilkat Ruby Downloads

Download Chilkat for Ruby

Ruby

require 'chilkat'

success = false

#  Demonstrates the MailMan.UseSshTunnel method, which configures MailMan to use an existing
#  SSH tunnel provided by a Socket object for its SMTP and POP3 connections.

#  Open and authenticate the SSH tunnel using a Socket object.
sshTunnel = Chilkat::CkSocket.new()
success = sshTunnel.SshOpenTunnel("ssh.example.com",22)
if (success == false)
    print sshTunnel.lastErrorText() + "\n";
    exit
end

success = sshTunnel.SshAuthenticatePw("sshUser","sshPassword")
if (success == false)
    print sshTunnel.lastErrorText() + "\n";
    exit
end

mailman = Chilkat::CkMailMan.new()

#  Configure the SMTP server connection.  These connections will travel through the tunnel.
mailman.put_SmtpHost("smtp.example.com")
mailman.put_SmtpPort(465)
mailman.put_SmtpSsl(true)
mailman.put_SmtpUsername("user@example.com")
mailman.put_SmtpPassword("myPassword")

#  Tell MailMan to route its connections through the existing tunnel.
success = mailman.UseSshTunnel(sshTunnel)
if (success == false)
    print mailman.lastErrorText() + "\n";
    exit
end

#  SMTP operations now travel through the shared SSH tunnel.
success = mailman.VerifySmtpLogin()
if (success == false)
    print mailman.lastErrorText() + "\n";
    exit
end

print "Authenticated with the SMTP server through the SSH tunnel." + "\n";