Chilkat Examples

ChilkatHOMEAndroid™Classic ASPCC++C#Mono C#.NET Core C#C# UWP/WinRTDataFlexDelphi ActiveXDelphi DLLVisual FoxProJavaLianjaMFCObjective-CPerlPHP ActiveXPHP ExtensionPowerBuilderPowerShellPureBasicCkPythonChilkat2-PythonRubySQL ServerSwift 2Swift 3/4TclUnicode CUnicode C++Visual Basic 6.0VB.NETVB.NET UWP/WinRTVBScriptXojo PluginNode.jsExcelGo

PureBasic Examples

Web API Categories

ASN.1
Amazon Glacier
Amazon S3
Amazon S3 (new)
Amazon SES
Amazon SNS
Amazon SQS
Async
Azure Cloud Storage
Azure Service Bus
Base64
Bounced Email
Box
CAdES
CSR
CSV
Certificates
Compression
DKIM / DomainKey
DSA
Diffie-Hellman
Digital Signatures
Dropbox
Dynamics CRM
ECC
Email Object
Encryption
FTP
FileAccess
Firebase
GMail REST API
Geolocation
Google APIs
Google Calendar
Google Cloud Storage
Google Drive
Google Photos
Google Sheets
Google Tasks
Gzip
HTML-to-XML/Text

HTTP
HTTP Misc
IMAP
JSON
JSON Web Encryption (JWE)
JSON Web Signatures (JWS)
JSON Web Token (JWT)
Java KeyStore (JKS)
MHT / HTML Email
MIME
Microsoft Graph
NTLM
OAuth1
OAuth2
OneDrive
OpenSSL
Outlook
PEM
PFX/P12
POP3
PRNG
REST
REST Misc
RSA Encryption
SCP
SFTP
SMTP
SSH
SSH Key
SSH Tunnel
SharePoint
Socket/SSL/TLS
Spider
Stream
Tar Archive
Upload
WebSocket
XAdES
XML
XML Digital Signatures
XMP
Zip
curl

 

 

 

(PureBasic) TCP or TLS over Multiple Hop SSH to Remote Server

Demonstrates how to use the Chilkat Socket API to connect to a remote server (using TCP or TLS) tunneled through mulitple-hop SSH. The scheme looks like this:

Application => ServerSSH1 => ServerSSH2 => DestinationServer

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

Chilkat PureBasic Module Download

Chilkat PureBasic Module

IncludeFile "CkSsh.pb"
IncludeFile "CkSocket.pb"

Procedure ChilkatExample()

    ;  Important: It is helpful to send the contents of the
    ;  ssh.LastErrorText property when requesting support.

    ssh1.i = CkSsh::ckCreate()
    If ssh1.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ;  Any string automatically begins a fully-functional 30-day trial.
    success.i = CkSsh::ckUnlockComponent(ssh1,"Anything for 30-day trial")
    If success <> 1
        Debug CkSsh::ckLastErrorText(ssh1)
        CkSsh::ckDispose(ssh1)
        ProcedureReturn
    EndIf

    ;  Connect directly to the 1st SSH server.
    success = CkSsh::ckConnect(ssh1,"serverssh1.com",22)
    If success <> 1
        Debug CkSsh::ckLastErrorText(ssh1)
        CkSsh::ckDispose(ssh1)
        ProcedureReturn
    EndIf

    ;  Authenticate using login/password:
    success = CkSsh::ckAuthenticatePw(ssh1,"ssh1Login","ssh1Password")
    If success <> 1
        Debug CkSsh::ckLastErrorText(ssh1)
        CkSsh::ckDispose(ssh1)
        ProcedureReturn
    EndIf

    ;  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.i = CkSsh::ckCreate()
    If ssh2.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkSsh::ckConnectThroughSsh(ssh2,ssh1,"serverssh2.com",22)
    If success <> 1
        Debug CkSsh::ckLastErrorText(ssh2)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        ProcedureReturn
    EndIf

    ;  Authenticate with ssh2...
    success = CkSsh::ckAuthenticatePw(ssh2,"ssh2Login","ssh2Password")
    If success <> 1
        Debug CkSsh::ckLastErrorText(ssh2)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        ProcedureReturn
    EndIf

    socket.i = CkSocket::ckCreate()
    If socket.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkSocket::ckUnlockComponent(socket,"Anything for 30-day trial")
    If success <> 1
        Debug CkSocket::ckLastErrorText(socket)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    ;  Tell the socket object to connect to our destination server though the ssh2 tunnel (which itself is routed through ssh1).
    ;  The connection looks like this:  ApplicationSocket(TLS) => ServerSSH1 => ServerSSH2 => DestinationServer
    success = CkSocket::ckUseSsh(socket,ssh2)
    If success <> 1
        Debug CkSocket::ckLastErrorText(socket)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    ;  Connect using TLS to www.chilkatsoft.com
    ;  We could also tunnel a bare TCP connection by specifying port 80 with useTls = 0.
    useTls.i = 1
    maxWaitMillisec.i = 20000
    success = CkSocket::ckConnect(socket,"www.chilkatsoft.com",443,useTls,maxWaitMillisec)
    If success <> 1
        Debug CkSocket::ckLastErrorText(socket)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    ;  Once the multiple hop SSH tunneled connection is setup,  the socket programming
    ;  is identical to the normal case where we have a direct connection.

    ;  Tell the socket object that all text is to be sent in the utf-8 encoding,
    ;  and the text received is assumed to be utf-8.
    CkSocket::setCkStringCharset(socket, "utf-8")

    ;  Send an HTTP HEAD request:
    success = CkSocket::ckSendString(socket,"HEAD / HTTP/1.1" + Chr(13) + Chr(10) + "Host: www.chilkatsoft.com" + Chr(13) + Chr(10) + Chr(13) + Chr(10))
    If success <> 1
        Debug CkSocket::ckLastErrorText(socket)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    ;  Wait a maximum of 4 seconds while no data is forthcoming:
    CkSocket::setCkMaxReadIdleMs(socket, 4000)

    ;  Get the 1st response line, which should be "HTTP/1.1 200 OK"
    responseStatusLine.s = CkSocket::ckReceiveToCRLF(socket)
    If CkSocket::ckLastMethodSuccess(socket) <> 1
        Debug CkSocket::ckLastErrorText(socket)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    Debug "StatusLine: " + responseStatusLine

    ;  Now get the 1st line of the response header:
    responseHeaderLine.s = CkSocket::ckReceiveToCRLF(socket)
    If CkSocket::ckLastMethodSuccess(socket) <> 1
        Debug CkSocket::ckLastErrorText(socket)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    Debug "HeaderLine: " + responseHeaderLine

    ;  Now read the remainder of the response header by reading until a double CRLF is seen:
    remainderOfHeader.s = CkSocket::ckReceiveUntilMatch(socket,Chr(13) + Chr(10) + Chr(13) + Chr(10))
    If CkSocket::ckLastMethodSuccess(socket) <> 1
        Debug CkSocket::ckLastErrorText(socket)
        CkSsh::ckDispose(ssh1)
        CkSsh::ckDispose(ssh2)
        CkSocket::ckDispose(socket)
        ProcedureReturn
    EndIf

    Debug "Remainder: " + remainderOfHeader

    ;  Close the connection with the server.  This closes the tunnel through ssh2.
    ;  Wait a max of 20 seconds (20000 millsec)
    success = CkSocket::ckClose(socket,20000)

    ;  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::ckDisconnect(ssh2)

    CkSsh::ckDisconnect(ssh1)


    CkSsh::ckDispose(ssh1)
    CkSsh::ckDispose(ssh2)
    CkSocket::ckDispose(socket)


    ProcedureReturn
EndProcedure

 

© 2000-2019 Chilkat Software, Inc. All Rights Reserved.