React Native

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 React Native Downloads

Download Chilkat for React Native

React Native

import { Imap, XmlCertVault } from '@chilkat/react-native'

async function chilkatExample() {
  // 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.

  const imap = new Imap();

  imap.ssl = true;
  imap.port = 993;

  try {
    await imap.connectAsync('imap.example.com');
  } catch {
    console.log(imap.lastErrorText);
    return;
  }

  try {
    await imap.loginAsync('user@example.com', 'myPassword');
  } catch {
    console.log(imap.lastErrorText);
    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.
  const pfxPassword = '';

  // Build a certificate vault and add a PFX to it.
  const vault = new XmlCertVault();
  try {
    vault.addPfxFile('qa_data/smime.pfx', pfxPassword);
  } catch {
    console.log(vault.lastErrorText);
    return;
  }

  // Associate the vault with the Imap object.  Only one vault is associated at a time.
  try {
    imap.useCertVault(vault);
  } catch {
    console.log(imap.lastErrorText);
    return;
  }

  try {
    await imap.disconnectAsync();
  } catch {
    console.log(imap.lastErrorText);
    return;
  }
}