SSH Tunnel Authenticate with a SecureString Password and Private Key

See more SSH Tunnel Examples

Demonstrates the Chilkat SshTunnel.AuthenticateSecPwPk method, which authenticates using SecureString login and password objects together with a private key. The third argument is the SshKey private key.

Note: The private-key path is relative to the application's current working directory. Absolute paths may also be used. Supply the path to your own key file.

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

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

    // Demonstrates the SshTunnel.AuthenticateSecPwPk method, which authenticates using SecureString
    // login and password objects together with a private key.  The 1st argument is the username, the
    // 2nd is the password, and the 3rd is an SshKey private key.

    const tunnel = try chilkat.SshTunnel.init();
    defer tunnel.deinit();

    // The tunnel forwards accepted local connections to this destination through the SSH server.
    tunnel.setDestHostname("db.internal.example.com");
    tunnel.setDestPort(5432);

    // Connect to the SSH server.  This performs the TCP/proxy connection and SSH handshake, but
    // does not authenticate yet.
    const ssh_port = 22;
    tunnel.connect("ssh.example.com", ssh_port) catch {
        std.debug.print("{s}\n", .{try tunnel.getLastErrorText(alloc)});
        return;
    };

    // Normally you would not hard-code the password in source.  You should instead obtain it
    // from an interactive prompt, environment variable, or a secrets vault.
    const password = "mySshPassword";

    // Load the SSH private key.  LoadText reads the file's text, which is then imported.
    const priv_key = try chilkat.SshKey.init();
    defer priv_key.deinit();
    const key_text = priv_key.loadText(alloc, "qa_data/id_rsa") catch {
        std.debug.print("{s}\n", .{try priv_key.getLastErrorText(alloc)});
        return;
    };

    priv_key.fromOpenSshPrivateKey(key_text) catch {
        std.debug.print("{s}\n", .{try priv_key.getLastErrorText(alloc)});
        return;
    };

    // Place the login and password into SecureString objects.
    const secure_login = try chilkat.SecureString.init();
    defer secure_login.deinit();
    secure_login.append("mySshLogin") catch {};
    const secure_password = try chilkat.SecureString.init();
    defer secure_password.deinit();
    secure_password.append(password) catch {};

    tunnel.authenticateSecPwPk(secure_login, secure_password, priv_key) catch {
        std.debug.print("{s}\n", .{try tunnel.getLastErrorText(alloc)});
        return;
    };

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

    // After authenticating, call BeginAccepting to start listening for local connections to forward.

    const wait_for_thread_exit = true;
    tunnel.closeTunnel(wait_for_thread_exit) catch {
        std.debug.print("{s}\n", .{try tunnel.getLastErrorText(alloc)});
        return;
    };
}