Zig

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.

Zig

const std = @import("std");
const chilkat = @import("chilkat");

pub fn main(init: std.process.Init) !void {
    const alloc = init.arena.allocator();

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

    const ssh1 = try chilkat.Ssh.init();
    defer ssh1.deinit();

    // Connect directly to the 1st SSH server.
    ssh1.connect("serverssh1.com", 22) catch {
        std.debug.print("{s}\n", .{try ssh1.getLastErrorText(alloc)});
        return;
    };

    // Authenticate using login/password:
    ssh1.authenticatePw("ssh1Login", "ssh1Password") catch {
        std.debug.print("{s}\n", .{try ssh1.getLastErrorText(alloc)});
        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.
    const ssh2 = try chilkat.Ssh.init();
    defer ssh2.deinit();
    ssh2.connectThroughSsh(ssh1, "serverssh2.com", 22) catch {
        std.debug.print("{s}\n", .{try ssh2.getLastErrorText(alloc)});
        return;
    };

    // Authenticate with ssh2...
    ssh2.authenticatePw("ssh2Login", "ssh2Password") catch {
        std.debug.print("{s}\n", .{try ssh2.getLastErrorText(alloc)});
        return;
    };

    const imap = try chilkat.Imap.init();
    defer imap.deinit();

    // 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
    imap.useSsh(ssh2) catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    imap.setSsl(true);
    imap.setPort(993);

    // Connect to an IMAP server (through the multi-hop SSH tunnel)
    imap.connect("imap.someimapserver.com") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    // Login
    imap.login("myLogin", "myPassword") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        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.
    imap.createMailbox("newFolder") catch {
        std.debug.print("{s}\n", .{try imap.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Success.\n", .{});

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

    // 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();
}