POP3 Read S/MIME Encrypted Email

Read S/MIME encrypted email.

Downloads:

MS Windows Visual C/C++ Libraries

Linux/CentOS C/C++ Libraries

MAC OS X C/C++ Libraries

Solaris C/C++ Libraries

C++ Builder Libraries

FreeBSD C++ Libraries

HP-UX C++ Libraries

BlackBerry QNX C++ Libraries

#include <C_CkMailMan.h>
#include <C_CkEmailBundle.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkMailMan mailman;
    BOOL success;
    HCkEmailBundle bundle;
    long i;
    HCkEmail email;

    //  The mailman object is used for receiving (POP3)
    //  and sending (SMTP) email.
    mailman = CkMailMan_Create();

    //  Any string argument automatically begins the 30-day trial.

    success = CkMailMan_UnlockComponent(mailman,"30-day trial");
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        return;
    }

    //  Set the POP3 server's hostname
    CkMailMan_putMailHost(mailman,"mail.chilkatsoft.com");

    //  Set the POP3 login/password.
    CkMailMan_putPopUsername(mailman,"myLogin");
    CkMailMan_putPopPassword(mailman,"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 = CkMailMan_AddPfxSourceFile(mailman,"/pfxFiles/certs_and_keys_1.pfx","pfxPassword1");
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        return;
    }

    success = CkMailMan_AddPfxSourceFile(mailman,"/pfxFiles/certs_and_keys_2.pfx","pfxPassword2");
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        return;
    }

    //  ...
    //  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 = CkMailMan_CopyMail(mailman);
    if (bundle == 0 ) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        return;
    }

    //  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,

    for (i = 0; i <= CkEmailBundle_getMessageCount(bundle) - 1; i++) {

        email = CkEmailBundle_GetEmail(bundle,i);

        printf("%s\n",CkEmail_ck_from(email));
        printf("%s\n",CkEmail_subject(email));

        //  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 (CkEmail_getReceivedEncrypted(email) == TRUE) {

            printf("This email was encrypted when received.\n");
            if (CkEmail_getDecrypted(email) == TRUE) {
                printf("This email was successfully decrypted.  It was encrypted by:\n");
                printf("%s\n",CkEmail_encryptedBy(email));
            }
            else {
                printf("This email was not decrypted.\n");
            }

        }

        if (CkEmail_getReceivedSigned(email) == TRUE) {

            printf("This email was signed when received.\n");
            if (CkEmail_getSignaturesValid(email) == TRUE) {
                printf("The signature was verified.  It was signed by:\n");
                printf("%s\n",CkEmail_signedBy(email));
            }
            else {
                printf("The signature verification failed.\n");
            }

        }

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

        printf("--\n");
        CkEmail_Dispose(email);
    }

    CkEmailBundle_Dispose(bundle);

    CkMailMan_Dispose(mailman);

    }