Lua

Load Signed and/or Encrypted Email and Unwrap Security Layers

See more Email Object Examples

The LoadEml method loads an email (.eml file containing the MIME of an email) and automatically unwraps the digital signature and encryption security layers. A program can then examine the properties of the email object to see what was unwrapped. Lua

local chilkat = require("chilkat")

local email = chilkat.Email.new()

-- Provide PFX/.p12 files for any certs+keys needed for decryption.
-- Signature verification does not need anything extra.
-- (Also, Chilkat will automatically find and use pre-installed certs + private keys needed for decryption
-- on a Windows system.)
local success = email:add_pfx_source_file("/pfxFiles/certs_and_keys_1.pfx", "pfxPassword1")
if not success then
    print(email.last_error_text)
    return
end

success = email:add_pfx_source_file("/pfxFiles/certs_and_keys_2.pfx", "pfxPassword2")
if not success then
    print(email.last_error_text)
    return
end

-- ...

-- Load a potentially signed and/or encrypted email.
success = email:load_eml("someDir/someEmail.eml")

-- If the email was signed and/or encrypted, it was "unwrapped", i.e.
-- the email is already decrypted and in a state as if it were never signed or encrypted.

-- You may check to see if the email was received encrypted or signed, and if so,
-- whether it was successfully unwrapped and who signed or encrypted it:
if email.received_encrypted then
    print("This email was encrypted.")
    if email.decrypted then
        print("This email was successfully decrypted.  It was encrypted by:")
        print(email.encrypted_by)
    else
        print("This email was not decrypted.")
    end
end

if email.received_signed then
    print("This email was signed.")
    if email.signatures_valid then
        print("The signature was verified.  It was signed by:")
        print(email.signed_by)
    else
        print("The signature verification failed.")
    end
end

-- At this point, the contents of the email, including attachments, can be accessed normally..