CkPython

IMAP STARTTLS (Explicit TLS/SSL)

The StartTls property is set to force the Connect method to automatically convert an connection to TLS/SSL via the STARTTLS IMAP command.

This is also known as "explicit TLS/SSL" as opposed to "implicit TLS/SSL". With implicit TLS/SSL, the IMAP client connects on the well-known IMAP TLS/SSL port 993 and the secure channel is immediately established. With explicit TLS/SSL, the IMAP client connects on the typical non-secure port (143 usually) and the converts the connection via the STARTTLS command.

CkPython

import sys
import chilkat

success = False

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

imap = chilkat.CkImap()

# Indicate that STARTTLS should be used to convert
# to a secure TLS/SSL connection:
imap.put_StartTls(True)
imap.put_Port(143)

# Connect to an IMAP server and convert the connection
# to TLS/SSL via STARTTLS.
success = imap.Connect("imap.example.com")
if (success == False):
    print(imap.lastErrorText())
    sys.exit()

# The remainder of this example is the same as for 
# non-TLS/SSL...

# Login
success = imap.Login("myLogin","myPassword")
if (success == False):
    print(imap.lastErrorText())
    sys.exit()

# Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
if (success == False):
    print(imap.lastErrorText())
    sys.exit()

# Get the message IDs of all the emails in the mailbox
fetchUids = True
messageSet = chilkat.CkMessageSet()
success = imap.QueryMbx("ALL",fetchUids,messageSet)
if (success == False):
    print(imap.lastErrorText())
    sys.exit()

# Fetch the emails into a bundle object:
bundle = chilkat.CkEmailBundle()
headersOnly = False
success = imap.FetchMsgSet(headersOnly,messageSet,bundle)
if (success == False):
    print(imap.lastErrorText())
    sys.exit()

# Loop over the bundle and display the FROM and SUBJECT of each.
email = chilkat.CkEmail()
i = 0
numEmails = bundle.get_MessageCount()
while i < numEmails :
    bundle.EmailAt(i,email)

    print(email.ck_from())
    print(email.subject())
    print("--")
    i = i + 1

# Disconnect from the IMAP server.
success = imap.Disconnect()