Android™
Android™
Set the Decryption Certificate for MailMan
See more POP3 Examples
Demonstrates the Chilkat MailMan.SetDecryptCert method, which explicitly specifies the certificate to use when decrypting encrypted email. The certificate must correspond to the recipient certificate used to encrypt the message and must have access to its private key. This example loads the certificate from a PFX, registers it, and fetches a message that Chilkat can then decrypt.
Background: Decrypting S/MIME mail requires the recipient's private key, so the certificate you supply must carry it — which is why a PFX (certificate + private key in one password-protected file) is used here. Chilkat can find installed certificates automatically on Windows and macOS;
SetDecryptCert is how you point it at a specific one instead. If the certificate and key live in separate files, use SetDecryptCert2.Chilkat Android™ Downloads
// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;
import android.app.Activity;
import com.chilkatsoft.*;
import android.widget.TextView;
import android.os.Bundle;
public class SimpleActivity extends Activity {
private static final String TAG = "Chilkat";
// Called when the activity is first created.
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
boolean success = false;
// Demonstrates the MailMan.SetDecryptCert method, which explicitly specifies the certificate
// to use when decrypting encrypted email. The certificate must correspond to the recipient
// certificate used to encrypt the message, and must have access to its private key.
CkMailMan mailman = new CkMailMan();
// Configure the POP3 server connection.
mailman.put_MailHost("pop.example.com");
mailman.put_MailPort(995);
mailman.put_PopSsl(true);
mailman.put_PopUsername("user@example.com");
mailman.put_PopPassword("myPassword");
// Load the certificate together with its private key from a PFX file.
CkCert cert = new CkCert();
success = cert.LoadPfxFile("qa_data/certs/decryption.pfx","pfx_password");
if (success == false) {
Log.i(TAG, cert.lastErrorText());
return;
}
// Specify the certificate to use when decrypting downloaded email.
success = mailman.SetDecryptCert(cert);
if (success == false) {
Log.i(TAG, mailman.lastErrorText());
return;
}
// Fetch a message; if it is encrypted, Chilkat decrypts it using this certificate.
CkEmail email = new CkEmail();
success = mailman.FetchOne(false,0,1,email);
if (success == false) {
Log.i(TAG, mailman.lastErrorText());
return;
}
Log.i(TAG, "ReceivedEncrypted = " + String.valueOf(email.get_ReceivedEncrypted()));
Log.i(TAG, "Decrypted = " + String.valueOf(email.get_Decrypted()));
// Note: The path "qa_data/certs/decryption.pfx" is a relative local filesystem path,
// relative to the current working directory of the running application.
// Note: Explicitly connecting/authenticating is optional. Chilkat MailMan automatically
// connects and authenticates -- using the property settings above -- whenever a server
// operation requires it. Calling the explicit connect/authenticate methods can still be
// helpful to determine whether a failure occurs while connecting or while authenticating.
}
static {
System.loadLibrary("chilkat");
// Note: If the incorrect library name is passed to System.loadLibrary,
// then you will see the following error message at application startup:
//"The application <your-application-name> has stopped unexpectedly. Please try again."
}
}