Rust

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.

Rust

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

let ssh1 = chilkat::Ssh::new();

// Connect directly to the 1st SSH server.
if ssh1.connect("serverssh1.com", 22).is_err() {
    println!("{}", ssh1.last_error_text());
    return;
}

// Authenticate using login/password:
if ssh1.authenticate_pw("ssh1Login", "ssh1Password").is_err() {
    println!("{}", ssh1.last_error_text());
    return;
}

// 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.
let ssh2 = chilkat::Ssh::new();
if ssh2.connect_through_ssh(&ssh1, "serverssh2.com", 22).is_err() {
    println!("{}", ssh2.last_error_text());
    return;
}

// Authenticate with ssh2...
if ssh2.authenticate_pw("ssh2Login", "ssh2Password").is_err() {
    println!("{}", ssh2.last_error_text());
    return;
}

let imap = chilkat::Imap::new();

// 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
if imap.use_ssh(&ssh2).is_err() {
    println!("{}", imap.last_error_text());
    return;
}

imap.set_ssl(true);
imap.set_port(993);

// Connect to an IMAP server (through the multi-hop SSH tunnel)
if imap.connect("imap.someimapserver.com").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

// Login
if imap.login("myLogin", "myPassword").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

// 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.
if imap.create_mailbox("newFolder").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

println!("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.
let _ = imap.disconnect().is_ok();

// 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.
ssh2.disconnect();

ssh1.disconnect();