(Android™) SMTP SSH Tunneling (Port Forwarding)

Demonstrates how to setup an SSH tunnel for SMTP. This example connects to an SMTP sever via an SSH tunnel and sends an email.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// 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);

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

    // The mailman object is used for sending (SMTP) and receiving (POP3) email.
    CkMailMan mailman = new CkMailMan();

    // Connect to an SSH server and establish the SSH tunnel:

    // The SSH hostname may be a hostname or an 
    // IP address, such as "192.168.1.108".
    // The port is typically 22 (the standard port for SSH).
    String sshHostname = "sftp.example.com";
    int sshPort = 22;

    boolean success = mailman.SshOpenTunnel(sshHostname,sshPort);
    if (success != true) {
        Log.i(TAG, mailman.lastErrorText());
        return;
        }

    // Authenticate with the SSH server via a login/password
    // or with a public key.
    // This example demonstrates SSH password authentication.
    // Note: This is not authenticating with the SMTP server, it is
    // for authenticating with the SSH server, which is separate.
    success = mailman.SshAuthenticatePw("sshLogin","sshPassword");
    if (success != true) {
        Log.i(TAG, mailman.lastErrorText());
        return;
        }

    // OK, the SSH tunnel is setup.  The mailman may
    // be used exactly the same as usual, except all communications
    // are now sent through the SSH tunnel.

    // Set the SMTP server.
    mailman.put_SmtpHost("smtp.my-smtp-server.com");

    // Set the SMTP login/password (if required)
    mailman.put_SmtpUsername("smtpLogin");
    mailman.put_SmtpPassword("smtpPassword");

    // Create a new email object
    CkEmail email = new CkEmail();

    email.put_Subject("This is a test");
    email.put_Body("This is a test");
    email.put_From("Chilkat Support <support@chilkatsoft.com>");
    success = email.AddTo("Chilkat Admin","admin@chilkatsoft.com");

    // The call to SendEmail automatically connects to the SMTP
    // server via the SSH tunnel (if not already connected).
    // Because the SSH tunnel has been previously setup,
    // this does not establish a direct connection with the SMTP
    // server.  It directs the SSH server to establish the connection.

    // After SendEmail completes, the connection (i.e. session) remains
    // open so that subsequent SendEmail calls may use the
    // same SSH tunnel.  
    success = mailman.SendEmail(email);
    if (success != true) {
        Log.i(TAG, mailman.lastErrorText());
        return;
        }

    // If you're curious, have a look at LastErrorText after
    // a successful send.  You'll see detailed information that 
    // confirms the SSH tunneling.
    Log.i(TAG, mailman.lastErrorText());

    // Note: Some SMTP servers do not actually send the email until 
    // the connection is closed.  In these cases, it is necessary to
    // call CloseSmtpConnection for the mail to be  sent.  
    // Most SMTP servers send the email immediately, and it is 
    // not required to close the connection.  

    Log.i(TAG, "Mail Sent!");

  }

  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."
  }
}