Ruby

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. Ruby

require 'chilkat'

success = false

email = Chilkat::CkEmail.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.)
success = email.AddPfxSourceFile("/pfxFiles/certs_and_keys_1.pfx","pfxPassword1")
if (success != true)
    print email.lastErrorText() + "\n";
    exit
end

success = email.AddPfxSourceFile("/pfxFiles/certs_and_keys_2.pfx","pfxPassword2")
if (success != true)
    print email.lastErrorText() + "\n";
    exit
end

# ...

# Load a potentially signed and/or encrypted email.
success = email.LoadEml("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.get_ReceivedEncrypted() == true)

    print "This email was encrypted." + "\n";
    if (email.get_Decrypted() == true)
        print "This email was successfully decrypted.  It was encrypted by:" + "\n";
        print email.encryptedBy() + "\n";
    else
        print "This email was not decrypted." + "\n";
    end

end

if (email.get_ReceivedSigned() == true)

    print "This email was signed." + "\n";
    if (email.get_SignaturesValid() == true)
        print "The signature was verified.  It was signed by:" + "\n";
        print email.signedBy() + "\n";
    else
        print "The signature verification failed." + "\n";
    end

end

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