Secure Node agent installation on Windows


The Secure Node agent is available for Windows, Linux, and Mac operating systems. This article will show you how to install the Windows version of the client.

Secure Nodes can be used to access resources that are based in external networks that you are not able to route to by other means. The Secure Node agent maintains a tunnel between networks so that you can publish resources on your Hypersocket server as if they were local LAN services.



The Secure Node feature should be installed on the server (in the top navbar from Updates, Features & Licensing->Features->Secure Node).


Click on the download link for the feature and accept the license agreement that appears. Restart the Hypersocket server when prompted.

Before the agent can be installed and configured, you must have a Secure Node resource created and configured on the server (see Getting Started Guide or Administrator's Manual) 


Step 1 – Download the agent

The Secure Node agent is required to be able to route to resources in other networks. Installing the agent requires administrator rights.

To get the agent installer the user should first log on to the Hypersocket web interface, then click on the Downloads button in the top navbar. In the Downloads page that appears, click on the link for the correct client operating system. We will demonstrate the Windows client here.


Step 2 – Installing the client

Before you install the client, you need to download the private key from the key pair that was generated during the configuration of the Secure Node resource that should already have been created.

Log on to the web UI as admin and navigate to Service Keys. For the key you want, click the green Gears icon next to the key and click Download Public Key.


Save the resulting .pub flie that will be downloaded.

With the agent install that was downloaded in Step 1, double click it to launch the installer. Click Yes on any UAC prompt that appears.

On the welcome page, click Next to continue.


Either accept the default destination directory or click Browse to choose your own directory, then click Next.


Click Next.


Type in the name of the Secure Node. NOTE: this must be the same as the Secure Node resource that has been created on the server. Also enter the Hypersocket server's host or IP and the SSH port number that is configured (default 4022).

Click Next to continue.


Edit the Public Key that was downloaded earlier and paste the contents of that file into the Public Key text field. Click Next.


The install then proceeds and the files are copied to the system.

When completed, click Finish.


Step 3 - The agent service

The agent install also creates a service called Hypersocket Secure Node, which should automatically start. However it is worth checking if this is running and start it if it is not currently running.

Open Computer Management in Windows and go to the Services Module to find the service.


You may now continue to configure the Server Agent Routes on the server and then publish your resources.

Have more questions? Submit a request