Creating SSH Resource using PuTTY

This article show you how to set up an SSH resource allowing end users to connect remotely to an SSH server with a single click. This example does not need the SSH client to installed on the client PC.


  • Windows client computer
  • Hypersocket client installed on client computer


Step 1: Create an SSH Application

Navigate to Administration->Network and select Applications. At the time of writing there is currently no Windows SSH application template available, click Create.

Fill in the following details, in this example I am using putty.exe as the SSH client. We are going to install this executable into the template, this file will be downloaded into a directory under the Hypersocket client install directory which will be named the same as the template name entered.

  • Name - of application template, in this example I have used 'Putty'
  • Operating System - this should be a suitable base Windows version, here vista should cover all versions above XP
  • Executable - Click the ${} button, select ${client.userdir} then add \Putty\putty.exe
  • Arguments - command line arguments required for the chosen client


Putty.exe requires the following, -ssh and ${username}@${host}. You can see we have used ${username} and ${hostname} these will be substituted at runtime with the users actual username and endpoint hostname.


Now click the Files tab. Here we will upload the putty executable. Click the + button, click Choose file and select a copy of putty.exe. Click the Upload button, then click Create to finish the application creation.


Step 2: Create an Endpoint

From the administrator portal navigate to Endpoints and click Create.


 Provide the following details:

  • Name - as seen by the client
  • Hostname - server to connect to as a hostname, this will be visible on the client
  • Destination Host/IP - this is the actual server as seen within the internal network if different from the hostname


Step 2a: Select SSH Protocol

Hypersocket default list of protocols include the SSH protocol, from the Protocol tab select SSH.


Step 2b: Select SSH Application

From the Applications tab select the SSH application created in step 1.


Step 2c: Assign Resource to Users

With the Application selected and protocol, the final step is deciding who to assign this to resource to.

In the example above I assigned this to the Everyone role i.e. all my users.


Step 3: Launch Resource

When you launch and login to your desktop client you will see the new resource under the Applicaitons filter, designated by the Computer Icon to the left, and by an icon which has been autogenerated (in this case, using an acronym for Support Server, SS).

You can see in the image above the resource we named in Step 1, 'Support Server' is visible. Clicking this will launch the putty.exe application using the arguments we provided.



Additional Notes

Using More Complex Launching

The application template provides the ability to add further command line arguments and also the ability to launch pre and post scripts. The OSX SSH client demonstrates the power of this by actually requesting a username from the end user when the SSH resource is launched, you can see this by selecting this template and then choosing edit to see its internals.



Have more questions? Submit a request