C++

Set the Signing Certificate for an Email

Demonstrates the Chilkat Email.SetSigningCert method, which sets the certificate (with access to its private key) used to create a digital signature when sending signed email. This example loads the signing certificate from a PFX, sets it, and enables signed sending.

Background: Signing uses your own private key (the opposite of encrypting, which uses the recipient's public key), so the signing certificate must include private-key access. A PFX (PKCS#12) file bundles the certificate and its private key together, which is why it is loaded here with LoadPfxFile. If the certificate and key are in separate files, use SetSigningCert2 instead.

Chilkat C++ Downloads

Download Chilkat for C++

C++

#include <CkEmail.h>
#include <CkCert.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Demonstrates the SetSigningCert method, which sets the certificate (with access to its
    //  private key) used for creating a digital signature when sending signed email.

    CkEmail email;
    email.put_Subject("Signed email");
    email.put_Body("This message will be sent with a digital signature.");
    email.put_From("alice@example.com");
    email.AddTo("Bob","bob@example.com");

    //  Load a signing certificate together with its private key from a PFX file.
    CkCert cert;
    success = cert.LoadPfxFile("qa_data/certs/signer.pfx","pfx_password");
    if (success == false) {
        std::cout << cert.lastErrorText() << "\r\n";
        return true;
    }

    //  Set the certificate used to create the signature.
    success = email.SetSigningCert(cert);
    if (success == false) {
        std::cout << email.lastErrorText() << "\r\n";
        return true;
    }

    //  Request that the email be sent with a digital signature.
    email.put_SendSigned(true);

    std::cout << "Signing certificate set." << "\r\n";

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