Pascal (Lazarus/Delphi)

SSH Authenticate with a SecureString Password

Demonstrates the Chilkat Ssh.AuthenticateSecPw method, which performs the same authentication as AuthenticatePw but receives the login and password as SecureString objects. The first argument is the login and the second is the password.

Background: A SecureString keeps the credential encrypted in memory, reducing the chance of a plaintext password lingering in the process. The connection-state, retry, and AuthFailReason behavior matches AuthenticatePw; only the credential handling is more protective. Populate the SecureString from a value obtained at runtime, not a hard-coded literal.

Chilkat Pascal (Lazarus/Delphi) Downloads

Download Chilkat for Pascal (Lazarus/Delphi)

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

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

procedure RunDemo;
var
  success: Boolean;
  ssh: TSsh;
  sshPort: Integer;
  password: string;
  secureLogin: TSecureString;
  securePassword: TSecureString;

begin
  success := False;

  //  Demonstrates the Ssh.AuthenticateSecPw method, which authenticates using SecureString login
  //  and password objects.  The 1st argument is the login and the 2nd is the password.

  ssh := TSsh.Create;

  //  Connect to the SSH server.  Port 22 is the usual SSH port.
  sshPort := 22;
  success := ssh.Connect('ssh.example.com',sshPort);
  if (success = False) then
    begin
      WriteLn(ssh.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';

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

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

  ssh.Disconnect();


  ssh.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.