Perl Requires Chilkat v11.0.0+

POP3 Read S/MIME Encrypted Email

Read S/MIME encrypted email. Perl

use chilkat();

$success = 0;

#  This example assumes the Chilkat API to have been previously unlocked.
#  See Global Unlock Sample for sample code.

#  The mailman object is used for receiving (POP3) 
#  and sending (SMTP) email.
$mailman = chilkat::CkMailMan->new();

#  Set the POP3 server's hostname
$mailman->put_MailHost("pop.example.com");

#  Set the POP3 login/password.
$mailman->put_PopUsername("myLogin");
$mailman->put_PopPassword("myPassword");

#  If running on Microsoft Windows, the Chilkat mailman
#  will automatically search the registry-based certificate stores
#  for matching certificates and private keys required for
#  decryption.  However, on Linux, MAX OS X, and other
#  operating systems, no such thing exists.  Therefore, you'll 
#  need to specify one or more PFX (.p12 / .pfx) files as
#  sources for locating the certs required for decyrption.
$success = $mailman->AddPfxSourceFile("/pfxFiles/certs_and_keys_1.pfx","pfxPassword1");
if ($success == 0) {
    print $mailman->lastErrorText() . "\r\n";
    exit;
}

$success = $mailman->AddPfxSourceFile("/pfxFiles/certs_and_keys_2.pfx","pfxPassword2");
if ($success == 0) {
    print $mailman->lastErrorText() . "\r\n";
    exit;
}

#  ...
#  Note: On MS Windows, it is not required to provide PFX sources
#  if the needed certs and private keys are already installed
#  on the system (in the registry-based certificate stores).

#  Copy the all email from the user's POP3 mailbox 
#  into a bundle object.  The email remains on the server.
$bundle = chilkat::CkEmailBundle->new();
$keepOnServer = 1;
$headersOnly = 0;
#  Irrelevent because we are NOT downloading headers-only
$numBodyLines = 0;
$success = $mailman->FetchAll($keepOnServer,$headersOnly,$numBodyLines,$bundle);
if ($success == 0) {
    print $mailman->lastErrorText() . "\r\n";
    exit;
}

#  S/MIME security envelopes are automatically "unwrapped" 
#  when a message is retrieved from the server. Signed emails are automatically verified, and 
#  encrypted emails are automatically decrypted, restoring the email to the original state before 
#  signing and/or encrypting. Information about the signing and encrypting certificates can be 
#  retrieved from the Email object (methods: GetSignedByCert, GetEncryptedByCert; 
#  properties: SignedBy, EncryptedBy, SignaturesValid, Decrypted, ReceivedSigned, 
#  ReceivedEncrypted).

#  Loop over the bundle
$email = chilkat::CkEmail->new();
$i = 0;
while ($i < $bundle->get_MessageCount()) {

    $bundle->EmailAt($i,$email);

    print $email->ck_from() . "\r\n";
    print $email->subject() . "\r\n";

    #  At this point, if the email was signed and/or encrypted, it is already "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() == 1) {

        print "This email was encrypted when received." . "\r\n";
        if ($email->get_Decrypted() == 1) {
            print "This email was successfully decrypted.  It was encrypted by:" . "\r\n";
            print $email->encryptedBy() . "\r\n";
        }
        else {
            print "This email was not decrypted." . "\r\n";
        }

    }

    if ($email->get_ReceivedSigned() == 1) {

        print "This email was signed when received." . "\r\n";
        if ($email->get_SignaturesValid() == 1) {
            print "The signature was verified.  It was signed by:" . "\r\n";
            print $email->signedBy() . "\r\n";
        }
        else {
            print "The signature verification failed." . "\r\n";
        }

    }

    #  The email's body, HTML body, attachments, etc.
    #  are decrypted and available just like any non-encrypted email.

    print "--" . "\r\n";

    $i = $i + 1;
}