Pascal (Lazarus/Delphi)

IMAP over Multiple Hop SSH

Demonstrates how to read IMAP email (using TCP or TLS) tunneled through mulitple-hop SSH. The scheme looks like this:

Application => ServerSSH1 => ServerSSH2 => IMAPServer

The ConnectThroughSsh and UseSsh methods are added in Chilkat version 9.5.0.55 to accomplish this task.

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.Ssh;

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

procedure RunDemo;
var
  success: Boolean;
  ssh1: TSsh;
  ssh2: TSsh;
  imap: TImap;

begin
  success := False;

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

  ssh1 := TSsh.Create;

  //  Connect directly to the 1st SSH server.
  success := ssh1.Connect('serverssh1.com',22);
  if (success <> True) then
    begin
      WriteLn(ssh1.LastErrorText);
      Exit;
    end;

  //  Authenticate using login/password:
  success := ssh1.AuthenticatePw('ssh1Login','ssh1Password');
  if (success <> True) then
    begin
      WriteLn(ssh1.LastErrorText);
      Exit;
    end;

  //  Connect through the 1st SSH connection to reach a 2nd SSH server.
  //  Note: Any number of SSH connections may be simultaneously tunneled through a single
  //  existing SSH connection.
  ssh2 := TSsh.Create;
  success := ssh2.ConnectThroughSsh(ssh1,'serverssh2.com',22);
  if (success <> True) then
    begin
      WriteLn(ssh2.LastErrorText);
      Exit;
    end;

  //  Authenticate with ssh2...
  success := ssh2.AuthenticatePw('ssh2Login','ssh2Password');
  if (success <> True) then
    begin
      WriteLn(ssh2.LastErrorText);
      Exit;
    end;

  imap := TImap.Create;

  //  Tell the IMAP object to connect to the IMAP server though the ssh2 tunnel (which itself is routed through ssh1).
  //  The connection looks like this:  Application => ServerSSH1 => ServerSSH2 => IMAPServer
  success := imap.UseSsh(ssh2);
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  imap.Ssl := True;
  imap.Port := 993;

  //  Connect to an IMAP server (through the multi-hop SSH tunnel)
  success := imap.Connect('imap.someimapserver.com');
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Login
  success := imap.Login('myLogin','myPassword');
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  //  Do whatever needs to be done...  for example,

  //  Create the new email folder (sub-mailbox) on the IMAP server.
  //  If no folder path is provided, the new folder is a sub-mailbox of Inbox.
  success := imap.CreateMailbox('newFolder');
  if (success <> True) then
    begin
      WriteLn(imap.LastErrorText);
      Exit;
    end;

  WriteLn('Success.');

  //  Close the connection with the IMAP server.  (This closes the tunnel through ssh2)
  //  The connection with ssh2 is still alive, and may be used for more connections.
  success := imap.Disconnect();

  //  Close the connection with ssh2.  (This closes the the tunnel through ssh1.)
  //  The connection with ssh1 is still alive, and may be used for more connections.
  ssh2.Disconnect();

  ssh1.Disconnect();


  ssh1.Free;
  ssh2.Free;
  imap.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.