B4X Requires Chilkat v11.0.0+
B4X
POP3 Read S/MIME Encrypted Email
Read S/MIME encrypted email.Chilkat B4X Downloads
Dim success As Boolean = False
' This example assumes the Chilkat API to have been previously unlocked.
' See Global Unlock Sample for sample code.
' The mailman object is used for receiving (POP3)
' and sending (SMTP) email.
Dim mailman As ChilkatMailMan
mailman.Initialize("mailman")
' Set the POP3 server's hostname
mailman.MailHost = "pop.example.com"
' Set the POP3 login/password.
mailman.PopUsername = "myLogin"
mailman.PopPassword = "myPassword"
' If running on Microsoft Windows, the Chilkat mailman
' will automatically search the registry-based certificate stores
' for matching certificates and private keys required for
' decryption. However, on Linux, MAX OS X, and other
' operating systems, no such thing exists. Therefore, you'll
' need to specify one or more PFX (.p12 / .pfx) files as
' sources for locating the certs required for decyrption.
success = mailman.AddPfxSourceFile("/pfxFiles/certs_and_keys_1.pfx", "pfxPassword1")
If success = False Then
Log(mailman.LastErrorText)
Return
End If
success = mailman.AddPfxSourceFile("/pfxFiles/certs_and_keys_2.pfx", "pfxPassword2")
If success = False Then
Log(mailman.LastErrorText)
Return
End If
' ...
' Note: On MS Windows, it is not required to provide PFX sources
' if the needed certs and private keys are already installed
' on the system (in the registry-based certificate stores).
' Copy the all email from the user's POP3 mailbox
' into a bundle object. The email remains on the server.
Dim bundle As ChilkatEmailBundle
bundle.Initialize
Dim keepOnServer As Boolean = True
Dim headersOnly As Boolean = False
' Irrelevent because we are NOT downloading headers-only
Dim numBodyLines As Int = 0
success = mailman.FetchAll(keepOnServer, headersOnly, numBodyLines, bundle)
If success = False Then
Log(mailman.LastErrorText)
Return
End If
' S/MIME security envelopes are automatically "unwrapped"
' when a message is retrieved from the server. Signed emails are automatically verified, and
' encrypted emails are automatically decrypted, restoring the email to the original state before
' signing and/or encrypting. Information about the signing and encrypting certificates can be
' retrieved from the Email object (methods: GetSignedByCert, GetEncryptedByCert;
' properties: SignedBy, EncryptedBy, SignaturesValid, Decrypted, ReceivedSigned,
' ReceivedEncrypted).
' Loop over the bundle
Dim email As ChilkatEmail
email.Initialize
Dim i As Int = 0
Do While i < bundle.MessageCount
bundle.EmailAt(i, email)
Log(email.From)
Log(email.Subject)
' At this point, if the email was signed and/or encrypted, it is already "unwrapped", i.e.
' the email is already decrypted and in a state as if it were never signed or encrypted.
' You may check to see if the email was received encrypted or signed, and if so,
' whether it was successfully unwrapped and who signed or encrypted it:
If email.ReceivedEncrypted = True Then
Log("This email was encrypted when received.")
If email.Decrypted = True Then
Log("This email was successfully decrypted. It was encrypted by:")
Log(email.EncryptedBy)
Else
Log("This email was not decrypted.")
End If
End If
If email.ReceivedSigned = True Then
Log("This email was signed when received.")
If email.SignaturesValid = True Then
Log("The signature was verified. It was signed by:")
Log(email.SignedBy)
Else
Log("The signature verification failed.")
End If
End If
' The email's body, HTML body, attachments, etc.
' are decrypted and available just like any non-encrypted email.
Log("--")
i = i + 1
Loop