C

POP3 Login Secure

Demonstrates how to set the POP3 password using a secure string.

This example requires Chilkat v9.5.0.71 or greater.

C

#include <C_CkMailMan.h>
#include <C_CkJsonObject.h>
#include <C_CkCrypt2.h>
#include <C_CkSecureString.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailMan mailman;
    HCkJsonObject json;
    HCkCrypt2 crypt;
    HCkSecureString ssLogin;
    HCkSecureString ssPassword;
    int numMessages;

    success = FALSE;

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

    mailman = CkMailMan_Create();

    // Imagine we've previously saved our encrypted login and password within a JSON config file
    // that contains this:

    // {
    //   "pop3_login": "D7lnlWY291LKMeChlvQq7N/Tg7ieuSB15a+9Ekyd0R4=",
    //   "pop3_password": "5neIq9Jmn0E3p71N6Yc8TA=="
    // }

    json = CkJsonObject_Create();
    CkJsonObject_LoadFile(json,"qa_data/passwords/pop3.json");

    crypt = CkCrypt2_Create();

    // These are the encryption settings we previously used to encrypt the credentials within the JSON config file.
    CkCrypt2_putCryptAlgorithm(crypt,"aes");
    CkCrypt2_putCipherMode(crypt,"cbc");
    CkCrypt2_putKeyLength(crypt,128);
    CkCrypt2_SetEncodedKey(crypt,"000102030405060708090A0B0C0D0E0F","hex");
    CkCrypt2_SetEncodedIV(crypt,"000102030405060708090A0B0C0D0E0F","hex");
    CkCrypt2_putEncodingMode(crypt,"base64");

    ssLogin = CkSecureString_Create();
    ssPassword = CkSecureString_Create();

    // Decrypt to the secure string.  (the strings will still held in memory encrypted, but are now encrypted using
    // a randomly generated session key.)
    CkCrypt2_DecryptSecureENC(crypt,CkJsonObject_stringOf(json,"pop3_login"),ssLogin);
    CkCrypt2_DecryptSecureENC(crypt,CkJsonObject_stringOf(json,"pop3_password"),ssPassword);

    // Set the POP3 domain, login, and password
    CkMailMan_putMailHost(mailman,"pop.gmail.com");
    CkMailMan_putPopSsl(mailman,TRUE);
    CkMailMan_putMailPort(mailman,995);

    CkMailMan_putPopUsername(mailman,CkSecureString_access(ssLogin));
    // Set the PopPassword property via the SetPassword method using the secure string.
    CkMailMan_SetPassword(mailman,"pop3",ssPassword);

    // Connect and authenticate..
    success = CkMailMan_Pop3Connect(mailman);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkJsonObject_Dispose(json);
        CkCrypt2_Dispose(crypt);
        CkSecureString_Dispose(ssLogin);
        CkSecureString_Dispose(ssPassword);
        return;
    }

    success = CkMailMan_Pop3Authenticate(mailman);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkJsonObject_Dispose(json);
        CkCrypt2_Dispose(crypt);
        CkSecureString_Dispose(ssLogin);
        CkSecureString_Dispose(ssPassword);
        return;
    }

    printf("POP3 login successful.\n");

    numMessages = CkMailMan_GetMailboxCount(mailman);
    if (numMessages < 0) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkJsonObject_Dispose(json);
        CkCrypt2_Dispose(crypt);
        CkSecureString_Dispose(ssLogin);
        CkSecureString_Dispose(ssPassword);
        return;
    }

    printf("Num messages in Inbox = %d\n",numMessages);

    CkMailMan_Pop3EndSession(mailman);


    CkMailMan_Dispose(mailman);
    CkJsonObject_Dispose(json);
    CkCrypt2_Dispose(crypt);
    CkSecureString_Dispose(ssLogin);
    CkSecureString_Dispose(ssPassword);

    }