Pascal (Lazarus/Delphi)

IMAP SSH Tunneling (Port Forwarding)

Demonstrates how to setup and use an SSH tunnel for IMAP. Pascal (Lazarus/Delphi)

program ChilkatDemo;

// Demonstrates using the Chilkat Pascal wrapper via the C bridge DLL.
// Builds as a console application under Lazarus (FPC) or Delphi.

{$IFDEF FPC}
  {$MODE DELPHI}
{$ENDIF}
{$APPTYPE CONSOLE}

uses
  {$IFDEF UNIX}
  cthreads,
  {$ENDIF}
  SysUtils,
  CkDllLoader,
  Chilkat.Imap,
  Chilkat.Email;

// ---------------------------------------------------------------------------

procedure RunDemo;
var
  success: Boolean;
  imap: TImap;
  sshHostname: string;
  sshPort: Integer;
  msgCount: Integer;
  upperBound: Integer;
  email: TEmail;
  i: Integer;
  bUid: Boolean;

begin
  success := False;

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

  imap := TImap.Create;

  //  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).
  sshHostname := 'www.mysshserver.com';
  sshPort := 22;

  //  Connect to an SSH server and establish the SSH tunnel:
  success := imap.SshOpenTunnel(sshHostname,sshPort);
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  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 IMAP server, it is
  //  for authenticating with the SSH server, which is separate.
  success := imap.SshAuthenticatePw('mySshLogin','mySshPassword');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

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

  //  Connect to an IMAP server via the SSH tunnel.
  //  Because the SSH tunnel has been previously setup,
  //  this does not establish a direct connection with the IMAP
  //  server.  It directs the SSH server to establish the connection.

  //  In this example, the IMAP server requires SSL/TLS.  The TLS connection
  //  will be enclosed within the SSH tunnel.
  imap.Ssl := True;
  imap.Port := 993;
  success := imap.Connect('imap.my-imap-server.com');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Authenticate with the IMAP server via the SSH tunnel.
  success := imap.Login('myLogin','myPassword');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Select an IMAP mailbox
  success := imap.SelectMailbox('Inbox');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  How many messages in Inbox?
  msgCount := imap.NumMessages;
  if (msgCount = 0) then
    begin
      WriteLn('No messages found.');
      Exit;
    end;

  upperBound := 10;
  if (msgCount < upperBound) then
    begin
      upperBound := msgCount;
    end;

  //  Download up to the 1st 10 messages.
  email := TEmail.Create;

  bUid := False;
  for i := 1 to upperBound do
    begin

      success := imap.FetchEmail(False,i,bUid,email);
      if (success = False) then
        begin
          WriteLn(imap.LastErrorText);
          Exit;
        end;

      WriteLn(email.From);
      WriteLn(email.Subject);
      WriteLn('----');
    end;

  //  Disconnect from the IMAP server.
  //  The SSH tunnel remains open.
  success := imap.Disconnect();
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  It is possible to re-use the existing SSH tunnel for the next connection:
  success := imap.Connect('imap.my-imap-server2.com');
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Review the LastErrorText to see that the connection was made via the SSH tunnel:
  WriteLn(imap.LastErrorText);

  success := imap.Disconnect();
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Finally, close the SSH tunnel.
  success := imap.SshCloseTunnel();
  if (success = False) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  WriteLn('IMAP SSH tunneling example completed.');


  imap.Free;
  email.Free;

end;

// ---------------------------------------------------------------------------

begin

  try
    RunDemo;
  except
    on E: Exception do
      WriteLn('Unhandled exception: ', E.ClassName, ': ', E.Message);
  end;

  WriteLn;
  {$IFDEF MSWINDOWS}
  WriteLn('Press Enter to exit...');
  ReadLn;
  {$ENDIF}
end.