Java

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 Java Downloads

Download Chilkat for Java

Chilkat2 Java

import com.chilkatsoft.chilkat2.ChilkatException;
import com.chilkatsoft.chilkat2.Imap;
import com.chilkatsoft.chilkat2.XmlCertVault;

public class ChilkatExample {

    public static void main(String[] args) {
        // 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.

        Imap imap = new Imap();

        imap.setSsl(true);
        imap.setPort(993);

        try {
            imap.connect("imap.example.com");

            imap.login("user@example.com", "myPassword");
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            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.
        String pfxPassword = "";

        // Build a certificate vault and add a PFX to it.
        XmlCertVault vault = new XmlCertVault();
        try {
            vault.addPfxFile("qa_data/smime.pfx", pfxPassword);

            // Associate the vault with the Imap object.  Only one vault is associated at a time.
            imap.useCertVault(vault);

            imap.disconnect();
        } catch (ChilkatException e) {
            System.out.println(e.getLastErrorText());
            return;
        }
    }
}