Delphi DLL

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.

Delphi DLL

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Imap, Ssh;

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
ssh1: HCkSsh;
ssh2: HCkSsh;
imap: HCkImap;

begin
success := False;

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

ssh1 := CkSsh_Create();

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

// Authenticate using login/password:
success := CkSsh_AuthenticatePw(ssh1,'ssh1Login','ssh1Password');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh1));
    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 := CkSsh_Create();
success := CkSsh_ConnectThroughSsh(ssh2,ssh1,'serverssh2.com',22);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh2));
    Exit;
  end;

// Authenticate with ssh2...
success := CkSsh_AuthenticatePw(ssh2,'ssh2Login','ssh2Password');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh2));
    Exit;
  end;

imap := CkImap_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 := CkImap_UseSsh(imap,ssh2);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

CkImap_putSsl(imap,True);
CkImap_putPort(imap,993);

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

// Login
success := CkImap_Login(imap,'myLogin','myPassword');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    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 := CkImap_CreateMailbox(imap,'newFolder');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkImap__lastErrorText(imap));
    Exit;
  end;

Memo1.Lines.Add('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 := CkImap_Disconnect(imap);

// 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.
CkSsh_Disconnect(ssh2);

CkSsh_Disconnect(ssh1);

CkSsh_Dispose(ssh1);
CkSsh_Dispose(ssh2);
CkImap_Dispose(imap);

end;