PowerBuilder

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

integer li_rc
integer li_Success
oleobject loo_Imap
oleobject loo_CertStore
oleobject loo_JsonCN
oleobject loo_Cert
oleobject loo_Cert2
integer li_FetchUids
oleobject loo_MessageSet
oleobject loo_Bundle
integer li_HeadersOnly
oleobject loo_Email
integer i
integer li_NumEmails

li_Success = 0

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

loo_Imap = create oleobject
li_rc = loo_Imap.ConnectToNewObject("Chilkat.Imap")
if li_rc < 0 then
    destroy loo_Imap
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// To use a secure SSL connection, set SSL and the port:
loo_Imap.Ssl = 1
// The typical port for IMAP SSL is 993
loo_Imap.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.)
loo_CertStore = create oleobject
li_rc = loo_CertStore.ConnectToNewObject("Chilkat.CertStore")

// The 1st argument is the filename, the 2nd arg is the 
// PFX file's password:
li_Success = loo_CertStore.LoadPfxFile("myCertWithPrivateKey.pfx","secret")
if li_Success = 0 then
    Write-Debug loo_CertStore.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    return
end if

// Find the certificate by the subject common name:
loo_JsonCN = create oleobject
li_rc = loo_JsonCN.ConnectToNewObject("Chilkat.JsonObject")

loo_JsonCN.UpdateString("CN","cert common name")

loo_Cert = create oleobject
li_rc = loo_Cert.ConnectToNewObject("Chilkat.Cert")

li_Success = loo_CertStore.FindCert(loo_JsonCN,loo_Cert)
if li_Success = 0 then
    Write-Debug loo_CertStore.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    destroy loo_JsonCN
    destroy loo_Cert
    return
end if

// 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:
loo_Cert2 = create oleobject
li_rc = loo_Cert2.ConnectToNewObject("Chilkat.Cert")

// The 1st argument is the filename, the 2nd arg is the 
// PFX file's password:
li_Success = loo_Cert2.LoadPfxFile("myClientCert.pfx","secret")
if li_Success = 0 then
    Write-Debug loo_Cert.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    destroy loo_JsonCN
    destroy loo_Cert
    destroy loo_Cert2
    return
end if

// Use the cert:
li_Success = loo_Imap.SetSslClientCert(loo_Cert)

// Connect to an IMAP server.
li_Success = loo_Imap.Connect("imap.example.com")
if li_Success = 0 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    destroy loo_JsonCN
    destroy loo_Cert
    destroy loo_Cert2
    return
end if

// Login
li_Success = loo_Imap.Login("myLogin","myPassword")
if li_Success = 0 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    destroy loo_JsonCN
    destroy loo_Cert
    destroy loo_Cert2
    return
end if

// Select an IMAP mailbox
li_Success = loo_Imap.SelectMailbox("Inbox")
if li_Success = 0 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    destroy loo_JsonCN
    destroy loo_Cert
    destroy loo_Cert2
    return
end if

// Get the message IDs of all the emails in the mailbox
li_FetchUids = 1
loo_MessageSet = create oleobject
li_rc = loo_MessageSet.ConnectToNewObject("Chilkat.MessageSet")

li_Success = loo_Imap.QueryMbx("ALL",li_FetchUids,loo_MessageSet)
if li_Success = 0 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    destroy loo_JsonCN
    destroy loo_Cert
    destroy loo_Cert2
    destroy loo_MessageSet
    return
end if

// Fetch the emails into a bundle object:
loo_Bundle = create oleobject
li_rc = loo_Bundle.ConnectToNewObject("Chilkat.EmailBundle")

li_HeadersOnly = 0
li_Success = loo_Imap.FetchMsgSet(li_HeadersOnly,loo_MessageSet,loo_Bundle)
if li_Success = 0 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    destroy loo_CertStore
    destroy loo_JsonCN
    destroy loo_Cert
    destroy loo_Cert2
    destroy loo_MessageSet
    destroy loo_Bundle
    return
end if

// Loop over the bundle and display the FROM and SUBJECT of each.
loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")

i = 0
li_NumEmails = loo_Bundle.MessageCount
do while i < li_NumEmails
    loo_Bundle.EmailAt(i,loo_Email)

    Write-Debug loo_Email.From
    Write-Debug loo_Email.Subject
    Write-Debug "--"
    i = i + 1
loop

// Disconnect from the IMAP server.
li_Success = loo_Imap.Disconnect()


destroy loo_Imap
destroy loo_CertStore
destroy loo_JsonCN
destroy loo_Cert
destroy loo_Cert2
destroy loo_MessageSet
destroy loo_Bundle
destroy loo_Email