Zig

Use a PEM TLS Client Certificate

Demonstrates the Chilkat MailMan.SetSslClientCertPem method, which sets the client-side certificate for SSL/TLS connections, loading it from PEM data or from a PEM file. The first argument may contain the PEM text itself or a path to a PEM file; the second is the PEM password. This example loads the client certificate from a PEM file.

Background: PEM is the familiar Base64 text format bracketed by -----BEGIN CERTIFICATE----- lines, and a single PEM can hold both a certificate and its (optionally encrypted) private key. It is the common format in Unix/OpenSSL environments, whereas PFX is more typical on Windows. Because this method accepts either the PEM text or a filename, you can supply credentials straight from a config value or secret store without writing them to disk.

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

    var success: bool = false;

    // Demonstrates the MailMan.SetSslClientCertPem method, which sets the client-side
    // certificate for SSL/TLS connections, loading it from PEM data or from a PEM file.  The
    // 1st argument may contain PEM text or a PEM file path; the 2nd is the PEM password.

    const mailman = try chilkat.MailMan.init();
    defer mailman.deinit();

    // Configure the SMTP server connection.
    mailman.setSmtpHost("smtp.example.com");
    mailman.setSmtpPort(465);
    mailman.setSmtpSsl(true);
    mailman.setSmtpUsername("user@example.com");
    mailman.setSmtpPassword("myPassword");

    // Load the client certificate from a PEM file.
    success = if (mailman.setSslClientCertPem("qa_data/certs/client.pem", "pem_password")) true else |_| false;
    if (!success) {
        std.debug.print("{s}\n", .{try mailman.getLastErrorText(alloc)});
        return;
    }

    success = mailman.verifySmtpLogin();
    if (!success) {
        std.debug.print("{s}\n", .{try mailman.getLastErrorText(alloc)});
        return;
    }

    std.debug.print("Connected using a PEM TLS client certificate.\n", .{});

    // Note: The path "qa_data/certs/client.pem" is a relative local filesystem path,
    // relative to the current working directory of the running application.
}