PowerShell

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

Add-Type -Path "C:\chilkat\ChilkatDotNet47-x64\ChilkatDotNet47.dll"

$success = $false

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

$imap = New-Object Chilkat.Imap

# To use a secure SSL connection, set SSL and the port:
$imap.Ssl = $true
# The typical port for IMAP SSL is 993
$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.)
$certStore = New-Object Chilkat.CertStore
# The 1st argument is the filename, the 2nd arg is the 
# PFX file's password:
$success = $certStore.LoadPfxFile("myCertWithPrivateKey.pfx","secret")
if ($success -eq $false) {
    $($certStore.LastErrorText)
    exit
}

# Find the certificate by the subject common name:
$jsonCN = New-Object Chilkat.JsonObject
$jsonCN.UpdateString("CN","cert common name")

$cert = New-Object Chilkat.Cert
$success = $certStore.FindCert($jsonCN,$cert)
if ($success -eq $false) {
    $($certStore.LastErrorText)
    exit
}

# 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:
$cert2 = New-Object Chilkat.Cert
# The 1st argument is the filename, the 2nd arg is the 
# PFX file's password:
$success = $cert2.LoadPfxFile("myClientCert.pfx","secret")
if ($success -eq $false) {
    $($cert.LastErrorText)
    exit
}

# Use the cert:
$success = $imap.SetSslClientCert($cert)

# Connect to an IMAP server.
$success = $imap.Connect("imap.example.com")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Login
$success = $imap.Login("myLogin","myPassword")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Select an IMAP mailbox
$success = $imap.SelectMailbox("Inbox")
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Get the message IDs of all the emails in the mailbox
$fetchUids = $true
$messageSet = New-Object Chilkat.MessageSet
$success = $imap.QueryMbx("ALL",$fetchUids,$messageSet)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Fetch the emails into a bundle object:
$bundle = New-Object Chilkat.EmailBundle
$headersOnly = $false
$success = $imap.FetchMsgSet($headersOnly,$messageSet,$bundle)
if ($success -eq $false) {
    $($imap.LastErrorText)
    exit
}

# Loop over the bundle and display the FROM and SUBJECT of each.
$email = New-Object Chilkat.Email
$i = 0
$numEmails = $bundle.MessageCount
while ($i -lt $numEmails) {
    $bundle.EmailAt($i,$email)

    $($email.From)
    $($email.Subject)
    $("--")
    $i = $i + 1
}

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