Zig

Add a PFX Source to MailMan from BinData

Demonstrates the Chilkat MailMan.AddPfxSourceBd method, which adds a PFX/PKCS#12 certificate store to the MailMan object's internal list of sources used for locating certificates and private keys. The first argument is a BinData containing the PFX bytes and the second is the PFX password. This example loads a PFX into a BinData, registers it, and fetches a message Chilkat can decrypt.

Background: This is the in-memory (BinData) counterpart to AddPfxSourceFile. It is the right choice when the PFX bytes come from somewhere other than a file — a database, a secrets manager, or an HTTPS download — letting you supply the certificate and private key without first writing sensitive key material 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();

    // Demonstrates the MailMan.AddPfxSourceBd method, which adds a PFX/PKCS#12 certificate store
    // to the MailMan object's internal list of sources used for locating certificates and
    // private keys.  The 1st argument is a BinData containing the PFX bytes and the 2nd is the
    // PFX password.

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

    // Configure the POP3 server connection.
    mailman.setMailHost("pop.example.com");
    mailman.setMailPort(995);
    mailman.setPopSsl(true);
    mailman.setPopUsername("user@example.com");
    mailman.setPopPassword("myPassword");

    // Load the PFX bytes into a BinData (they could come from a file, database, or secrets store).
    const bd_pfx = try chilkat.BinData.init();
    defer bd_pfx.deinit();
    bd_pfx.loadFile("qa_data/certs/decryption.pfx") catch {
        std.debug.print("{s}\n", .{try bd_pfx.getLastErrorText(alloc)});
        return;
    };

    // Add the PFX as a source of certificates and private keys.
    mailman.addPfxSourceBd(bd_pfx, "pfx_password") catch {
        std.debug.print("{s}\n", .{try mailman.getLastErrorText(alloc)});
        return;
    };

    // Fetch a message; if it is encrypted, Chilkat can decrypt it using the PFX source.
    const email = try chilkat.Email.init();
    defer email.deinit();
    mailman.fetchOne(false, 0, 1, email) catch {
        std.debug.print("{s}\n", .{try mailman.getLastErrorText(alloc)});
        return;
    };

    std.debug.print("Decrypted = {}\n", .{email.getDecrypted()});

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

    // Note: Explicitly connecting/authenticating is optional.  Chilkat MailMan automatically
    // connects and authenticates -- using the property settings above -- whenever a server
    // operation requires it.  Calling the explicit connect/authenticate methods can still be
    // helpful to determine whether a failure occurs while connecting or while authenticating.
}