Skip to main content
Version: 1.3.1

Remote Access

To access a device remotely that runs thin-edge.io, a plugin of the operation plugin concept is used. The tedge-mapper is checking for cloud remote access operation and is triggering the particular plugin. You can use the remote access tab in device management to access the device via SSH or VNC.

Background information on the remote access feature provided by Cumulocity IoT can be found in their official documentation.

Requirements​

  • Working thin-edge.io installation

  • The Cloud Remote Access Feature is assigned to your Tenant. If not ask your Administrator to get it assigned to your Tenant. Please note that the Version must be at least 1007.2.0+

  • The Cloud Remote Access Role must be assigned to the user who wants to use that Feature: Administration → Role → <any Role> → check "Remote Access". Assign the role to the user used for the next steps.

  • A VNC or SSH server running on the device you wish to connect to.

Usage​

Make sure thin-edge.io is connected to Cumulocity.

You device within Cumulocity should look similar to this (the "Remote access" tab should be visible in the menu on the left):

Cumulocity remote access device management

You can configure now within the Remote access tab to which e.g. VNC or SSH server you want to jump to. Please keep in mind that the Host is from the thin-edge.io point of view.

Cumulocity remote access endpoint

If you click on connect after the proper configuration an websocket window opens and thin-edge.io triggers the c8y-remote-access-connect plugin to reach that websocket.

Cumulocity remote access websocket