SSH Tunnel Authenticate with a SecureString Password and Private Key

See more SSH Tunnel Examples

Demonstrates the Chilkat SshTunnel.AuthenticateSecPwPk method, which authenticates using SecureString login and password objects together with a private key. The third argument is the SshKey private key.

Note: The private-key path is relative to the application's current working directory. Absolute paths may also be used. Supply the path to your own key file.

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.SshKey,
  Chilkat.SshTunnel,
  Chilkat.SecureString;

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

procedure RunDemo;
var
  success: Boolean;
  tunnel: TSshTunnel;
  sshPort: Integer;
  password: string;
  privKey: TSshKey;
  keyText: string;
  secureLogin: TSecureString;
  securePassword: TSecureString;
  waitForThreadExit: Boolean;

begin
  success := False;

  //  Demonstrates the SshTunnel.AuthenticateSecPwPk method, which authenticates using SecureString
  //  login and password objects together with a private key.  The 1st argument is the username, the
  //  2nd is the password, and the 3rd is an SshKey private key.

  tunnel := TSshTunnel.Create;

  //  The tunnel forwards accepted local connections to this destination through the SSH server.
  tunnel.DestHostname := 'db.internal.example.com';
  tunnel.DestPort := 5432;

  //  Connect to the SSH server.  This performs the TCP/proxy connection and SSH handshake, but
  //  does not authenticate yet.
  sshPort := 22;
  success := tunnel.Connect('ssh.example.com',sshPort);
  if (success = False) then
    begin
      WriteLn(tunnel.LastErrorText);
      Exit;
    end;

  //  Normally you would not hard-code the password in source.  You should instead obtain it
  //  from an interactive prompt, environment variable, or a secrets vault.
  password := 'mySshPassword';

  //  Load the SSH private key.  LoadText reads the file's text, which is then imported.
  privKey := TSshKey.Create;
  keyText := privKey.LoadText('qa_data/id_rsa');
  if (privKey.LastMethodSuccess = False) then
    begin
      WriteLn(privKey.LastErrorText);
      Exit;
    end;
  success := privKey.FromOpenSshPrivateKey(keyText);
  if (success = False) then
    begin
      WriteLn(privKey.LastErrorText);
      Exit;
    end;

  //  Place the login and password into SecureString objects.
  secureLogin := TSecureString.Create;
  secureLogin.Append('mySshLogin');
  securePassword := TSecureString.Create;
  securePassword.Append(password);

  success := tunnel.AuthenticateSecPwPk(secureLogin,securePassword,privKey);
  if (success = False) then
    begin
      WriteLn(tunnel.LastErrorText);
      Exit;
    end;
  WriteLn('Authenticated.');

  //  After authenticating, call BeginAccepting to start listening for local connections to forward.

  waitForThreadExit := True;
  success := tunnel.CloseTunnel(waitForThreadExit);
  if (success = False) then
    begin
      WriteLn(tunnel.LastErrorText);
      Exit;
    end;


  tunnel.Free;
  privKey.Free;
  secureLogin.Free;
  securePassword.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.