Rust

Use an XML Certificate Vault with IMAP

Demonstrates the Chilkat Imap.UseCertVault method, which associates an XmlCertVault with the Imap object as a source of certificates and private keys for S/MIME operations. The only argument is the vault. Only one vault is associated at a time.

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

Background: An XmlCertVault is a portable container that can hold multiple certificates and keys in a single (optionally password-protected) XML file. It is a convenient way to ship the exact set of credentials an application needs without depending on the operating system's certificate stores. Associating a vault makes all of its contents available for S/MIME decryption and signature verification.

Chilkat Rust Downloads

Download Chilkat for Rust

Rust


// Demonstrates the Imap.UseCertVault method, which associates an XmlCertVault with the Imap
// object as a source of certificates and private keys for S/MIME operations.  The only
// argument is the XmlCertVault.

let imap = chilkat::Imap::new();

imap.set_ssl(true);
imap.set_port(993);

if imap.connect("imap.example.com").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

if imap.login("user@example.com", "myPassword").is_err() {
    println!("{}", imap.last_error_text());
    return;
}

// The PFX password is not hard-coded in source.  Insert code here to obtain it from an
// interactive prompt, environment variable, or a secrets vault.
let pfx_password = String::new();

// Build a certificate vault and add a PFX to it.
let vault = chilkat::XmlCertVault::new();
if vault.add_pfx_file("qa_data/smime.pfx", &pfx_password).is_err() {
    println!("{}", vault.last_error_text());
    return;
}

// Associate the vault with the Imap object.  Only one vault is associated at a time.
if imap.use_cert_vault(&vault).is_err() {
    println!("{}", imap.last_error_text());
    return;
}

if imap.disconnect().is_err() {
    println!("{}", imap.last_error_text());
    return;
}