(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.

Note: This example requires Chilkat v11.0.0 or greater.

Chilkat Lianja Extension Download Chilkat Lianja Extension

llSuccess = .F.

// 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 = .F.) then
    ? loCertStore.LastErrorText
    release loImap
    release loCertStore
    return
endif

// Find the certificate by the subject common name:
loJsonCN = createobject("CkJsonObject")
loJsonCN.UpdateString("CN","cert common name")

loCert = createobject("CkCert")
llSuccess = loCertStore.FindCert(loJsonCN,loCert)
if (llSuccess = .F.) then
    ? loCertStore.LastErrorText
    release loImap
    release loCertStore
    release loJsonCN
    release loCert
    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 = .F.) then
    ? loCert.LastErrorText
    release loImap
    release loCertStore
    release loJsonCN
    release loCert
    release loCert2
    return
endif

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

// Connect to an IMAP server.
llSuccess = loImap.Connect("imap.example.com")
if (llSuccess = .F.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loJsonCN
    release loCert
    release loCert2
    return
endif

// Login
llSuccess = loImap.Login("myLogin","myPassword")
if (llSuccess = .F.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loJsonCN
    release loCert
    release loCert2
    return
endif

// Select an IMAP mailbox
llSuccess = loImap.SelectMailbox("Inbox")
if (llSuccess = .F.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loJsonCN
    release loCert
    release loCert2
    return
endif

// Get the message IDs of all the emails in the mailbox
llFetchUids = .T.
loMessageSet = createobject("CkMessageSet")
llSuccess = loImap.QueryMbx("ALL",llFetchUids,loMessageSet)
if (llSuccess = .F.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loJsonCN
    release loCert
    release loCert2
    release loMessageSet
    return
endif

// Fetch the emails into a bundle object:
loBundle = createobject("CkEmailBundle")
llHeadersOnly = .F.
llSuccess = loImap.FetchMsgSet(llHeadersOnly,loMessageSet,loBundle)
if (llSuccess = .F.) then
    ? loImap.LastErrorText
    release loImap
    release loCertStore
    release loJsonCN
    release loCert
    release loCert2
    release loMessageSet
    release loBundle
    return
endif

// Loop over the bundle and display the FROM and SUBJECT of each.
loEmail = createobject("CkEmail")
i = 0
lnNumEmails = loBundle.MessageCount
do while i < lnNumEmails
    loBundle.EmailAt(i,loEmail)

    ? loEmail.From
    ? loEmail.Subject
    ? "--"
    i = i + 1
enddo

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


release loImap
release loCertStore
release loJsonCN
release loCert
release loCert2
release loMessageSet
release loBundle
release loEmail