Third-Party Tool Configuration for Remote Tunnel Access

Some clients require specific settings when connecting to a device through a secure tunnel.

SSH - PuTTY

Use PuTTY to configure the following parameters to set up a tunnel to connect to a device on a Windows 10 operating system.

  1. In the PuTTY Configuration window, select Sessions and specify the Host Name (or IP address) and Port that was displayed on the SSH Connection Parameters window when you tried to connect to a device in Device Cloud. For more information, see Creating a Secure Tunnel for an SSH Connection.
    SSH-PuTTY Session
  2. Select Connections > SSH > Tunnels and specify the Source port and Destination to set up the tunnel. Click Add.
    SSH-Port Forwarding
  3. Select Connections > SSH > Bugs and from the Ignores SSH-2 maxium packet size drop-down list, select Off. Click Open to start the SSH connection using a secure tunnel.
    SSH Server Bugs

TightVNC Server

Select the Access Control tab and then select Allow loopback connections.

Device Cloud - Remote Access TightVNC Server Configuration on Windows

WinSCP

  1. In the Login window, select Advanced.

  2. In the Advanced Site Settings window, select Bugs, select Off for Ignores SSH-2 maximum package Size and then click OK.
    Device Cloud - Remote Access WinSCP Settings

Remote Desktop Connection

  1. Open the Windows Remote Desktop client application you want to use for the session and specify the values for the host and port. See Creating a Secure Tunnel for a RDP Connection.

  2. Select the Display tab and select True Color (24 bit) from the drop-down list.

    RDP Display tab

  3. Select the Advanced tab, and select Connect and don't warn me from the drop-down list.

    RDP-Advanced tab

  4. In the Advanced tab window, choose Settings, to display the Connection settings window and choose Do not use an RD Gateway server check box.

    Connection Settings

  5. Click OK to return to the Advanced tab window.

Running the Agent as a Windows Service Using NSSM

If you use RDP remote access between two Windows 7 machines running the python agent, you can use the NSSM third-party application to set up the python agent to run as a service. NSSM monitors the running service and restarts it if it fails.

To set up the service, configure the following settings:

  1. Log in as an admin user and run cmd from the Start menu.

  2. Change directory to the NSSM location and run the following command from the prompt: 
    >nssm.exe install agent
    The NSSM service editor window appears.

  3. In the NSSM service editor window select the Details tab and for the Display name, type agent. For the Startup type, choose Automatic from the drop-down list.

    NSSM service editor - Name

  4. Select the Application tab, and type the following, for example:

    Path: 
    C:\Python27\python.exe
    Startup directory: 
    C:\Users\bmalhi\Desktop\git-hub\agent\device-cloud-python
    Arguments: 
    C:\device_manager.py
    NSSM service editor - Path
  5. To set up log files, select the I/O tab and for Error (stderr), type the following, for example,
    C:\Users\bmalhi\Desktop\git-hub\agent\device-cloud-python\info.log
    Note:

    The log file must be available in the folder.

    NSSM service editor - error

  6. Click Edit service to update the details.