(Perl) POP3 Read S/MIME Encrypted Email

Read S/MIME encrypted email.

Chilkat Perl Downloads Perl Module for Windows, MacOS, Linux, Alpine Linux, Solaris

use chilkat();

# 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.someMailServer.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 != 1) {
    print $mailman->lastErrorText() . "\r\n";
    exit;
}

$success = $mailman->AddPfxSourceFile("/pfxFiles/certs_and_keys_2.pfx","pfxPassword2");
if ($success != 1) {
    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 is a EmailBundle
$bundle = $mailman->CopyMail();
if ($mailman->get_LastMethodSuccess() == 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, 
$i = 0;
while ($i < $bundle->get_MessageCount()) {

    # email is a Email
    $email = $bundle->GetEmail($i);

    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;
}