Xbase++

Specify a Certificate for Encrypted Email

Demonstrates the Chilkat Email.AddEncryptCert method, which explicitly specifies a certificate to use when sending encrypted email. Call it once per recipient certificate; ClearEncryptCerts clears the list. This example loads a recipient certificate, registers it, and enables encrypted sending.

Background: When encrypting to multiple people, each recipient needs to be able to decrypt with their own private key. S/MIME handles this by encrypting the message's one-time content key separately under each recipient's public certificate and including all of those wrapped keys in the message. AddEncryptCert is how you build that recipient list — one call per certificate — giving explicit control over exactly whose certificates are used rather than relying on automatic lookup.

Chilkat Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oEmail
LOCAL oCert

nSuccess := 0

//  Demonstrates the AddEncryptCert method, which explicitly specifies a certificate for
//  sending encrypted email.  Call it once per recipient certificate.  Use ClearEncryptCerts
//  to clear the list.

oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "Encrypted email"
oEmail:Body := "Encrypted to the specified recipient certificate(s)."
oEmail:From := "alice@example.com"
oEmail:AddTo("Bob", "bob@example.com")

//  Load a recipient certificate (public key) and add it to the encryption cert list.
oCert := CreateObject("Chilkat.Cert")
nSuccess := oCert:LoadFromFile("qa_data/certs/recipient.cer")
IF (nSuccess == 0)
    ? oCert:LastErrorText
    oEmail:destroy()
    oCert:destroy()
    RETURN
ENDIF

nSuccess := oEmail:AddEncryptCert(oCert)
IF (nSuccess == 0)
    ? oEmail:LastErrorText
    oEmail:destroy()
    oCert:destroy()
    RETURN
ENDIF

//  Request encrypted sending.
oEmail:SendEncrypted := 1

? "Added the recipient's encryption certificate."

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

oEmail:destroy()
oCert:destroy()