Rust Requires Chilkat v11.0.0+

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

Rust

// This example requires 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 mailman = chilkat::MailMan::new();

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

// Set the POP3 server's hostname
mailman.set_mail_host("pop.example.com");

// Set the POP3 login/password.
mailman.set_pop_username("myLogin");
mailman.set_pop_password("myPassword");

// Establish the POP3 connection through the ssh2 tunnel.
if mailman.pop3_begin_session().is_err() {
    println!("{}", mailman.last_error_text());
    return;
}

// Get the number of messages in the mailbox.
let num_messages = mailman.get_mailbox_count();

let email = chilkat::Email::new();
let mut i = 1;
while i <= num_messages {
    // Fetch by the message number (not by the UIDL)
    if mailman.fetch_one(false, 0, i, &email).is_err() {
        println!("{}", mailman.last_error_text());
        return;
    }

    println!("{}: {}\n", email.from(), email.subject());

    i = i + 1;
}

// 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.
let _ = mailman.pop3_end_session().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();