Delphi DLL

SSH Tunnel (Port Forwarding via direct-tcpip channel)

See more SSH Examples

Demonstrates how to create an SSH tunnel to a remote hostname:port via a direct-tcpip channel. Delphi DLL

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

...

procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
ssh: HCkSsh;
hostname: PWideChar;
port: Integer;
channelNum: Integer;
httpReq: PWideChar;
caseSensitive: Boolean;
matchStr: PWideChar;
responseHeader: PWideChar;
numBytesRead: Integer;
pollTimeoutMs: Integer;
htmlBody: PWideChar;

begin
success := False;

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

ssh := CkSsh_Create();

// Connect to an SSH server:

// Hostname may be an IP address or hostname:
hostname := '192.168.1.117';
port := 22;

success := CkSsh_Connect(ssh,hostname,port);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Wait a max of 5 seconds when reading responses..
CkSsh_putIdleTimeoutMs(ssh,5000);

// Authenticate using login/password:
success := CkSsh_AuthenticatePw(ssh,'chilkat','myPassword');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Open a direct-tcpip channel.  We want the SSH server to connect
// to www.chilkatsoft.com, port 80 (i.e. the web server).
// Data sent through the SSH tunnel is forwarded to the remote
// host:port.  (Note: The remote host:port does not need to be 
// a web server.  It can be anything.  It can be your own
// customer application server that listens on a port, or any
// other type of server.)
// When we read from the SSH channel, we'll be reading data
// sent from the remote host:port (i.e. the web server in this
// example).

channelNum := CkSsh_OpenDirectTcpIpChannel(ssh,'www.chilkatsoft.com',80);
if (channelNum < 0) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Build a simple HTTP GET request for http://www.chilkatsoft.com/xyz.html
httpReq := 'GET /xyz123.html HTTP/1.1' + #13#10 + 'Host: www.chilkatsoft.com' + #13#10 + #13#10;

// Send the HTTP request:
success := CkSsh_ChannelSendString(ssh,channelNum,httpReq,'ansi');
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Get the HTTP response.
// First read the HTTP response header which ends with a double CRLF.
// Calling ChannelReceiveUntilMatch will receive until match string is seen,
// or until a timeout occurs (IdleTimeoutMs property).  ChannelReceiveUntilMatch
// may read beyond the match string, but it will stop reading as soon as the match
// string is seen.
caseSensitive := False;
matchStr := #13#10 + #13#10;
success := CkSsh_ChannelReceiveUntilMatch(ssh,channelNum,matchStr,'ansi',caseSensitive);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Extract the HTTP header from the receive buffer.
// (GetReceiveTextS extracts up to and including the match string from the receive buffer)

responseHeader := CkSsh__getReceivedTextS(ssh,channelNum,matchStr,'ansi');
Memo1.Lines.Add('---- HTTP Response Header ----');
Memo1.Lines.Add(responseHeader);

// Now get the body of the HTTP response (this is the HTML content
// of http://www.chilkatsoft.com/xyz.html
// It's possible we've already received the entire HTTP response in the
// call to ChannelReceiveUntilMatch.  Therefore, we'll poll for any remaining data
// and wait a max of .2 seconds.

pollTimeoutMs := 200;
numBytesRead := CkSsh_ChannelPoll(ssh,channelNum,pollTimeoutMs);
// We're not checking for an error here.
// A return value of -2 means that no data was available and the poll simply timed out (not an error)
// A return value of -1 indicates an error.
// A return value greater than 0 indicates that additional data was received.

Memo1.Lines.Add('---- HTML BODY ----');

// Extract the remainder of the accumulated data in the internal receive buffer.
// This should be our HTML body:

htmlBody := CkSsh__getReceivedText(ssh,channelNum,'ansi');
Memo1.Lines.Add(htmlBody);

// Close the channel:
success := CkSsh_ChannelSendClose(ssh,channelNum);
if (success <> True) then
  begin
    Memo1.Lines.Add(CkSsh__lastErrorText(ssh));
    Exit;
  end;

// Disconnect
CkSsh_Disconnect(ssh);

CkSsh_Dispose(ssh);

end;