(Lianja) Using Client Certificate w/ IMAP SSL

Demonstrates how to use a client-side certificate with an IMAP SSL connection. The SetSslClientCert method is called to specify a certificate to be used for the SSL connection.

Chilkat Lianja Extension Download Chilkat Lianja Extension

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

loImap = createobject("CkImap")

// To use a secure SSL connection, set SSL and the port:
loImap.Ssl = .T.
// The typical port for IMAP SSL is 993
loImap.Port = 993

// Load a certificate from a PFX file and use it.
// Note: Other methods are available to load pre-installed
// certificates from registry-based certificate stores.

// Create an instance of a certificate store object, load a PFX file,
// locate the certificate we need, and use it for signing.
// (a PFX file may contain more than one certificate.)
loCertStore = createobject("CkCertStore")
// The 1st argument is the filename, the 2nd arg is the 
// PFX file's password:
llSuccess = loCertStore.LoadPfxFile("myCertWithPrivateKey.pfx","secret")
if (llSuccess <> .T.) then
    ? loCertStore.LastErrorText
    release loImap
    release loCertStore
    return
endif

// Find the certificate by the subject common name:

loCert = loCertStore.FindCertBySubjectCN("Chilkat Software, Inc.")
if (loCertStore.LastMethodSuccess = .F.) then
    ? loCertStore.LastErrorText
    release loImap
    release loCertStore
    return
endif

// If a PFX file is known to contain a single certificate,
// you may load it directly into a Chilkat certificate object.
// This snippet of source code shows how:
loCert2 = createobject("CkCert")
// The 1st argument is the filename, the 2nd arg is the 
// PFX file's password:
llSuccess = loCert2.LoadPfxFile("myClientCert.pfx","secret")
if (llSuccess <> .T.) then
    ? loCert.LastErrorText
    release loImap
    release loCertStore
    release loCert2
    return
endif

// Use the cert:
llSuccess = loImap.SetSslClientCert(loCert)

// Connect to an IMAP server.
llSuccess = loImap.Connect("imap.someMailServer.com")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loCert2
    return
endif

// Login
llSuccess = loImap.Login("myLogin","myPassword")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loCert2
    return
endif

// Select an IMAP mailbox
llSuccess = loImap.SelectMailbox("Inbox")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loCert2
    return
endif

// We can choose to fetch UIDs or sequence numbers.
llFetchUids = .T.
// Get the message IDs of all the emails in the mailbox
loMessageSet = loImap.Search("ALL",llFetchUids)
if (loImap.LastMethodSuccess = .F.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loCert2
    return
endif

// Fetch the emails into a bundle object:

loBundle = loImap.FetchBundle(loMessageSet)
if (loImap.LastMethodSuccess = .F.) then
    release loMessageSet
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loCert2
    return
endif

// Loop over the bundle and display the FROM and SUBJECT of each.
i = 0
lnNumEmails = loBundle.MessageCount
do while i < lnNumEmails
    loEmail = loBundle.GetEmail(i)
    ? loEmail.From
    ? loEmail.Subject
    ? "--"
    release loEmail
    i = i + 1
enddo

// Disconnect from the IMAP server.
llSuccess = loImap.Disconnect()

release loMessageSet
release loBundle


release loImap
release loCertStore
release loCert2