Zig

SSH Public Key Authentication

Demonstrates authenticating with an SSH server using public-key authentication. A private key is loaded into an SshKey object and passed to AuthenticatePk. The matching public key must already be installed on the server for the account.

Note: The private-key path is relative to the application's current working directory. Supply the path to your own key file.

Background: Public-key authentication is the standard for unattended and automated SSH: the private key never leaves the client, the server merely trusts the corresponding public key, and no reusable password crosses the wire. SshKey imports several formats — OpenSSH PEM keys via FromOpenSshPrivateKey and PuTTY .ppk files via FromPuttyPrivateKey — encrypted or not. For an encrypted key, set the Password property before importing. Note that LoadText is only a convenience for reading a text file into a string; it does not itself load the key.

Chilkat Zig Downloads

Download Chilkat for Zig

Zig

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

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

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

    // Demonstrates authenticating with an SSH server using public-key authentication.  The matching
    // public key must already be installed on the SSH server for the account.

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

    // Timeouts, in milliseconds.
    ssh.setConnectTimeoutMs(5000);
    ssh.setReadTimeoutMs(15000);

    const hostname = "ssh.example.com";
    const port = 22;
    ssh.connect(hostname, port) catch {
        std.debug.print("{s}\n", .{try ssh.getLastErrorText(alloc)});
        return;
    };

    // LoadText is a convenience method that reads any text file into a string.  It does not itself
    // load the key.
    const key = try chilkat.SshKey.init();
    defer key.deinit();
    const priv_key_text = key.loadText(alloc, "qa_data/my_private_key.pem") catch {
        std.debug.print("{s}\n", .{try key.getLastErrorText(alloc)});
        return;
    };

    // Import the private key.  Both OpenSSH and PuTTY formats are supported, encrypted or not.
    // This example loads an unencrypted OpenSSH-format key; for a PuTTY .ppk file, call
    // FromPuttyPrivateKey instead.  For an encrypted key, set key.Password before importing.
    key.fromOpenSshPrivateKey(priv_key_text) catch {
        std.debug.print("{s}\n", .{try key.getLastErrorText(alloc)});
        return;
    };

    ssh.authenticatePk("mySshLogin", key) catch {
        std.debug.print("{s}\n", .{try ssh.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Public-key authentication successful.\n", .{});

    ssh.disconnect();
}